شما میتوانید به جای دانلود کل مجموعه نتایج به صورت یکجا، نتایج بازیابی شده با GoogleAdsService.Search را مرور کنید. برای مرور کلی گزارشدهی با Google Ads API، به راهنمای گزارشدهی مراجعه کنید.
نتایج در صفحاتی با حداکثر ۱۰۰۰۰ سطر برگردانده میشوند. اگر page_size در درخواست تنظیم نشده باشد، به طور پیشفرض روی ۱۰۰۰۰ تنظیم میشود. اگر page_size روی مقداری بزرگتر از ۱۰۰۰۰ تنظیم شده باشد، همچنان از ۱۰۰۰۰ استفاده میکند.
به عنوان مثال، کوئری زیر را در نظر بگیرید:
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 ، کمکی نمیکنند. اگر درخواست متفاوت باشد و همراه با همان نشانه صفحه ارسال شود، خطا برمیگردد.