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