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

GoogleAdsService.Search از صفحه بندی در اندازه صفحه ثابت 10000 ردیف پشتیبانی می کند. مجموعه نتایج پرس و جو به چندین پاسخ تقسیم می شود که هر کدام 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 کلمه کلیدی باشد، مجموعه نتایج شامل 10000 شیء GoogleAdsRow در اولین پاسخ همراه با next_page_token خواهد بود.

برای بازیابی 10000 ردیف بعدی، درخواست را دوباره ارسال کنید، اما page_token درخواست را به next_page_token پاسخ به‌روزرسانی کنید. توجه داشته باشید که next_page_token در پاسخی که حاوی آخرین دسته سطرها است پر نشده است.

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

API Google Ads به صورت داخلی کل مجموعه داده را ذخیره می کند، بنابراین درخواست های بعدی سریعتر از درخواست اولیه هستند.

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