الخميس 10 سبتمبر 2026
لتحسين تجربة المطوّرين في ما يتعلّق بالإعداد والاستخدام، أنشأنا صفحة رئيسية جديدة لـ Google Ads API في Google Cloud Console. أصبحت طلبات الحصول على إذن الوصول الأساسي مبرمَجة الآن للمطوّرين الذين أكملوا عملية التحقّق من العلامة التجارية. يتناول منشور المدوّنة هذا عدة تغييرات ذات صلة سيبدأ تطبيقها اليوم. على المطوّرين مراجعة قسم يجب اتخاذ إجراء في هذا المنشور لضمان سلاسة عملية الانتقال.
تغييرات في إدارة إمكانية الوصول إلى واجهة برمجة التطبيقات
نحن بصدد تعديل طريقة الاشتراك في إذن الوصول إلى Google Ads API وإدارته.
تجربة إعداد جديدة في Google Ads API: يمكنك الآن الاشتراك للوصول إلى Google Ads API مباشرةً في Google Cloud Console بدون الحاجة إلى حساب إداري على "إعلانات Google". سنوقف نهائيًا جميع وظائف الاشتراك الجديد وإدارة إمكانية الوصول إلى واجهة برمجة التطبيقات في صفحة "مركز واجهة برمجة التطبيقات" في الحسابات الإدارية، وسننتقل إلى صفحة "نظرة عامة" في Google Ads API ضمن Google Cloud Console. سيظلّ بإمكانك الوصول إلى صفحة "مركز واجهة برمجة التطبيقات" للاطّلاع على تفاصيل المطوّر القديمة. ستتم إزالة هذه الصفحة نهائيًا في المستقبل.
ارتباط مستويات الوصول إلى واجهة برمجة التطبيقات بمشاريع Google Cloud: سنوقف الرموز المميّزة للمطوّرين نهائيًا. يتم تلقائيًا نقل مستوى الوصول الحالي والنشط للرمز المميّز للمطوّر إلى مشاريعك على Google Cloud استنادًا إلى نشاطك الأخير في واجهة برمجة التطبيقات. يمكنك مواصلة إرسال الرموز المميّزة للمطوّرين في رؤوس طلبات البيانات من واجهة برمجة التطبيقات، ولكن هذا الإجراء اختياري وتتجاهله خوادم واجهة برمجة التطبيقات. سيستمرّ الرمز البرمجي الحالي في العمل بدون أي تغييرات. يتم الآن تحديد مستويات الوصول إلى واجهة برمجة التطبيقات من خلال مشروع Google Cloud الذي استخدمته لإنشاء بيانات اعتماد OAuth. يُرجى الرجوع إلى صفحة الأسئلة الشائعة لمزيد من المعلومات حول هذا التغيير وتحديد أي مشاكل قد تواجهك وحلّها.
رمز خطأ جديد: سيظهر الخطأ CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION في الإصدار 25 من Google Ads API إذا حاولت استخدام مشروع على Google Cloud مع مستوى الوصول إلى الحساب التجريبي لإجراء طلبات إلى حساب إنتاج. أما في الإصدارات الأقدم، فسيظهر الخطأ ACTION_NOT_PERMITTED. إذا واجهت هذا الخطأ، انتقِل إلى صفحة "نظرة عامة" في Google Ads API لمشروعك على Google Cloud وقدِّم طلبًا للحصول على "إذن وصول المستكشف".
تغييرات على عملية مراجعة واجهة برمجة التطبيقات
يجب إكمال عملية التحقّق من العلامة التجارية للحصول على إذن بالوصول الأساسي والعادي: بالنسبة إلى طلبات الحصول على إذن بالوصول الأساسي والعادي الجديدة، يجب إكمال عملية التحقّق من العلامة التجارية لمشروعك على Google Cloud . لا يُطلب من المستخدمين الحاليين الذين لديهم إذن وصول إكمال عملية التحقّق من العلامة التجارية، ولكن ننصحهم بذلك.
الموافقة التلقائية على طلبات الحصول على إذن الوصول الأساسي: أصبحت طلبات الحصول على إذن الوصول الأساسي تتم تلقائيًا وستتم مراجعتها في غضون دقائق بعد إرسالها والتحقّق من العلامة التجارية.
رفض طلبات الحصول على إذن الوصول الأساسي المعلّقة لمرة واحدة: بسبب هذه التعديلات على العملية، سيتم إغلاق جميع طلبات الحصول على إذن الوصول الأساسي المعلّقة إلى واجهة برمجة التطبيقات كجزء من هذا الانتقال. سيتلقّى مقدّمو الطلبات المتأثرون رسالة إلكترونية تتضمّن التفاصيل، وعليهم إعادة تقديم طلب للحصول على إذن الوصول إلى واجهة برمجة التطبيقات من صفحة "نظرة عامة" في Google Ads API.
يجب اتخاذ إجراء
التحقّق من إمكانية الوصول إلى واجهة برمجة التطبيقات: تأكَّد من أنّ مستوى الوصول إلى واجهة برمجة التطبيقات في مشروعك يتطابق بشكل صحيح مع الرمز المميّز الحالي للمطوّر:
- ابحث عن مستوى الوصول للرمز المميّز للمطوّر في مركز واجهة برمجة التطبيقات ضمن حسابك الإداري على "إعلانات Google".
- تأكَّد من أنّ مشروعك على Google Cloud يتضمّن مستوى الوصول نفسه في صفحة "نظرة عامة" في Google Ads API.
- إذا لم تتطابق مستويات الوصول، يُرجى إعادة تقديم طلب للحصول على إذن الوصول إلى واجهة برمجة التطبيقات من صفحة "نظرة عامة" في Google Ads API أو التواصل مع فريق دعم Google Ads API إذا كنت بحاجة إلى المساعدة.
تعديل عنوان البريد الإلكتروني المخصّص للتواصل مع واجهة برمجة التطبيقات: يُرجى الانتقال إلى صفحة "إدارة الهوية وإمكانية الوصول" (IAM) لمشروعك على السحابة الإلكترونية. تأكَّد من أنّ قائمة المستخدمين في دورَي المالك والمحرِّر محدَّثة. سنبدأ بإرسال إشعارات إلزامية عن الخدمة إلى عناوين البريد الإلكتروني هذه لإعلامك بأي تغييرات مستقبلية في Google Ads API.
تغييرات الرمز البرمجي: ننصحك بتعديل الرمز البرمجي لتطبيقك من أجل إيقاف إرسال الرموز المميّزة للمطوّرين كجزء من طلبات البيانات من واجهة برمجة التطبيقات. لقد نشرنا إصدارات جديدة من مكتبات العملاء تتيح لك طلب البيانات من واجهة برمجة التطبيقات بدون ضبط رمز مميّز للمطوّر. سنبدأ برفض الرموز المميّزة للمطوّرين في طلبات البيانات من واجهة برمجة التطبيقات في رقم إصدار رئيسي مستقبلي من Google Ads API.
إعادة تقديم طلب للحصول على إذن الوصول إلى واجهة برمجة التطبيقات إذا كان ذلك منطبقًا: إذا تم إغلاق طلبك المعلّق للحصول على إذن الوصول الأساسي إلى واجهة برمجة التطبيقات كجزء من عملية النقل هذه، يُرجى إعادة تقديم طلب للحصول على إذن الوصول إلى واجهة برمجة التطبيقات من صفحة "نظرة عامة" في Google Ads API ضمن Google Cloud Console.
لقد نشرنا مستندات معدَّلة لمساعدتك في التعامل مع هذه التغييرات. إذا واجهتك مشاكل في الدعم الفني، يُرجى الرجوع إلى صفحة الأسئلة الشائعة أو التواصل مع فريق دعم Google Ads API. إذا كانت لديك أي أسئلة أو أردت مناقشة هذا المنشور، يُرجى التواصل معنا على خادم Discord الخاص بـ "منتدى Google للإعلانات والقياس".
- Anash P. "أومن"، فريق Google Ads API
التصنيفات: google-ads-api، release