تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتيح GoogleAdsService.Search تقسيم النتائج إلى صفحات بحجم ثابت يبلغ 10,000 صف. يتم تقسيم مجموعة نتائج طلب البحث إلى ردود متعددة، يحتوي كل منها على 10,000 عنصر.
إذا كان حسابك يحتوي على 50,000 كلمة رئيسية، ستتضمّن مجموعة النتائج 10,000 عنصر GoogleAdsRow في الردّ الأول، بالإضافة إلى next_page_token.
لاسترداد الـ 10,000 صف التالية، أرسِل الطلب مرة أخرى، ولكن عدِّل page_token في الطلب إلى next_page_token في الرد.
يُرجى العِلم أنّه لا تتم تعبئة
next_page_token
في الاستجابة التي تحتوي على آخر مجموعة من الصفوف.
تتعامل مكتبات البرامج مع التقسيم إلى صفحات تلقائيًا. ما عليك سوى تكرار الصفوف في الرد. عند عرض جميع الصفوف في الصفحة الحالية، تسترد مكتبة العميل صفحة جديدة من الصفوف تلقائيًا نيابةً عنك إلى أن يتم استرداد مجموعة البيانات بأكملها. في حال استخدام REST بدلاً من gRPC، يجب تقديم طلب بشكل صريح لكل صفحة جديدة.
تخزّن واجهة برمجة التطبيقات Google Ads API مجموعة البيانات بأكملها مؤقتًا، لذا تكون الطلبات اللاحقة أسرع من الطلب الأوّلي.
يجب أن يظل طلب البحث كما هو تمامًا في الطلبات اللاحقة للاستفادة من البيانات المخزّنة مؤقتًا. لن تساهم الطلبات في حصتك،
خاصةً بالنسبة إلى مستوى الوصول الأساسي. إذا كان طلب البحث مختلفًا وتم إرساله مع الرمز المميّز للصفحة نفسه، سيتم عرض خطأ.
تاريخ التعديل الأخير: 2025-07-09 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-09 (حسب التوقيت العالمي المتفَّق عليه)"],[[["`GoogleAdsService.Search` returns data in fixed pages of 10,000 rows, requiring multiple requests to retrieve larger datasets."],["To retrieve subsequent pages, use the `next_page_token` from the previous response in your next request's `page_token` field."],["Client libraries automate paging, but when using REST, you must manually request each page."],["The Google Ads API caches the entire dataset, making subsequent requests with the same query faster and not counted towards quota."],["For custom pagination scenarios, it's recommended to retrieve and store results locally, implementing your own pagination logic."]]],[]]