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

تفرض 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.