مرور کردن نتایج

می‌توانید به‌جای بارگیری کل مجموعه نتایج به‌طور هم‌زمان، نتایج بازیابی‌شده با 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 خطا برمی‌گرداند و باید پُرسمان جدیدی را شروع کنید.

پُرسمان شما باید در درخواست‌های بعدی یکسان باقی بماند تا بتوانید از داده‌های ذخیره‌شده در حافظه نهان استفاده کنید. درخواست‌های صفحه‌بندی‌شده بعدی به‌عنوان عملیات اضافی برای سهمیه عملیات روزانه شما برای دسترسی کاوشگر و دسترسی پایه محسوب نمی‌شوند. اگر پُرسمان متفاوت باشد و همراه با همان کد صفحه ارسال شود، خطایی برگردانده می‌شود.