می‌توانید نتایج بازیابی‌شده با
GoogleAdsService.Search را به‌جای بارگیری کل مجموعه نتایج به‌طور هم‌زمان، صفحه به صفحه مرور کنید. برای دریافت نمای کلی گزارش‌دهی با Google Ads API، به
نمای کلی گزارش‌دهی مراجعه کنید.
Search صفحه‌های ثابتی با حداکثر ۱۰٬۰۰۰ ردیف برمی‌گرداند. تنظیم page_size در
SearchGoogleAdsRequest منسوخ شده است و خطای
RequestError.PAGE_SIZE_NOT_SUPPORTED را برمی‌گرداند.
نمونه پُرسمان و صفحه‌بندی
پُرسمان زیر را درنظر بگیرید:
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 پاسخ به‌روز کنید:
{
"query": "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",
"pageToken": "CN3q9...example_token..."
}
توجه داشته باشید که next_page_token در پاسخی که حاوی آخرین دسته ردیف‌ها است، پر نمی‌شود.
کتابخانه‌های مشتری ما صفحه‌بندی را به‌طور خودکار انجام می‌دهند. فقط باید ردیف‌های پاسخ را تکرار کنید. وقتی همه ردیف‌های صفحه فعلی برگردانده شد، کتابخانه مشتری به‌طور خودکار ازطرف شما صفحه جدیدی از ردیف‌ها را واکشی می‌کند تا کل مجموعه داده بازیابی شود. اگر به‌جای gRPC از REST استفاده می‌کنید، باید برای هر صفحه جدید صریحاً درخواست کنید.
ذخیره در حافظه پنهان و انقضای کد صفحه
Google Ads API مجموعه داده را به‌طور داخلی ذخیره می‌کند تا درخواست‌های بعدی صفحه سریع‌تر از درخواست اولیه باشد. توجه داشته باشید که مقادیر next_page_token زمان زندگی (TTL) محدودی دارند و اگر در مدت کوتاهی (حدود دو ساعت) استفاده نشوند، منقضی می‌شوند. اگر توکن صفحه منقضی شود، API خطا برمی‌گرداند و باید پُرسمان جدیدی را شروع کنید.
برای بهره‌مندی از داده‌های ذخیره‌شده در حافظه نهان، پُرسمان شما باید در درخواست‌های بعدی یکسان باقی بماند. درخواست‌های صفحه‌بندی‌شده بعدی به‌عنوان عملیات اضافی برای سهمیه عملیات روزانه شما برای دسترسی کاوشگر و دسترسی پایه محسوب نمی‌شوند. اگر پُرسمان متفاوت باشد و همراه با همان کد صفحه ارسال شود، خطایی برگردانده می‌شود.