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