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

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 รายการ ชุดผลลัพธ์จะมีออบเจ็กต์ GoogleAdsRow 10,000 รายการในการตอบกลับครั้งแรก พร้อมกับ next_page_token

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

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

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

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

ก่อนหน้า
สตรีมมิง
ถัดไป
รายงานใน UI