الرمز المميز للمطوِّر هو سلسلة أبجدية رقمية طولها 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" وليس للحسابات الإدارية التجريبية.
الرمز المميز للمطوِّر ومستوى الوصول إليه هما القيمتان الأولتان ضمن الوصول إلى واجهة برمجة التطبيقات.
