أصبحت 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 طلب في الدقيقة لكل مشروع لكل مستخدم
‫3,000 طلب في الدقيقة لكل مشروع
‫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 ورسائله.

الطلبات التي تتضمّن صفحات

لا يتم احتساب الطلبات التي يتم تقسيمها إلى صفحات (مثل الطلبات التي تحتوي على قيمة صالحة لملف شخصي على Google) ضمن حصة العمليات اليومية للمستخدم.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 رسالة خطأ.