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