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

يمكنك تصفّح النتائج التي تم استردادها باستخدام GoogleAdsService.Search بدلاً من تنزيل مجموعة النتائج بأكملها في وقت واحد. للحصول على نظرة عامة حول إعداد التقارير باستخدام Google Ads API، اطّلِع على دليل إعداد التقارير.

يتم عرض النتائج في صفحات تحتوي على ما يصل إلى 10,000 صف. إذا لم يتم ضبط page_size في الطلب، سيتم ضبط القيمة التلقائية على 10,000. إذا تم ضبط page_size على قيمة أكبر من 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 مؤقتًا مجموعة البيانات بأكملها، لذا تكون الطلبات اللاحقة أسرع من الطلب الأوّلي.

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

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