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

คุณสามารถแบ่งหน้าดูผลลัพธ์ที่ดึงข้อมูลด้วย GoogleAdsService.Search แทนการดาวน์โหลดชุดผลลัพธ์ทั้งหมดพร้อมกัน หากต้องการดูภาพรวมของการรายงานด้วย Google Ads API โปรดดูคู่มือการรายงาน

ระบบจะแสดงผลลัพธ์เป็นหน้าๆ ละไม่เกิน 10,000 แถว หากไม่ได้ตั้งค่า page_size ในคำขอ ระบบจะใช้ค่าเริ่มต้นเป็น 10,000 หากตั้งค่า page_size เป็นค่าที่มากกว่า 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 และ ระดับการเข้าถึงแบบพื้นฐาน หากคำค้นหาแตกต่างกันและส่งพร้อมกับโทเค็นหน้าเดียวกัน ระบบจะแสดงข้อผิดพลาด