الرمز المميّز للمطوّر هو سلسلة أبجدية رقمية تتألف من 22 حرفًا، وكان يُستخدم لربط تطبيقك بـ Google Ads API. تم إيقاف الرموز المميّزة للمطوّرين نهائيًا في 9 سبتمبر 2026. يلخّص هذا الدليل التغييرات ويسرد الأسئلة الشائعة حول عملية نقل البيانات هذه لمساعدة المطوّرين الحاليين.
الانتقال إلى صفحة "نظرة عامة" في Google Ads API ضمن Cloud Console
ما الذي سيتغيّر؟
أجرينا عدة تغييرات على تجربة إعداد Google Ads API وإدارة إمكانية الوصول إلى واجهة برمجة التطبيقات كجزء من عملية الإيقاف النهائي للرمز المميز للمطوّر. يسلّط هذا القسم الضوء على التغييرات الرئيسية.
مستويات الوصول إلى واجهة برمجة التطبيقات مرتبطة بمشاريع Google Cloud
سنوقف الرموز المميّزة للمطوّرين نهائيًا في 9 سبتمبر 2026. تم تلقائيًا نقل مستوى الوصول الحالي والنشط للرمز المميّز للمطوّر إلى مشاريعك على Google Cloud استنادًا إلى نشاط واجهة برمجة التطبيقات في آخر 90 يومًا قبل الإيقاف النهائي. يمكنك مواصلة إرسال الرموز المميّزة للمطوّرين في رؤوس طلبات البيانات من واجهة برمجة التطبيقات، ولكن هذا الإجراء اختياري وتتجاهله خوادم واجهة برمجة التطبيقات. سيستمرّ الرمز البرمجي الحالي في العمل بدون أي تغييرات. يتم تحديد مستويات الوصول إلى واجهة برمجة التطبيقات من خلال مشروع على السحابة الإلكترونية من Google Cloud الذي استخدمته لإنشاء بيانات اعتماد OAuth.
- إذا كان تطبيقك يستخدم سير عمل مصادقة المستخدم، فهذا هو المشروع الذي يملك معرّف عميل OAuth وسرّه.
- إذا كنت تستخدم سير عمل حساب الخدمة، هذا هو المشروع الذي يملك حساب الخدمة.
تجربة اشتراك جديدة في Google Ads API
يمكنك الاشتراك للوصول إلى Google Ads API مباشرةً في Google Cloud Console بدون الحاجة إلى حساب إداري على "إعلانات Google". لا تشترِك للحصول على رمز مميّز للمطوّر من صفحة "مركز واجهة برمجة التطبيقات" ولا تحاول تقديم طلب للحصول على إذن الوصول إلى واجهة برمجة التطبيقات من صفحة "مركز واجهة برمجة التطبيقات" في حسابك الإداري على "إعلانات Google"، لأنّ هذه العمليات تم نقلها إلى Google Cloud Console ولن تتم معالجتها إذا بدأت من صفحة "مركز واجهة برمجة التطبيقات".
تجربة جديدة لإدارة إمكانية الوصول إلى واجهة برمجة التطبيقات
لقد أوقفنا نهائيًا جميع وظائف الاشتراك الجديد وإدارة إمكانية الوصول إلى واجهة برمجة التطبيقات، مثل تقديم طلب للوصول إلى واجهة برمجة التطبيقات وإدارة مستويات الوصول إلى واجهة برمجة التطبيقات في صفحة "مركز واجهة برمجة التطبيقات" في الحسابات الإدارية على "إعلانات Google". تتوفّر هذه الوظائف في صفحة "نظرة عامة" في Google Ads API ضمن Google Cloud Console بدلاً من ذلك.
سيظلّ بإمكانك الوصول إلى صفحة "مركز واجهة برمجة التطبيقات" للاطّلاع على تفاصيل المطوّر السابقة. سيتم إيقاف هذه الصفحة نهائيًا في المستقبل.
رموز خطأ جديدة
في الإصدار 25 والإصدارات الأحدث، تُظهر Google Ads API الخطأ
AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION
إذا حاولت استخدام مشروع على Google Cloud يتضمّن
إذن وصول تجريبي لإجراء طلبات إلى حساب إنتاج. أما في الإصدارات الأقدم (الإصدار 24 والإصدارات السابقة)، فيظهر الخطأ AuthorizationError.ACTION_NOT_PERMITTED. إذا واجهت هذا الخطأ، انتقِل إلى صفحة "نظرة عامة" في Google Ads API لمشروعك على Google Cloud وقدِّم طلبًا للحصول على إذن الوصول إلى "مستكشف واجهات برمجة التطبيقات".
يجب تأكيد معلومات العلامة التجارية للحصول على إذن بالوصول الأساسي والعادي
بالنسبة إلى طلبات الحصول على إذن بالوصول الأساسي والعادي الجديدة، عليك إكمال عملية التحقّق من العلامة التجارية لمشروعك على Google Cloud. لا يُطلب من أصحاب الأذونات الحاليين إكمال عملية تأكيد معلومات العلامة التجارية، ولكن ننصحهم بذلك.
تتم معالجة طلبات الوصول الأساسي تلقائيًا وستتم مراجعتها في غضون دقائق بعد إرسال الطلب والتحقّق من العلامة التجارية.
بسبب هذه التعديلات على العملية، سيتم إغلاق جميع طلبات الحصول على إذن الوصول الأساسي المعلّقة كجزء من عملية النقل هذه. يتلقّى مقدّمو الطلبات المتأثرون رسالة إلكترونية تتضمّن التفاصيل، وعليهم إعادة تقديم طلب للحصول على "إذن الوصول الأساسي" من صفحة "نظرة عامة" في Google Ads API.
عناوين البريد الإلكتروني لجهات الاتصال الجديدة في واجهة برمجة التطبيقات
في إطار استعدادنا لإيقاف صفحة "مركز واجهة برمجة التطبيقات"، سننتقل إلى استخدام قائمة المستخدمين المالكين والمحرّرين في مشروعك على Google Cloud كقناة وحيدة لإرسال الرسائل الإدارية والإلزامية المتعلّقة بالامتثال. لضمان انتقال سلس، سنواصل مؤقتًا إرسال الإشعارات الإلزامية عن الخدمة (MSA) إلى عنوان البريد الإلكتروني المُدرَج في "مركز واجهة برمجة التطبيقات". سنُطلعك على آخر الأخبار عند الانتهاء من عملية نقل قنوات التواصل.
الإجراءات التي يجب اتّخاذها إذا كنت مطوّرًا حاليًا
مراجعة مستويات الوصول إلى واجهة برمجة التطبيقات في مشروعك على Google Cloud: إذا كنت مطوّرًا حاليًا، ننصحك بمراجعة صفحة "نظرة عامة" في Google Ads API لمشاريعك على Google Cloud للتأكّد من أنّها تتضمّن مستوى الوصول إلى واجهة برمجة التطبيقات نفسه الذي يتضمّنه الرمز المميّز الحالي للمطوّر. اتّبِع التعليمات الواردة في هذا الدليل لمعالجة أي اختلافات قد تلاحظها.
مراجعة عنوان البريد الإلكتروني المخصّص للتواصل مع واجهة برمجة التطبيقات: يُرجى الانتقال إلى صفحة "إدارة الهوية وإمكانية الوصول" (IAM) لمشروعك على Google Cloud. تأكَّد من أنّه تم منح مطوّري "إعلانات Google" ومدراء الحسابات النشطين أدوار المالك أو المحرِّر المناسبة في مشروعك على Google Cloud. سنبدأ بإرسال إشعارات إلزامية عن الخدمة إلى عناوين البريد الإلكتروني هذه لإعلامك بأي تغييرات مستقبلية في Google Ads API. سنواصل إرسال اتفاقيات مستوى الخدمة إلى عنوان البريد الإلكتروني المخصّص للتواصل والمُدرج في مركز واجهة برمجة التطبيقات لفترة مؤقتة، وسنُعلمك عند تعديل هذه العملية.
إصلاح الرمز البرمجي لتطبيقك: ننصحك بتعديل تطبيقك لإيقاف إرسال رمز مميّز للمطوّر كجزء من طلبات البيانات من واجهة برمجة التطبيقات. لقد نشرنا إصدارات محدَّثة من مكتبات العملاء وخادم بروتوكول سياق النموذج (MCP) في "إعلانات Google" ومساعد المطوّر في Google Ads API تتيح لك طلب البيانات من واجهة برمجة التطبيقات بدون ضبط رمز مميّز للمطوّر. سنبدأ برفض الرموز المميّزة للمطوّرين في طلبات البيانات من واجهة برمجة التطبيقات في رقم إصدار رئيسي مستقبلي من Google Ads API. إذا كان تطبيقك يستخدم هذه المكتبات، يُرجى تحديث تبعيات التطبيق لاستخدام أحدث إصدار.
يُرجى التواصل مع فريق دعم Google Ads API إذا كنت بحاجة إلى مزيد من المساعدة أو كانت لديك أسئلة إضافية.
المشاكل المعروفة
يوثّق هذا القسم جميع المشاكل المعروفة المتعلّقة بإيقاف رموز المطوّرين.
لا يتم منح المستخدمين إذن الوصول الاستكشافي أو الأساسي حتى بعد إكمال عملية تأكيد العلامة التجارية
نحن على علم بمشكلة تؤدي إلى رفض طلبات بعض المستخدمين الذين لديهم مشاريع تم التحقّق من علامتها التجارية عند تقديم طلب للحصول على مستوى الوصول الأساسي. سيتلقّى المستخدمون رسالة رفض إلكترونية تفيد بأنّ "الوصول الأساسي يتطلّب ملفًا تجاريًا معتمدًا بنجاح لعلامة تجارية تستخدم OAuth. لم نتمكّن من الموافقة على طلبك لأنّك لم تُكمل عملية التحقّق من العلامة التجارية لمشروعك". وبالمثل، يتم أيضًا رفض بعض المستخدمين الذين يشتركون للحصول على إذن الوصول الاستكشافي من خلال رسالة رفض إلكترونية تفيد بأنّه "في الوقت الحالي، لا يمكننا منح إذن الوصول الاستكشافي إلى مشروعك على Google Cloud لأنّه لا يستوفي معايير الأهلية المطلوبة للوصول المباشر إلى حساب الإنتاج بموجب سياسات Google Ads API وبنود الخدمة".
السبب الأساسي
قد يكون مشروعك على Google Cloud ضمن برنامج الفترة التجريبية المجانية من Google Cloud أو قد يكون حساب الفوترة معلّقًا أو غير مفعّل.
كيفية التحقّق من المعلنين
تحقَّق من حالة فوترة Google Cloud. إذا ظهر مشروع الفوترة على أنّه "حساب فترة تجريبية مجانية" أو كان في حالة تعليق أو إيقاف، يعني ذلك أنّك متأثر بهذه المشكلة.
الحالة
لقد حدّدنا السبب الأساسي ونعمل على حلّ هذه المشكلة.
الحلّ البديل المؤقت
هناك عدة حلول بديلة لحلّ هذه المشكلة. حدِّد الخيار الأنسب لحالة الاستخدام.
ترقية مشروعك على Google Cloud إلى فئة مدفوعة
ترقية مشروعك على Google Cloud إلى فئة مدفوعة يُرجى الانتظار لبضع دقائق ثم محاولة تقديم طلب للحصول على مستوى الوصول الأساسي مرة أخرى.
إزالة الفوترة لمشروعك على Google Cloud
إذا لم تكن لديك خدمات أخرى قيد التشغيل في مشروعك على Google Cloud، يمكنك إزالة الفوترة لمشروعك على Google Cloud. يُرجى الانتظار بضع دقائق ثم محاولة تقديم طلب للحصول على إذن وصول أساسي مرة أخرى.
استخدام مشروع مختلف على Google Cloud
إذا كان لديك مشروع آخر على Google Cloud تم التحقّق من علامته التجارية، استخدِم هذا المشروع لتقديم طلب للحصول على مستوى الوصول الأساسي.
تتلقّى المشاريع التي تمت الموافقة حديثًا على مستويات الوصول "الأساسي" أو "المستكشف" فيها الخطأ AUTHORIZATION_ERROR
نحن على عِلم بمشكلة يواجهها بعض المستخدمين الذين رقّوا مستوى وصول مشروعهم على Google Cloud إلى مستوى الوصول "الأساسي" أو "المستكشف" الموافَق عليه بعد 9 سبتمبر 2026، حيث يتلقّون الخطأ AUTHORIZATION_ERROR عند إجراء طلبات بيانات من Google Ads API إلى الحسابات العلنية.
السبب الأساسي
لا تلتزم Google Ads API بترقيات مستوى الوصول إلى واجهة برمجة التطبيقات التي تم إكمالها من Google Cloud Console لبعض المشاريع.
كيفية التحقّق من المعلنين
تتأثر بهذه المشكلة في حال استيفاء جميع الشروط التالية:
- لديك رمز مميّز للمطوّر بمستوى وصول تجريبي.
- استخدام مشروعك على Google Cloud والرمز المميّز للمطوّر لإجراء طلبات بيانات من Google Ads API قبل 9 سبتمبر 2026
- إذا رقّيت مستوى الوصول إلى مشروعك على Google Cloud إلى Explorer أو Basic أو Standard بعد 9 سبتمبر 2026
- يتعذّر إكمال طلبات البيانات من واجهة برمجة التطبيقات إلى حساب إنتاج بسبب الخطأ
AUTHORIZATION_ERROR. طلبات البيانات من واجهة برمجة التطبيقات إلى الحسابات الاختبارية ناجحة.
الحالة
لقد توصّلنا إلى حلّ لهذه المشكلة ونعمل على طرحه على خوادمنا. بعد طرح الإصلاح، ستبدأ طلبات البيانات من واجهة برمجة التطبيقات في العمل مرة أخرى.
الحلّ البديل المؤقت
يمكنك استخدام مشروع جديد على Google Cloud لتقديم طلب للحصول على إذن وصول Explorer.
الأسئلة الشائعة
يقدّم القسم التالي إجابات عن الأسئلة الشائعة حول إيقاف الرمز المميّز للمطوّر نهائيًا ومستويات الوصول إلى واجهة برمجة التطبيقات.
ماذا يحدث لمستويات الوصول إلى واجهة برمجة التطبيقات؟
لا تزال مستويات الوصول إلى واجهة برمجة التطبيقات مفروضة في Google Ads API. ومع ذلك، يتم منح هذه الأذونات لمشروعك على Google Cloud Console بدلاً من الرمز المميّز للمطوّر. عند إجراء طلبات بيانات من واجهة برمجة التطبيقات، يتم تحديد مستويات الوصول إلى واجهة برمجة التطبيقات من خلال مشروع Google Cloud الذي استخدمته لإنشاء بيانات اعتماد OAuth.
- إذا كان تطبيقك يستخدم سير عمل مصادقة المستخدم، فهذا هو المشروع الذي يملك معرّف عميل OAuth وسرّه.
- إذا كنت تستخدم سير عمل حساب الخدمة، هذا هو المشروع الذي يملك حساب الخدمة.
كيف تم تحديد المشاريع لنقل مستويات الوصول إلى واجهة برمجة التطبيقات؟
إذا كان لديك رمز مطوّر معتمَد قبل 9 سبتمبر 2026، تم نقل مستويات الوصول الخاصة به إلى مشاريعك على Google Cloud على النحو التالي:
- لقد فحصنا سجلّات طلبات البيانات من واجهة برمجة التطبيقات خلال آخر 90 يومًا لتحديد المشاريع على السحابة الإلكترونية التي تم استخدامها لإجراء طلبات البيانات من واجهة برمجة التطبيقات باستخدام الرمز المميّز للمطوّر الذي تمت الموافقة عليه.
- لقد عيّنّا مستويات الوصول إلى واجهة برمجة التطبيقات الخاصة بالرمز المميّز للمطوّر لجميع مشاريع على السحابة الإلكترونية المحدّدة.
هل يمكنني إنشاء عدة مشاريع على السحابة الإلكترونية بمستويات وصول مختلفة بعد هذا التغيير؟
نعم، يمكنك إنشاء مشاريع متعدّدة على Google Cloud بمستويات وصول مختلفة إلى واجهة برمجة التطبيقات. على سبيل المثال، يمكنك إنشاء مشروع على Google Cloud بمستوى وصول أساسي ومشروع آخر على Google Cloud بمستوى وصول عادي.
مثال
على سبيل المثال، لنفترض أنّ لديك 4 رموز مميّزة للمطوّرين و6 مشاريع على السحابة الإلكترونية بالتفاصيل التالية:
- الرمز المميّز للمطوّر 1:
abcdefghijkl1234567890لديه إذن بالوصول العادي. تم استخدامها مع أرقام تعريف المشاريع:1234567890و5678912345و45678912345. - رمز المطوّر 2:
xyzabcdefghi6789012345لديه إذن وصول أساسي. وقد تم استخدامه مع أرقام تعريف المشاريع:1231235678. - الرمز المميّز للمطوّر 3: يملك "
asdfgflkjhjz7654321012" إذن وصول أساسي، ولكن لم يسبق استخدامه لإجراء طلب بيانات من واجهة برمجة التطبيقات. تمت الموافقة عليه خلال 90 يومًا قبل 9 سبتمبر 2026. - الرمز المميّز للمطوّر 4: كان لدى
qwertypoiuyu6543298790إذن بالوصول العادي، ولكن لم يتم استخدامه في آخر 90 يومًا. تم استخدام رقم تعريف المشروع9876564900مع رمز المطوّر هذا قبل أكثر من 90 يومًا. - المشروع على السحابة الإلكترونية: لم يسبق استخدام رقم تعريف المشروع على السحابة الإلكترونية:
7171234567مع أيّ من الرموز المميّزة للمطوّرين لطلب بيانات من واجهة برمجة التطبيقات.
سيتم نقل مستويات الوصول إلى واجهة برمجة التطبيقات من الرموز المميّزة للمطوّرين إلى مشاريع Google Cloud على النحو التالي:
| الرمز المميز للمطوِّر | رقم تعريف المشروع | مستوى الوصول | الشرح |
|---|---|---|---|
abcdefghijkl1234567890 |
1234567890 |
الإذن بالوصول العادي | يرتبط رمز المطوّر المميّز ورقم تعريف المشروع ببعضهما. |
abcdefghijkl1234567890 |
5678912345 |
الإذن بالوصول العادي | يرتبط رمز المطوّر المميّز ورقم تعريف المشروع ببعضهما. |
abcdefghijkl1234567890 |
45678912345 |
الإذن بالوصول العادي | يرتبط رمز المطوّر المميّز ورقم تعريف المشروع ببعضهما. |
xyzabcdefghi6789012345 |
1231235678 |
وصول أساسي | يرتبط رمز المطوّر المميّز ورقم تعريف المشروع ببعضهما. |
asdfgflkjhjz7654321012 |
-- |
-- |
لم يتم نقل إذن الوصول إلى واجهة برمجة التطبيقات الخاص برمز المطوّر المميّز إلى أي مشروع لأنّه لم يتم استخدامه مطلقًا لإجراء طلب بيانات من واجهة برمجة التطبيقات. |
qwertypoiuyu6543298790 |
9876564900 |
اختبار إمكانية الوصول | تم إبطال إذن وصول واجهة برمجة التطبيقات إلى الرمز المميّز للمطوّر بسبب عدم النشاط لمدة 90 يومًا. يتم ضبط مستوى الوصول إلى واجهة برمجة التطبيقات في المشروع تلقائيًا على "الوصول التجريبي". |
-- |
7171234567 |
اختبار إمكانية الوصول | هذا مشروع جديد لم يتم استخدامه مع أي رمز مميّز للمطوّر. يتم ضبط مستوى الوصول التلقائي إلى واجهة برمجة التطبيقات في المشروع على "الوصول التجريبي". |
لديّ أكثر من رمز مميّز واحد معتمَد للمطوّر. ما هو المشروع الذي تريد نقل مستويات الوصول إلى واجهة برمجة التطبيقات إليه؟
يتم نقل مستويات الوصول لكل رمز مميّز للمطوّر تمّت الموافقة عليه إلى مشاريع Google Cloud المرتبطة بهذا الرمز المميّز للمطوّر. يمكنك الاطّلاع على مثال.
أستخدم عدة مشاريع على Google Cloud. ما هو المشروع الذي تريد نقل مستويات الوصول إلى واجهة برمجة التطبيقات إليه؟
إذا استخدمت عدة مشاريع على Google Cloud مع الرمز المميّز للمطوّر الذي تمت الموافقة عليه في آخر 90 يومًا، ستحصل كل هذه المشاريع على مستويات الوصول إلى واجهة برمجة التطبيقات نفسها التي حصل عليها الرمز المميّز للمطوّر. يمكنك الاطّلاع على مثال.
تم تعيين مستويات الوصول إلى واجهة برمجة التطبيقات لمشروع لم أعُد أستخدمه. فكيف أُصلح هذه المشكلة؟
إذا تم منح إذن الوصول إلى Google Ads API لمشروع على Google Cloud لم تعُد تستخدمه، ليس عليك اتّخاذ أي إجراء إضافي. ستعمل Google على إبطال إذن الوصول إلى واجهة برمجة التطبيقات للمشروع غير المستخدَم بعد 90 يومًا من عدم النشاط.
لم يتم منح مستويات الوصول إلى واجهة برمجة التطبيقات لمشروعي على Google Cloud. فكيف أُصلح هذه المشكلة؟
لم يكتسب مشروعك على Google Cloud مستوى وصول الرمز المميّز للمطوّر، على الأرجح لأنّك لم تستخدم الرمز المميّز للمطوّر ومشروع Cloud مطلقًا لإجراء طلب بيانات من واجهة برمجة التطبيقات، أو لأنّ صلاحية وصول الرمز المميّز للمطوّر إلى واجهة برمجة التطبيقات انتهت بسبب عدم النشاط. لحلّ المشكلة، قدِّم طلبًا للحصول على مستوى الوصول إلى واجهة برمجة التطبيقات المناسب لهذا المشروع من صفحة "نظرة عامة" في Google Ads API. يمكنك الاطّلاع على مثال.
أين يمكنني الاطّلاع على مستويات الوصول إلى واجهة برمجة التطبيقات في مشروعي؟
يمكنك الاطّلاع على مستوى الوصول إلى واجهة برمجة التطبيقات لمشروعك على Google Cloud من خلال صفحة "نظرة عامة" في Google Ads API.
كيف يمكنني تقديم طلب للحصول على مستويات وصول أعلى إلى واجهة برمجة التطبيقات؟
يمكنك تقديم طلب للحصول على مستويات وصول أعلى إلى واجهة برمجة التطبيقات لمشروعك على Google Cloud من صفحة "نظرة عامة" في Google Ads API.
ماذا يحدث لطلب الوصول إلى واجهة برمجة التطبيقات المعلّق؟
سيتم إغلاق أي طلبات معلّقة للحصول على مستوى الوصول الأساسي تم إرسالها من "مركز واجهة برمجة التطبيقات" في حسابك الإداري على "إعلانات Google" قبل 9 سبتمبر 2026. عليك إعادة تقديم طلب للحصول على مستوى الوصول الأساسي من صفحة "نظرة عامة" في Google Ads API لمشروعك على Google Cloud. إذا تأثرت بهذا التغيير، ستصلك رسالة إلكترونية تتضمّن التعليمات اللازمة.
ستتم مراجعة أي طلبات معلّقة للحصول على إذن بالوصول العادي بدأتها من مركز واجهة برمجة التطبيقات في حسابك الإداري على "إعلانات Google" اعتبارًا من 9 سبتمبر 2026 كالمعتاد. في حال الموافقة، سيتم منح مشروع Google Cloud المرتبط برمز المطوّر الخاص بك إذن الوصول العادي.
هل يمكنني إعادة ربط الرمز المميّز للمطوّر الذي تمت الموافقة عليه بمشروع جديد على Google Cloud؟
قبل 9 سبتمبر 2026، كان فريق Google Ads API يتيح إعادة ربط رمز المطوّر بمشروع جديد على Google Cloud حسب كل حالة. لم يعُد هذا الإجراء متاحًا اعتبارًا من 9 سبتمبر 2026، لأنّنا أوقفنا الرموز المميّزة للمطوّرين نهائيًا. إذا كنت بحاجة إلى استخدام مشروع جديد على Google Cloud، عليك تقديم طلب للحصول على صلاحية الوصول المناسبة إلى واجهة برمجة التطبيقات من صفحة "نظرة عامة" في Google Ads API لمشروعك على Google Cloud.
لديّ رمز مطوّر معتمَد، ولكن لم أستخدمه مطلقًا. هل يمكنني استخدام هذا الرمز المميّز للمطوّر؟
لا، لا يمكنك استخدام رمز المطوّر هذا. هناك احتمالان:
قد يتم إبطال إذن وصولك إلى الرمز المميّز للمطوّر بسبب عدم النشاط: بموجب سياسات Google، يجوز لشركة Google إبطال الرمز المميّز لواجهة برمجة التطبيقات إذا لم يتم استخدامه لمدة 90 يومًا متتاليًا. إذا لم تستخدم الرمز المميّز للمطوّر منذ فترة، من المرجّح أنّه تم إبطال مستويات الوصول إليه بسبب عدم النشاط. في هذه الحالة، عليك إعادة تقديم طلب للحصول على إذن الوصول إلى واجهة برمجة التطبيقات لمشروعك على Google Cloud من صفحة "نظرة عامة" في Google Ads API. يمكنك الاطّلاع على مثال.
تمت الموافقة على الرمز المميّز للمطوّر خلال 90 يومًا قبل 9 سبتمبر 2026، ولكن لم يسبق لك استخدامه: بما أنّه لم يسبق لك استخدام الرمز المميّز للمطوّر الذي تمت الموافقة عليه مع مشروع على Google Cloud قبل 9 سبتمبر 2026، لم يتم نقل مستويات الوصول الخاصة به إلى مشروع على السحابة الإلكترونية. نتيجةً لذلك، لن يعود بإمكانك استخدام الرمز المميّز للمطوّر. سنعرض الخطأ
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTIONإذا حاولت إجراء طلب بيانات من واجهة برمجة التطبيقات إلى حساب إنتاج باستخدام هذا الرمز المميّز للمطوّر. لإصلاح الخطأ، قدِّم طلبًا للحصول على إذن الوصول المناسب إلى واجهة برمجة التطبيقات من صفحة "نظرة عامة" في Google Ads API لمشروعك على Google Cloud. يمكنك الاطّلاع على مثال.
في كلتا الحالتَين، يمكنك تقديم طلب للحصول على مستوى الوصول "المستكشف" ومستوى الوصول "الأساسي" للتطبيقات ومراجعتها مبرمَجةً، ولن تحتاج بعد الآن إلى العمل مع فريق الامتثال في Google لإكمال عملية المراجعة. إذا كنت بحاجة إلى إذن وصول عادي، يجب إجراء مراجعة يدوية. ومع ذلك، يمكنك مشاركة تفاصيل الرمز المميّز للمطوّر الذي تمت الموافقة عليه عند تقديم طلب للحصول على إذن بالوصول العادي، حتى يتمكّن فريق الامتثال من مراجعة طلبك الجديد للحصول على إذن بالوصول العادي وفقًا لذلك.
هل يمكنني إيقاف إرسال الرموز المميّزة للمطوّرين كجزء من طلبات البيانات من واجهة برمجة التطبيقات؟
نعم، يمكنك إيقاف إرسال الرموز المميّزة للمطوّرين كجزء من طلبات البيانات من واجهة برمجة التطبيقات. إذا كنت تستخدم مكتبة برامج، قد تحتاج إلى الترقية إلى أحدث إصدار منها. يُرجى مراجعة سجلّات التغييرات في المكتبة للتأكّد من أنّها تتيح طلب البيانات من واجهة برمجة التطبيقات بدون تحديد رمز مميّز للمطوّر.
كنت مشاركًا في برنامج Cloud التجريبي لمستوى الوصول المُدار. كيف يؤثر ذلك عليّ؟
تم إطلاق البرنامج التجريبي لمستوى الوصول المُدار من خلال Cloud ليتيح لمطوّري Google Cloud طلب بيانات من واجهة برمجة التطبيقات بدون إرسال رمز مميّز للمطوّر كجزء من طلب البيانات من واجهة برمجة التطبيقات. بعد أن أوقفنا رموز المطوّرين نهائيًا، سيتم إيقاف هذا البرنامج نهائيًا.
تم نقل مستويات الوصول الخاصة بالرمز المميّز النشط للمطوّر إلى مشروعك على Google Cloud، لذا من المفترض أن يستمر الرمز البرمجي الحالي في العمل بدون أي تغييرات. إذا كنت بحاجة إلى استخدام مشروع جديد على Google Cloud، عليك تقديم طلب للحصول على إذن الوصول إلى واجهة برمجة التطبيقات من صفحة "نظرة عامة" في Google Ads API لمشروعك على Google Cloud.
كان الرمز المميّز للمطوّر جزءًا من قائمة مسموح بها. كيف يؤثر ذلك عليّ؟
قد تُطلق Google برامج تجريبية تتيح لبعض المطوّرين الوصول إلى ميزات تجريبية. يتم أحيانًا توفير إمكانية الوصول إلى هذه الميزات من خلال إضافة الرمز المميّز للمطوّر إلى قائمة مسموح بها. إذا كنت من المشاركين في هذا البرنامج التجريبي، ليس عليك اتّخاذ أي إجراء.
لقد عدّلنا جميع البرامج التجريبية لاستخدام مشاريع Google Cloud بدلاً من الرموز المميزة للمطوّرين كآلية لإضافة المشاريع إلى القائمة المسموح بها، ونقلنا حالة القائمة المسموح بها للرمز المميز للمطوّر إلى مشاريع Google Cloud المرتبطة. من المفترض أن يستمر الرمز البرمجي الحالي في العمل بدون أي تغييرات. إذا استمرّت المشاكل، يُرجى التواصل مع مدير حسابك في Google الذي سجّلك في البرنامج التجريبي.
لديّ رمز مطوّر معتمَد، وأريد استخدامه مع مشروع جديد على Google Cloud. هل هذا مسموح به؟
لا، لا يمكنك استخدام مشروع جديد على Google Cloud مع الرمز المميّز للمطوّر الذي تمت الموافقة عليه. بما أنّك لم تستخدم الرمز المميز للمطوِّر الذي تمت الموافقة عليه مع مشروع Google Cloud الجديد قبل 9 سبتمبر 2026، لم يتم نقل مستويات الوصول الخاصة به إلى مشروع على السحابة الإلكترونية. سيظهر لك الخطأ
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION إذا حاولت
إجراء طلب بيانات من واجهة برمجة التطبيقات باستخدام هذا الرمز المميّز للمطوّر، لأنّ الرموز المميّزة للمطوّرين لم تعد
تُستخدَم لتحديد مستويات الوصول إلى واجهة برمجة التطبيقات. لإصلاح الخطأ، قدِّم طلبًا للحصول على إذن الوصول المناسب إلى واجهة برمجة التطبيقات من صفحة "نظرة عامة" في Google Ads API لمشروعك على Google Cloud. يمكنك الاطّلاع على مثال.
تم تسريب الرمز المميّز للمطوّر خارجيًا. هل أحتاج إلى إعادة ضبط الرمز المميّز للمطوّر؟
لا، ليس عليك إعادة ضبط الرمز المميّز للمطوّر في هذه الحالة. بما أنّنا نقلنا مستويات الوصول إلى واجهة برمجة التطبيقات الخاصة بالرمز المميّز للمطوّر إلى مشروعك على Google Cloud، لن يتمكّن أي مستخدم غير مصرَّح له من استخدام الرمز المميّز للمطوّر في مشروعه على Google Cloud.
ماذا سيحدث لـ API Center؟
تم إيقاف صفحة "مركز واجهة برمجة التطبيقات" الحالية ضمن الحساب الإداري على "إعلانات Google" نهائيًا، وستتم إزالتها في المستقبل القريب. إذا كان لديك رمز مميّز للمطوّر، سيظل بإمكانك تسجيل الدخول إلى حسابك الإداري على "إعلانات Google" والاطّلاع على التفاصيل. ومع ذلك، يتم توفيرها كمرجع لك فقط. لا تنفِّذ أي مهام متعلقة بمستويات الوصول إلى الرمز المميّز للمطوّر، مثل طلب مستويات وصول أعلى إلى واجهة برمجة التطبيقات من هذه الصفحة.
إذا كنت بحاجة إلى تقديم طلب للحصول على مستويات وصول أعلى إلى واجهة برمجة التطبيقات، عليك إجراء ذلك من صفحة "نظرة عامة" في Google Ads API لمشروعك على Google Cloud.
هل ما زلتُ بحاجة إلى حساب إداري على "إعلانات Google" لاستخدام Google Ads API؟
لم تعُد بحاجة إلى حساب إداري على "إعلانات Google" لاستخدام Google Ads API. تحتاج إلى حساب إداري فقط إذا كنت بحاجة إلى ربط حسابات متعددة وإدارتها باستخدام واجهة برمجة التطبيقات.
أنا مطوّر جديد. كيف يمكنني الاشتراك في Google Ads API؟
اتّبِع التعليمات الواردة في دليل البدء للاشتراك في Google Ads API. لا تشترِك للحصول على رمز مميّز للمطوّر من "مركز واجهة برمجة التطبيقات" في حسابك الإداري على "إعلانات Google"، لأنّه لن تتم معالجة هذه الطلبات. سيتم إيقاف "مركز واجهة برمجة التطبيقات" نهائيًا في المستقبل القريب.
ما هي أذونات "إدارة الهوية وإمكانية الوصول" المطلوبة لإدارة مستويات الوصول إلى واجهة برمجة التطبيقات؟
يجب أن يكون لديك أذونات إدارة الحصص لمشروعك على Google Cloud من أجل إدارة مستويات الوصول إلى Google Ads API. يتم تضمين الأذونات اللازمة تلقائيًا للأدوار التالية: المالك والمحرِّر ومشرف الحصة ومشرف استخدام الخدمة. لمزيد من المعلومات، يُرجى الاطّلاع على مستندات أذونات الحصص.
يمكنك الاطّلاع على صفحة "إدارة الهوية وإمكانية الوصول" لمشروعك على Google Cloud لمعرفة الأدوار التي تم منحها لك. تعاوَن مع مشرف مشروعك على Google Cloud لمنح أدوار "إدارة الهوية وإمكانية الوصول" اللازمة لمشروعك على Google Cloud.