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