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