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

GoogleAdsService.Search รองรับ การแบ่งหน้าในขนาดหน้าคงที่ 10,000 แถว ชุดผลลัพธ์ของการค้นหาถูกแยกออก เป็นหลายคำตอบ โดยแต่ละคำตอบมี 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 คำ ชุดผลลัพธ์จะมีคีย์เวิร์ด 10,000 คำ GoogleAdsRow ในคำตอบแรก รวมถึง next_page_token

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

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

Google Ads API จะแคชชุดข้อมูลทั้งหมดไว้ภายใน ดังนั้นคำขอที่ตามมาจะเป็น เร็วกว่าตัวเลือกแรก

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