الرمز المميّز للمطوّر هو سلسلة أبجدية رقمية بطول 22 حرفًا تتيح لتطبيقك الاتصال بخدمة Google Ads API. بعد أن تحدّد لك Google الرمز المميّز، يمكنك الاطّلاع عليه أو إنشاء رمز جديد في صفحة مركز واجهة برمجة التطبيقات في حسابك الإداري على "إعلانات Google".
يتم منح كل رمز مميّز للمطوّر مستوى وصول يتحكم في عدد طلبات البيانات من واجهة برمجة التطبيقات التي يمكنك إجراؤها يوميًا باستخدام الرمز المميّز، بالإضافة إلى البيئة التي يمكنك إجراء طلبات البيانات إليها.
لإجراء طلبات بيانات من واجهة برمجة التطبيقات في حسابك على قناة الإصدار العلني، يجب طلب إذن وصول أساسي أو إذن وصول عادي لرمز المطوِّر الخاص بك أثناء عملية طلب الرمز المميّز. بما أنّ مستويات الوصول هذه غير مطلوبة لإجراء مكالمات بشأن الحسابات الاختبارية، يمكنك المتابعة في التدريبات، ولكن ننصح بالاطّلاع على كيفية تقديم طلب للحصول على إذن بالوصول الأساسي بعد إكمال هذا الدليل.
هل تحتاج إلى رمز مميّز جديد للمطوّر؟
تعتمد الحاجة إلى الاشتراك في رمز مميّز جديد للمطوّر على بعض عوامل. وفي ما يلي بعض السيناريوهات الشائعة:
السيناريو |
الخطوات التالية |
| لم تستخدم شركتك Google Ads API من قبل وتريد تطوير تطبيقاتك الخاصة | اشترِك للحصول على رمز مميّز جديد للمطوّر. مزيد من المعلومات |
| تستخدم شركتك Google Ads API بشكل نشط أو استخدمتها في السابق | تمنح Google عادةً رمزًا مميّزًا للمطوّر لكل شركة، لذا إذا كانت شركتك تستخدم حاليًا Google Ads API، عليك إعادة استخدام رمز المطوّر الحالي. مزيد من المعلومات |
| تستخدم شركتك Google Ads API حاليًا، ولكنها تعمل أيضًا على تطوير منتج أو أداة جديدة. | إذا كنت متأكّدًا من أنّه لا يمكنك استخدام رمز المطوّر الحالي، يمكنك تقديم طلب للحصول على رمز جديد مع توضيح حالة الاستخدام في الطلب. بالنسبة إلى بقية هذا الدليل، يمكنك استخدام رمز المطوِّر الحالي. مزيد من المعلومات |
| إذا كانت شركتك تستخدم تطبيقًا تابعًا لجهة خارجية | لا تحتاج إلى رمز مميّز للمطوّر إلا إذا كنت تطوّر تطبيقك الخاص. إذا كنت تستخدِم تطبيقًا أو خدمة تابعَين لجهة خارجية، على مطوّر هذا التطبيق الحصول على رمز مميّز للمطوّر للتطبيق. إذا لم تكن متأكدًا من حالتك، تواصَل مع فريق الامتثال لواجهات برمجة التطبيقات. |
كيفية تقديم طلب للحصول على رمز مميّز للمطوّر
هناك خطوتان عند تقديم طلب للحصول على رمز مميّز للمطوّر.
الخطوة 1: اختيار حساب إداري على "إعلانات Google" أو إنشاؤه
إذا كان لديك حساب إداري على "إعلانات Google"، اختَره عند التقدّم بطلب للحصول على الرمز المميّز. إذا لم يكن هذا الحساب الإداري مرتبطًا بحساباتك الأخرى، ننصحك بوضعه في جذر التسلسل الهرمي لحساباتك لتسهيل عملية مراجعة الرمز المميّز وتبسيط إدارة الحساب لاحقًا.
إذا لم يكن لديك حساب مدير، يمكنك اتّباع تعليمات "مركز المساعدة" لإنشاء حساب.
الخطوة 2: تقديم طلب للوصول إلى Google Ads API
يُرجى العِلم أنّ عملية مراجعة رمز المطوّر قد تستغرق بعض الوقت. مزيد من المعلومات
سجِّل الدخول إلى حسابك الإداري. يمكنك التحقّق مما إذا كان حسابًا إداريًا.
في شريط البحث في أعلى الصفحة، أدخِل "مركز واجهة برمجة التطبيقات" واختَره من ميزة الإكمال التلقائي للبحث. لا يظهر خيار مركز واجهة برمجة التطبيقات إلّا ل الحسابات الإدارية على "إعلانات Google" وليس لحسابات العملاء أو الحسابات الاختبارية .
املأ نموذج "الوصول إلى واجهة برمجة التطبيقات" واقبل "الأحكام والشروط".
تأكَّد من صحة معلوماتك وعمل عنوان URL لموقع شركتك الإلكتروني. إذا لم يكن الموقع الإلكتروني منشورًا، قد لا تتمكّن Google من معالجة طلبك ورفضه.
تأكَّد من أنّ عنوان البريد الإلكتروني المخصّص للتواصل بشأن واجهة برمجة التطبيقات الذي تقدّمه يؤدي إلى صندوق بريد إلكتروني يتم تتبُّعه بانتظام. قد يتواصل معك فريق الامتثال لواجهات برمجة التطبيقات في Google على عنوان البريد الإلكتروني هذا أثناء عملية المراجعة للحصول على توضيحات. إذا تعذّر التواصل معك، قد لا تواصل Google معالجة طلبك.
يمكنك تعديل عنوان البريد الإلكتروني المخصّص للتواصل بشأن واجهة برمجة التطبيقات في مركز واجهة برمجة التطبيقات. يُرجى تعديل هذه المعلومات باستمرار، حتى بعد إكمال عملية تقديم الطلب، حتى تتمكّن Google من إرسال إعلانات الخدمة المهمة إليك.
بعد إكمال عملية تقديم الطلب، يظهر الرمز المميّز للمطوّر في مركز واجهة برمجة التطبيقات بالحالة في انتظار الموافقة. أصبح الرمز المميّز للمطوّر يمتلك الآن مستوى الوصول إلى الإصدار التجريبي ويمكنك بدء إجراء طلبات بيانات من واجهة برمجة التطبيقات في الحسابات التجريبية.
بعد الحصول على الرمز المميّز للمطوّر، دوِّن قيمته لأنّك ستحتاج إليها عند إجراء طلبك الأول لواجهة برمجة التطبيقات.
التأكّد من تسجيل الدخول إلى حساب إداري
يجب تسجيل الدخول إلى حسابك الإداري للوصول إلى الرمز المميّز للمطوّر، ويجب ألا يكون حسابًا إداريًا تجريبيًا.
للتحقّق مما إذا كنت مسجّلاً الدخول إلى الحساب الإداري، اتّبِع الخطوات التالية:
سجِّل الدخول إلى حسابك.
اختَر المشرف على يمين الصفحة. إذا ظهر لك إعدادات الحساب الإداري في أعلى يمين الصفحة، هذا يعني أنّك سجّلت الدخول إلى حسابك الإداري. إذا ظهرت لك إعدادات الحساب، يعني ذلك أنّك سجّلت الدخول إلى حساب عميل.
إذا ظهر حساب اختباري باللون الأحمر في أعلى يسار الصفحة، يعني ذلك أنّ حسابك هو إما حساب مدير اختباري أو حساب معلِن اختباري.
مكان العثور على الرمز المميّز للمطوّر
يمكنك العثور على الرمز المميّز للمطوّر، في حال توفّره، في صفحة مركز واجهة برمجة التطبيقات في حسابك الإداري على "إعلانات Google".
سجِّل الدخول إلى حسابك الإداري. يمكنكالتحقّق ممّا إذا كان حسابًا إداريًا.
في شريط البحث في أعلى الصفحة، اكتب "مركز واجهة برمجة التطبيقات" واختَره من ميزة الإكمال التلقائي للبحث. لا يظهر خيار مركز واجهة برمجة التطبيقات إلّا لحسابات "إعلانات Google" الإدارة وليس للحسابات الاختبارية للإدارة.
الرمز المميّز للمطوّر ومستوى وصوله هما أول قيمتين مدرَجتين ضمن الوصول إلى واجهة برمجة التطبيقات.