التنقّل بين النتائج

ملاحظة: تمت إزالة الحقل page_size في الإصدار 19 من Google Ads API. يُرجى الاطّلاع على الإشعار. تكون القيمة التلقائية للحقل page_size هي 10,000. لا تحاول ضبط قيمة page_size، لأنّ ذلك سيؤدي إلى ظهور خطأ.

يتيح GoogleAdsService.Search الفهرسة في أحجام صفحات ثابتة تبلغ 10,000 صف. يتم تقسيم مجموعة نتائج طلب البحث إلى ردود متعددة، كلّ منها يتضمّن 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 كلمة رئيسية، ستتضمّن مجموعة النتائج 10,000 عنصر GoogleAdsRow في أول ردّ، بالإضافة إلى next_page_token.

لاسترداد الـ 10,000 صف التالي، أرسِل الطلب مرة أخرى، ولكن عدِّل page_token في الطلب إلى next_page_token في الردّ. يُرجى العِلم أنّه لا يتمّ تعبئة next_page_token في الاستجابة التي تحتوي على المجموعة الأخيرة من الصفوف.

تتعامل مكتبات برامجنا مع تقسيم الصفحات تلقائيًا. ما عليك سوى تكرار المرور على صفوف الاستجابة. عند عرض كل الصفوف في الصفحة الحالية، تُسترجع مكتبة العميل تلقائيًا صفحة جديدة من الصفوف بالنيابة عنك إلى أن يتم استرداد مجموعة البيانات بالكامل. في حال استخدام REST بدلاً من gRPC، يجب تقديم طلب صراحةً لكل صفحة جديدة.

تخزِّن Google Ads API مجموعة البيانات بالكامل مؤقتًا، لذا تكون الطلبات اللاحقة أسرع من الطلب الأوّلي.

يجب أن يظل طلب البحث كما هو تمامًا في الطلبات اللاحقة للاستفادة من البيانات المخزّنة مؤقتًا. ولن تساهم الطلبات في حصتك، لا سيما إذن الوصول الأساسي. إذا اختلفت QUERY وتم إرسالها مع الرمز المميّز للصفحة نفسه، يتم عرض خطأ.

نقطة رئيسية: إذا كنت بحاجة إلى تقسيم الصفحات يدويًا، مثل تقسيم صفحات الويب المخصّصة، ننصحك باسترداد النتائج وتخزينها محليًا، مثل قاعدة بيانات، وإنشاء منطق تقسيم الصفحات الخاص بك.