GoogleAdsService.Search
با تعیین page_size
در درخواست شما از صفحه بندی پشتیبانی می کند. این مجموعه نتایج پرس و جو را به چندین پاسخ تقسیم می کند، که هر یک شامل حداکثر page_size
تعداد اشیاء است. اگر page_size
مشخص نشده باشد، به طور خودکار روی حداکثر 10000 ردیف تنظیم می شود.
به عنوان مثال، برای پرس و جو زیر:
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
اگر حساب شما حاوی 50000 کلمه کلیدی باشد و page_size
روی 1,000
تنظیم شده باشد، مجموعه نتیجه شامل 1000 شی GoogleAdsRow
در اولین پاسخ همراه با next_page_token
خواهد بود.
برای بازیابی هزار ردیف بعدی، درخواست را دوباره با همان اندازه صفحه ارسال کنید، اما page_token
درخواست را به next_page_token
پاسخ بهروزرسانی کنید. مقدار page_size
در درخواستهای بعدی میتواند هر بار متفاوت باشد. توجه داشته باشید که next_page_token
در پاسخی که حاوی آخرین دسته سطرها است پر نشده است.
کتابخانه های مشتری ما به طور خودکار صفحه بندی را مدیریت می کنند. شما فقط باید از طریق ردیف های پاسخ تکرار کنید. وقتی همه ردیفهای صفحه فعلی برگردانده شدند، کتابخانه مشتری یک صفحه جدید از ردیفها را بهطور خودکار از طرف شما واکشی میکند تا زمانی که کل مجموعه داده بازیابی شود. در صورت استفاده از REST به جای gRPC، باید صریحاً برای هر صفحه جدید درخواست دهید.
Google Ads API به صورت داخلی کل مجموعه داده را ذخیره می کند، بنابراین درخواست های بعدی سریعتر از درخواست اولیه هستند. بسته به مورد استفاده خود، می توانید page_size
روی هر مقداری بین 1 تا 10000 تنظیم کنید. به طور کلی، برای عملکرد کلی سریعتر، page_size
بزرگتر برای رفت و برگشت کمتر استفاده کنید.
پرس و جو شما باید در درخواست های بعدی دقیقاً یکسان باقی بماند تا از داده های حافظه پنهان استفاده کنید. درخواست ها به سهمیه شما کمک نمی کنند، به ویژه برای دسترسی اولیه . اگر کوئری متفاوت باشد و همراه با همان توکن صفحه ارسال شود، یک خطا برگردانده می شود.