تفرض Search Ads 360 Reporting API قيودًا على عمليات واجهة برمجة التطبيقات لضمان تحقيق أفضل أداء للنظام لجميع المستخدمين.
التسعير
يشمل السعر العام لخدمة "إعلانات شبكة البحث 360" استخدام Search Ads 360 Reporting API. لا يتم فرض رسوم إضافية على استخدام واجهة برمجة التطبيقات.
حدود طلبات البحث
تنطبق الحدود التالية على عمليات طلبات البحث التي تتم من خلال طريقة البحث أو طريقة SearchStream.
- 3000 طلب في الدقيقة لكل مشروع ولكل مستخدم
- 3000 طلب في الدقيقة لكل مشروع
- 150000 طلب بحث في اليوم لكل مشروع
الحدود اليومية لعمليات واجهة برمجة التطبيقات
تستند الحدود اليومية لاستخدام واجهة برمجة التطبيقات إلى عدد عمليات واجهة برمجة التطبيقات التي يتم إجراؤها لكل مشروع على Google Cloud.
يتم احتساب طلب بحث واحد أو تقرير واحد كعملية واحدة، بغض النظر عن النتائج التي يتم بثّها من خلال SearchAds360Service.SearchStream أو الصفحات من مكالمة SearchAds360Service.Search.
مزيد من المعلومات
يقدم الجدول التالي بعض الأمثلة على المحاسبة:
| طلب بيانات من واجهة برمجة التطبيقات | يتم احتساب العمليات من الحد اليومي |
|---|---|
العملية: Search
العدد: 53 مجموعة إعلانية
الخدمة: |
1 |
العملية: SearchStream
العدد: 45 حملة
الخدمة: |
1 |
ويتم رفض الطلبات التي تنتهك هذه الحدود مع عرض الخطأ التالي:
RESOURCE_EXHAUSTED.
طلبات البحث
يتم احتساب طلب Search أو SearchStream كعملية واحدة مقابل حصة التشغيل اليومية للمستخدم. يتم احتساب طلب SearchStream واحد كعملية واحدة لواجهة برمجة التطبيقات بغض النظر عن عدد الدفعات.
قيود gRPC
تستخدم جميع مكتبات عملاء Search Ads 360 Reporting API عملية gRPC لإنشاء الطلبات والردود. يبلغ حجم الرسالة تلقائيًا في gRPC 4 ميغابايت.
ويجب ألا تتجاوز الردود هذا الحد الأقصى. على سبيل المثال، قد يؤدي طلب البحث الذي يتضمن الكثير من الحقول إلى إنشاء استجابة يتجاوز حجمها 4 ميغابايت. ولتجنُّب هذا الحدّ، يمكنك تقليل عدد الحقول المحدّدة أو تقليل حجم الصفحة أو استخدام ميزة الوصول المباشر.
ولن تؤدي الطلبات التي تنتهك هذا القيد إلى إنشاء
SearchAds360Error، بل ستنتج عنها
خطأ "429 Resource Exhausted" في "الملف التجاري على Google". راجِع قائمة رموز خطأ gRPC ورسائله.
الطلبات المقسّمة على صفحات
ولا يتم احتساب الطلبات المقسّمة على صفحات (مثل الطلبات التي تحتوي على next_page_token صالح) ضمن حصة التشغيل اليومية للمستخدم.
أمّا طلبات التقسيم على صفحات التي تحتوي على رمز مميّز للصفحة منتهي الصلاحية أو غير صالح، فستنشئ استثناءً وسيتم احتسابها ضمن حصة التشغيل اليومية.
تخضع الطلبات المقسّمة على صفحات، مثل طلبات البحث، إلى
قيد Page size cannot exceed 10,000 rows ويتم رفضها في حال انتهاكها
لهذا الحدّ، مع ظهور الخطأ التالي:
INVALID_PAGE_SIZE.
لمزيد من التفاصيل عن التقسيم على صفحات، راجِع التقسيم إلى صفحات ضمن النتائج.
الطلبات التي تعرض استثناءات واجهة برمجة التطبيقات
ستبقى الطلبات المرفوضة مع SearchAds360Failure تُحتسب ضمن
حصة التشغيل اليومية للمستخدم.
إنّ الطلبات التي يتعذّر إرسالها ولكنها لا تعرض SearchAds360Failure، مثل الطلبات الواردة من خطأ على مستوى الشبكة، لن يتم احتسابها ضمن حصة التشغيل اليومية للمستخدم لأنّ الطلبات لن تصل أبدًا إلى الخدمة. أحد الأمثلة على ذلك هو
فشل الاتصال بالشبكة.
الأنواع الأخرى من الحدود
قد يؤدي ظهور حقل متكرّر، مثل قائمة بالعمليات، إلى ظهور الخطأ REQUEST_SIZE_LIMIT_EXCEEDED إذا كان الطلب يتضمّن عددًا كبيرًا جدًا من العناصر.
يمكن أن ترجع رسالة الخطأ نفسها أيضًا إلى مشاكل أخرى.
عند إجراء طلب بحث عن لغة طلب البحث في "إعلانات شبكة البحث 360"، يكون الحدّ الأقصى لعدد العناصر
في الجملة IN هو 20,000. وإذا تجاوزت هذا الحدّ، سيتم
عرض خطأ FILTER_HAS_TOO_MANY_VALUES.