تفرض Search Ads 360 Reporting API حدودًا على عمليات واجهة برمجة التطبيقات لضمان تحقيق الأداء الأمثل للنظام لجميع المستخدمين.
التسعير
يكون استخدام Search Ads 360 Reporting API مضمّنًا في السعر الإجمالي لخدمة "إعلانات شبكة البحث 360". وليست هناك أي رسوم إضافية مقابل استخدام واجهة برمجة التطبيقات.
حدود طلبات البحث
تنطبق الحدود التالية على عمليات طلبات البحث التي يتم إجراؤها من خلال طريقتَي "البحث" أو 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 في gRPC. راجِع قائمة رموز الخطأ
ورسائل 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.