تعديل على سياسة استخدام موارد Google Ads API

الأربعاء 1 مايو 2024

ما الذي سيتغيّر؟

نحن بصدد تعديل سياسة استخدام موارد Google Ads API لتقييد أنماط الطلبات GoogleAdsService.Search وGoogleAdsService.SearchStream التي تستهلك قدرًا هائلاً من موارد واجهة برمجة التطبيقات. إذا تم تقييد نمط طلب معيّن، ستستمر الخدمات والطرق وأنماط الطلبات الأخرى في العمل بدون أن تتأثر.

اعتبارًا من الأسبوع الذي يبدأ في 17 يونيو 2024، وبالنسبة إلى أنماط الطلبات المقيّدة فقط، ستتأثر الطلبات على النحو التالي:

  • في حال استخدام الإصدار 17 أو إصدار أقدم من واجهة برمجة التطبيقات، سيظهر لك الخطأ QuotaError.RESOURCE_EXHAUSTED.
  • إذا كنت تستخدم الإصدار 18 أو إصدارًا أحدث من واجهة برمجة التطبيقات، سيظهر لك الخطأ QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION أو QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION، حسب ما إذا كان الاستخدام المفرط للموارد لفترة قصيرة (بضع دقائق) أو لفترة طويلة.

لمساعدتك في تحديد تقاريرك المكلفة ومراقبتها، سنعرض أيضًا مقياسًا للتكلفة لكل تقرير. للاطّلاع على تكلفة التقارير الناجحة، راجِع الحقول التالية:

ما هي أسباب هذا التغيير؟

نحن نُجري هذا التغيير للحفاظ على موثوقية واجهة برمجة التطبيقات واستقرارها.

ما هو الإجراء الواجب اتّخاذه؟

قبل 17 يونيو 2024، يجب تعديل تطبيقاتك لتنفيذ ما يلي:

  • التعامل مع رموز الخطأ الجديدة عند إجراء طلبات GoogleAdsService::Search or GoogleAdsService::SearchStream
    • إذا كنت تستخدم الإصدار 17 أو إصدارًا أقدم من Google Ads API، عليك معالجة أخطاء QuotaError.RESOURCE_EXHAUSTED.
    • إذا كنت تستخدم الإصدار 18 أو إصدارًا أحدث من واجهة برمجة التطبيقات، عليك معالجة الخطأَين QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION وQuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION.
  • إذا تم تقييد نمط واحد أو أكثر من أنماط طلبات إعداد التقارير، عليك مراجعة نمط الطلب وإصلاحه. في ما يلي بعض الطرق لتحسين أداء طلبات البحث:
    • نفِّذ طلب البحث بوتيرة أقل.
    • استخدِم نمط طلب أو طريقة عرض أقل تكلفة.

لمزيد من المعلومات حول تحسين طلبات البحث، يُرجى الاطّلاع على إدارة كفاءة البيانات.

  • [اختياري] يمكنك دمج مقياس query_resource_consumption الجديد في أنظمة المراقبة لرصد طلبات البحث الجديدة العالية التكلفة والتعامل معها.

كيفية الحصول على مساعدة

إذا كانت لديك أي أسئلة حول هذا التغيير أو كنت بحاجة إلى المساعدة لتحسين أنماط طلبات معيّنة، يُرجى الاطّلاع على صفحة الدعم الخاصة بواجهة Google Ads API لمعرفة الخيارات المتاحة.

- ديفيد ستيفنز، مدير منتجات Google Ads API

التصنيفات: google-ads-api