تتيح أداة GoogleAdsService.Search
ترقيم الصفحات من خلال تحديد
page_size
في طلبك.
يؤدي ذلك إلى تقسيم مجموعة نتائج طلب البحث إلى عدة ردود، يحتوي كل منها على ما يصل إلى page_size
من العناصر. إذا لم يتم تحديد قيمة السمة page_size
، يتم ضبطها تلقائيًا على الحد الأقصى المسموح به وهو 10,000 صف.
كمثال، للاستعلام التالي:
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
إذا كان حسابك يحتوي على 50,000 كلمة رئيسية وتم ضبط
page_size
على 1,000
،
ستحتوي مجموعة النتائج على 1,000 GoogleAdsRow
عنصر في الاستجابة الأولى، بالإضافة إلى
next_page_token
.
لاسترداد الألف صف التالي، أرسِل الطلب مجددًا بالحجم نفسه
للصفحة، ولكن عدِّل قيمة page_token
للطلب إلى قيمة
next_page_token
الخاصة بالاستجابة. ويمكن أن تختلف
قيمة page_size
في
الطلبات اللاحقة في كل مرة. يُرجى العِلم أنّه لا تتم تعبئة
next_page_token
في الردّ الذي يحتوي على آخر دفعة من الصفوف.
تتعامل مكتبات العملاء مع ترقيم الصفحات تلقائيًا. ما عليك سوى التكرار التحسيني خلال صفوف الاستجابة. عند عرض جميع الصفوف في الصفحة الحالية، تجلب مكتبة البرامج صفحة جديدة من الصفوف تلقائيًا بالنيابة عنك إلى أن يتم استرداد مجموعة البيانات بالكامل. في حال استخدام REST بدلاً من gRPC، يجب تقديم طلب صريح لكل صفحة جديدة.
تخزّن Google Ads API مجموعة البيانات بالكامل داخليًا، وبالتالي تكون الطلبات اللاحقة أسرع من الطلب الأوّلي. استنادًا إلى حالة استخدامك، يمكنك ضبط السمة
page_size
على أي قيمة
بين 1 و10,000. وبشكل عام، للحصول على أداء إجمالي أسرع، استخدِم رمز page_size
أكبر حجمًا لتقليل عدد رحلات الذهاب والعودة.
يجب أن يظل طلب البحث كما هو تمامًا في الطلبات اللاحقة للاستفادة من البيانات المخزّنة مؤقتًا، إذ إنّ الطلبات لن تساهم في حصتك، خاصةً في ما يخص الوصول الأساسي. إذا اختلف الاستعلام وتم إرساله مع نفس الرمز المميز للصفحة، فسيتم عرض خطأ.