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