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

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 จะแคชชุดข้อมูลทั้งหมดภายใน ดังนั้นคำขอที่ตามมาจึง เร็วกว่าคำขอเริ่มต้น

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