التسعير والحدود القصوى لواجهة برمجة التطبيقات والحصص

تفرض Search Ads 360 Reporting API حدودًا على عمليات واجهة برمجة التطبيقات لضمان الأداء الأمثل للنظام لجميع المستخدمين.

الأسعار

إنّ استخدام Search Ads 360 Reporting API مضمّن في التسعير العام لخدمة "إعلانات شبكة البحث 360". ولا يتم تحصيل أي رسوم إضافية مقابل استخدام واجهة برمجة التطبيقات.

حدود طلبات البحث

تنطبق الحدود التالية على عمليات طلبات البحث التي يتم إجراؤها من خلال طريقتَي Search أو SearchStream.

• ‫3,000 طلب في الدقيقة لكل مشروع ولكل مستخدم
• ‫3,000 طلب في الدقيقة لكل مشروع
• ‫150,000 طلب في اليوم لكل مشروع

الحدود اليومية لعمليات واجهة برمجة التطبيقات

تستند الحدود اليومية لاستخدام واجهة برمجة التطبيقات إلى عدد عمليات واجهة برمجة التطبيقات التي يتم إجراؤها لكل مشروع على Google Cloud.

يتم احتساب طلب البحث أو التقرير الواحد كعملية واحدة، بغض النظر عمّا إذا كانت النتائج يتم بثّها من خلال SearchAds360Service.SearchStream أو يتم تقسيمها على صفحات من طلب SearchAds360Service.Search. مزيد من المعلومات.

يعرض الجدول التالي بعض الأمثلة على المحاسبة:

طلب بيانات من واجهة برمجة التطبيقات	العمليات المحتسبة ضمن الحد اليومي
العملية: Search العدد: 53 مجموعة إعلانية الخدمة: SearchAds360Service	1
العملية: SearchStream العدد: 45 حملة الخدمة: SearchAds360Service	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.