الحصول على رمز مميز للمطوِّر

الرمز المميز للمطوِّر هو سلسلة أبجدية رقمية تتألف من 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

يُرجى العِلم أنّ عملية مراجعة رمز المطوّر المميز قد تستغرق بعض الوقت. مزيد من المعلومات

  1. انتقِل إلى https://ads.google.com/aw/apicenter في متصفّح الويب. سجِّل الدخول إلى حسابك الإداري على "إعلانات Google" إذا طُلب منك ذلك.

    الوصول إلى "مركز واجهات برمجة التطبيقات"

  2. املأ نموذج الوصول إلى واجهة برمجة التطبيقات واقبل الأحكام والشروط.

  • تأكَّد من صحة معلوماتك ومن أنّ عنوان URL الخاص بموقع شركتك الإلكتروني يعمل بشكل صحيح. إذا كان الموقع الإلكتروني غير متاح، قد لا تتمكّن Google من معالجة طلبك وسترفضه.

  • تأكَّد من أنّ عنوان البريد الإلكتروني الخاص بجهة الاتصال المعنيّة بواجهة برمجة التطبيقات الذي تقدّمه يؤدي إلى صندوق وارد يتم التحقّق منه بانتظام. قد يتواصل فريق الامتثال لواجهات برمجة التطبيقات في Google مع هذا العنوان الإلكتروني أثناء عملية المراجعة للحصول على توضيحات. إذا تعذّر التواصل معك، قد لا تتابع Google طلبك.

    يمكنك تعديل عنوان البريد الإلكتروني الخاص بالتواصل بشأن واجهة برمجة التطبيقات في مركز واجهات برمجة التطبيقات. يُرجى إبقاء هذه المعلومات محدَّثة، حتى بعد انتهاء عملية تقديم الطلب، كي تتمكّن Google من إرسال إشعارات الخدمة المهمة إليك.

بعد إكمال عملية تقديم الطلب، سيظهر الرمز المميز للمطوِّر في مركز واجهة برمجة التطبيقات بحالة في انتظار الموافقة. أصبح الرمز المميز للمطوِّر يتضمّن مستوى الوصول إلى الحسابات الاختبارية، ويمكنك البدء في طلب بيانات من واجهة برمجة التطبيقات مقابل الحسابات الاختبارية.

بعد الحصول على الرمز المميز للمطوِّر، سجِّل قيمته لأنّك ستحتاج إليها عند إجراء أول طلب إلى واجهة برمجة التطبيقات.

التأكّد من تسجيل الدخول إلى حساب إداري

يجب تسجيل الدخول إلى حسابك الإداري للوصول إلى الرمز المميز للمطوِّر، ويجب ألا يكون حسابًا إداريًا تجريبيًا.

للتحقّق مما إذا كنت مسجّلاً الدخول إلى الحساب الإداري، اتّبِع الخطوات التالية:

  1. انتقِل إلى https://ads.google.com/aw/apicenter في متصفّح الويب.

  2. إذا كنت مسجّلاً الدخول إلى حساب عميل، ستعرض الصفحة الرسالة تطبيق API Center متاح فقط للحسابات الإدارية..

  3. إذا ظهرت عبارة حساب تجريبي باللون الأحمر في أعلى يسار الصفحة، يعني ذلك أنّ حسابك هو إمّا حساب مدير تجريبي أو حساب معلِن تجريبي.

مكان العثور على الرمز المميز للمطوّر

يمكنك العثور على الرمز المميز للمطوِّر، إذا كان متوفّرًا، في صفحة مركز واجهة برمجة التطبيقات ضمن حسابك الإداري على "إعلانات Google".

الوصول إلى "مركز واجهات برمجة التطبيقات"