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