صفحه بندی از طریق نتایج

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 بزرگتر برای رفت و برگشت کمتر استفاده کنید.

پرس و جو شما باید در درخواست های بعدی دقیقاً یکسان باقی بماند تا از داده های حافظه پنهان استفاده کنید. درخواست ها به سهمیه شما کمک نمی کنند، به ویژه برای دسترسی اولیه . اگر کوئری متفاوت باشد و همراه با همان توکن صفحه ارسال شود، یک خطا برگردانده می شود.