أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن. يمكنك الانضمام إلى مجموعة Google searchads-api-announcements لتبقى على اطّلاع على التحسينات والإصدارات القادمة.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

الأسعار

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

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

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

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

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

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

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

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

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

طلب بيانات من واجهة برمجة التطبيقات	العمليات التي يتم احتسابها ضمن الحدّ اليومي
العملية: `Search` العدد: 53 مجموعة إعلانية الخدمة: `SearchAds360Service`	1
العملية: `SearchStream` العدد: 45 حملة الخدمة: `SearchAds360Service`	1

العملية: Search

العدد: 53 مجموعة إعلانية

الخدمة: SearchAds360Service

العملية: SearchStream

العدد: 45 حملة

الخدمة: SearchAds360Service

ويتم رفض الطلبات التي تنتهك هذه الحدود مع عرض رسالة الخطأ: 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.