الرمز المميّز للمطوّر هو سلسلة أبجدية رقمية تتألف من 22 حرفًا، وكان يُستخدم لربط تطبيقك بـ Google Ads API. تم إيقاف الرموز المميّزة للمطوّرين نهائيًا في 9 سبتمبر 2026. يلخّص هذا الدليل التغييرات ويسرد الأسئلة الشائعة حول عملية نقل البيانات هذه لمساعدة المطوّرين الحاليين.
ما الذي سيتغيّر؟
لقد أجرينا عدة تغييرات على تجربة إعداد 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 وقدِّم طلبًا للحصول على إذن الوصول إلى Explorer.
يجب تأكيد معلومات العلامة التجارية للحصول على إذن بالوصول الأساسي والعادي
بالنسبة إلى طلبات الوصول الجديدة إلى المستوى "أساسي" والمستوى "عادي"، يجب إكمال عملية تأكيد العلامة التجارية لمشروعك على Google Cloud. لا يُطلب من المستخدمين الحاليين الذين لديهم إذن الوصول إكمال عملية تأكيد معلومات العلامة التجارية، ولكن يُنصح بذلك.
تتم معالجة طلبات الحصول على إذن الوصول الأساسي بشكل آلي، وستتم مراجعتها في غضون دقائق بعد إثبات ملكية العلامة التجارية وإرسال الطلب.
بسبب هذه التعديلات على العملية، سيتم إغلاق جميع طلبات الحصول على إذن الوصول الأساسي المعلّقة كجزء من عملية النقل هذه. يتلقّى مقدّمو الطلبات المتأثّرون رسالة إلكترونية تتضمّن التفاصيل، وعليهم إعادة تقديم طلب للحصول على "إذن الوصول الأساسي" من صفحة "نظرة عامة" في Google Ads API.
عناوين البريد الإلكتروني الجديدة لجهات الاتصال الخاصة بواجهة برمجة التطبيقات
أثناء استعدادنا لإيقاف صفحة "مركز واجهة برمجة التطبيقات"، سننتقل إلى استخدام قائمة المستخدمين المالكين والمحرّرين في مشروعك على Google Cloud كقناة وحيدة لتلقّي الرسائل الإدارية ورسائل الالتزام الإلزامي. لضمان انتقال سلس، سنواصل مؤقتًا إرسال الإشعارات الإلزامية عن الخدمة (MSA) إلى عنوان البريد الإلكتروني المُدرَج في "مركز واجهة برمجة التطبيقات". سنُطلعك على آخر الأخبار عند الانتهاء من عملية نقل قنوات التواصل.
ما يجب فعله إذا كنت مطوّرًا حاليًا
مراجعة مستويات الوصول إلى واجهة برمجة التطبيقات في مشروعك على Google Cloud: إذا كنت مطوّرًا حاليًا، ننصحك بمراجعة صفحة "نظرة عامة" في Google Ads API الخاصة بمشاريعك على Google Cloud للتأكّد من أنّها تتضمّن مستوى الوصول إلى واجهة برمجة التطبيقات نفسه الذي يتضمّنه الرمز المميّز الحالي للمطوّر. اتّبِع التعليمات الواردة في هذا الدليل لمعالجة أي اختلافات قد تلاحظها.
مراجعة عنوان البريد الإلكتروني المخصّص للتواصل مع واجهة برمجة التطبيقات: يُرجى الانتقال إلى صفحة "إدارة الهوية وإمكانية الوصول" (IAM) في مشروعك على Google Cloud. تأكَّد من أنّه تم منح مطوّري ومدراء حسابات "إعلانات Google" النشطين أدوار المالك أو المحرّر المناسبة في مشروعك على Google Cloud. سنبدأ بإرسال إشعارات إلزامية عن الخدمة إلى عناوين البريد الإلكتروني هذه لإعلامك بأي تغييرات مستقبلية في Google Ads API. سنواصل إرسال اتفاقيات مستوى الخدمة إلى عنوان البريد الإلكتروني المخصّص للتواصل والمُدرج في مركز واجهة برمجة التطبيقات لفترة مؤقتة، وسنُعلمك عند تعديل هذه العملية.
إصلاح رمز تطبيقك: ننصحك بتعديل تطبيقك لإيقاف إرسال رمز مميّز للمطوّرين كجزء من طلبات البيانات من واجهة برمجة التطبيقات. لقد نشرنا إصدارات محدَّثة من مكتبات العملاء وخادم "بروتوكول سياق النموذج" في "إعلانات Google" وأداة Google Ads API Developer Assistant التي تتيح لك طلب البيانات من واجهة برمجة التطبيقات بدون ضبط رمز مميّز للمطوّر. سنبدأ برفض الرموز المميّزة للمطوّرين في طلبات البيانات من واجهة برمجة التطبيقات في رقم إصدار رئيسي مستقبلي من 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 إلى مستوى "الوصول الأساسي" أو "الوصول الاستكشافي" الموافق عليهما بعد 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 يومًا لتحديد المشاريع على السحابة الإلكترونية التي تم استخدامها لإجراء طلبات البيانات من واجهة برمجة التطبيقات باستخدام الرمز المميّز للمطوّر الذي تمت الموافقة عليه.
- لقد عيّنّا مستويات الوصول إلى واجهة برمجة التطبيقات الخاصة بالرمز المميّز للمطوّرين إلى جميع مشاريع Cloud التي تم تحديدها.
هل يمكنني الحصول على مشاريع متعدّدة على السحابة الإلكترونية بمستويات وصول مختلفة بعد هذا التغيير؟
نعم، يمكنك الحصول على مشاريع متعدّدة على 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. يمكنك الاطّلاع على مثال.
في كلتا الحالتين، يمكنك تقديم طلب للحصول على إذن الوصول إلى مستوى Explorer ومستوى Basic، وستتم مراجعة الطلبات تلقائيًا، ولن تحتاج إلى التواصل مع فريق الالتزام بالسياسات في 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.