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

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 ขนาดใหญ่ขึ้นเพื่อการเดินทางไป-กลับที่น้อยลงเพื่อให้ประสิทธิภาพโดยรวมรวดเร็วขึ้น

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