การแบ่งหน้าผ่านผลลัพธ์

GoogleAdsService.Search รองรับการแบ่งหน้าโดยระบุ page_size ในคำขอ วิธีนี้จะแบ่งชุดผลลัพธ์ของการค้นหาออกเป็นหลายคำตอบ โดยแต่ละคำตอบจะมีออบเจ็กต์ไม่เกิน page_size จำนวน หากไม่ได้ระบุ page_size ระบบจะตั้งค่าขีดจำกัดเป็น 10,000 แถวโดยอัตโนมัติ

ตัวอย่างเช่น สำหรับการค้นหาต่อไปนี้

SELECT
  ad_group.id,
  ad_group_criterion.type,
  ad_group_criterion.criterion_id,
  ad_group_criterion.keyword.text,
  ad_group_criterion.keyword.match_type
FROM ad_group_criterion
WHERE ad_group_criterion.type = KEYWORD

หากบัญชีมีคีย์เวิร์ด 50,000 คำและตั้งค่า page_size เป็น 1,000 ชุดผลลัพธ์จะมีออบเจ็กต์ GoogleAdsRow 1,000 รายการในการตอบกลับครั้งแรก พร้อมด้วย next_page_token

หากต้องการเรียกข้อมูล 1,000 แถวถัดไป ให้ส่งคำขออีกครั้งโดยมีขนาดหน้าเท่าเดิม แต่อัปเดต page_token ของคำขอเป็น next_page_token ของการตอบกลับ ค่าของ page_size ในคำขอที่ตามมาอาจต่างกันในแต่ละครั้ง โปรดทราบว่าระบบจะไม่เติมค่า next_page_token ในคำตอบที่มีกลุ่มแถวสุดท้าย

ไลบรารีไคลเอ็นต์ของเราจะจัดการการแบ่งหน้าโดยอัตโนมัติ คุณต้องทำซ้ำเฉพาะ แถวของคำตอบนั้น เมื่อมีการส่งคืนแถวทั้งหมดในหน้าปัจจุบันแล้ว ไลบรารีของไคลเอ็นต์จะดึงข้อมูลหน้าใหม่ของแถวในนามของคุณโดยอัตโนมัติจนกว่าจะมีการดึงข้อมูลทั้งชุดข้อมูล หากใช้ REST แทน gRPC คุณต้องส่งคำขอสำหรับหน้าเว็บใหม่แต่ละหน้าอย่างชัดเจน

Google Ads API จะแคชชุดข้อมูลทั้งหมดเป็นการภายใน ดังนั้นคำขอที่ตามมาจึงรวดเร็วกว่าชุดแรก คุณตั้งค่า page_size เป็นค่าระหว่าง 1 ถึง 10,000 ได้โดยขึ้นอยู่กับกรณีการใช้งาน โดยทั่วไปแล้ว หากต้องการประสิทธิภาพโดยรวมให้เร็วขึ้น ให้ใช้ page_size ที่สูงขึ้นกับรอบการตอบสนองน้อยลง

การค้นหาของคุณจะต้องเหมือนกันทุกประการในคำขอที่ตามมา เพื่อให้คุณใช้ประโยชน์จากข้อมูลที่แคชไว้ คำขอต่างๆ จะไม่นำไปรวมในโควต้าของคุณ โดยเฉพาะสำหรับการเข้าถึงขั้นพื้นฐาน หากคำค้นหาแตกต่างกันและส่งไปพร้อมกับโทเค็นของหน้าเดียวกัน ระบบจะแสดงข้อผิดพลาด