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

يمكنك الانتقال بين صفحات النتائج التي يتم استردادها باستخدام 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 مجموعة البيانات بالكامل مؤقتًا داخليًا، لذا تكون الطلبات اللاحقة أسرع من الطلب الأولي.

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