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

GoogleAdsService.Search از صفحه‌بندی در اندازه‌های ثابت صفحات ۱۰۰۰۰ سطری پشتیبانی می‌کند. مجموعه نتایج پرس‌وجو به چندین پاسخ تقسیم می‌شود که هر کدام شامل ۱۰۰۰۰ شیء هستند.

به عنوان مثال، کوئری زیر را در نظر بگیرید:

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

اگر حساب کاربری شما شامل ۵۰،۰۰۰ کلمه کلیدی باشد، مجموعه نتایج شامل ۱۰،۰۰۰ شیء GoogleAdsRow در اولین پاسخ، به همراه یک next_page_token خواهد بود.

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

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

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

برای استفاده از داده‌های ذخیره‌شده، درخواست شما باید در درخواست‌های بعدی دقیقاً یکسان باقی بماند. این درخواست‌ها به سهمیه شما، به‌ویژه برای سطح دسترسی Explorer و سطح دسترسی Basic ، کمکی نمی‌کنند. اگر درخواست متفاوت باشد و همراه با همان نشانه صفحه ارسال شود، خطا برمی‌گردد.