الرمز المميز للمطوِّر هو سلسلة أبجدية رقمية تتألف من 22 حرفًا وتتيح لتطبيقك الربط بواجهة Google Ads API. يمكنك الحصول على رمز مميّز من خلال الاشتراك في
مركز واجهات برمجة التطبيقات في حسابك الإداري على "إعلانات Google". عند إجراء طلب إلى واجهة برمجة التطبيقات، عليك إرسال الرمز المميز للمطوِّر كجزء من الطلب من خلال ضبط عنوان developer-token http أو gRPC.
يتم تخصيص مستوى وصول لكل رمز مميز للمطوّر، ويتحكّم هذا المستوى في عدد طلبات البيانات من واجهة برمجة التطبيقات التي يمكنك إرسالها يوميًا باستخدام الرمز المميز، بالإضافة إلى البيئة التي يمكنك إرسال الطلبات إليها.
عند الاشتراك للحصول على رمز مميز للمطوّر، قد يتم منحك مستوى إذن الوصول إلى الإصدار التجريبي تلقائيًا. يتيح لك ذلك إجراء مكالمات مع حسابات نهائية، ولكن مع بعض القيود. في بعض الحالات التي يتعذّر فيها علينا مراجعة طلب رمز المطوّر تلقائيًا، قد نمنح رمز المطوّر مستوى إذن الوصول إلى حساب تجريبي بدلاً من ذلك. يتيح لك ذلك إجراء طلبات بيانات من واجهة برمجة التطبيقات مقابل حسابات الاختبار فقط. لإزالة القيود المفروضة على مستويات الوصول إلى حسابات المستكشفين والحسابات الاختبارية، عليك طلب مستوى الوصول الأساسي أو مستوى الوصول العادي للرمز المميز للمطوّر. بعد مراجعة طلب رمز المطوّر والموافقة عليه، سيتم منح رمز المطوّر مستوى الوصول المناسب.
هل تحتاج إلى رمز مطوّر جديد؟
يعتمد قرار الاشتراك في رمز مميّز جديد للمطوّرين على بعض العوامل. وفي ما يلي بعض السيناريوهات الشائعة:
السيناريو |
الخطوات التالية |
| لم يسبق لشركتك استخدام Google Ads API من قبل، وتريد تطوير تطبيقاتك الخاصة | اشترِك للحصول على رمز مميز جديد للمطوّر. مزيد من المعلومات |
| تستخدم شركتك Google Ads API بشكل نشط أو استخدمتها في السابق | تمنح Google عادةً رمزًا مميزًا واحدًا للمطوّر لكل شركة، لذا إذا كانت شركتك تستخدم Google Ads API حاليًا، عليك إعادة استخدام الرمز المميز الحالي للمطوّر. مزيد من المعلومات |
| تستخدم شركتك حاليًا Google Ads API، ولكنّها تعمل أيضًا على تطوير منتج أو أداة جديدة. | إذا كنت متأكدًا من أنّه لا يمكنك استخدام رمز المطوّر الحالي، يمكنك تقديم طلب للحصول على رمز جديد مع توضيح حالة الاستخدام في الطلب. بالنسبة إلى بقية هذا الدليل، يمكنك استخدام الرمز المميز الحالي الخاص بالمطوّر. مزيد من المعلومات |
| تستخدم شركتك تطبيقًا تابعًا لجهة خارجية | لا تحتاج إلى رمز مميز للمطوِّر إلا إذا كنت بصدد تطوير تطبيقك الخاص. أما إذا كنت تستخدم تطبيقًا أو خدمة تابعة لجهة خارجية، فيجب أن يحصل مطوِّر هذا التطبيق على رمز مميز للمطوِّر. إذا لم يكن الأمر واضحًا بالنسبة إليك، يمكنك التواصل مع فريق الالتزام بسياسات واجهة برمجة التطبيقات. |
مَن يمكنه تقديم طلب للحصول على رمز مميّز للمطوّر؟
يمكن للشركات والمطوّرين الأفراد تقديم طلب للحصول على رمز مميز للمطوّر. يلخّص الجدول التالي التفاصيل التي عليك تقديمها عند الاشتراك للحصول على رمز مطوّر.
| إذا كنت | بعد ذلك، قدِّم تفاصيل المطوِّر التالية: | ملاحظات إضافية |
|---|---|---|
| مطوّر يمثّل شركتك أو فريق منتج | اسم شركتك وعنوان URL الخاص بها | تمنح Google عادةً رمزًا مميّزًا واحدًا للمطوّرين لكل شركة، ولكنها توافق على رموز مميّزة منفصلة للمطوّرين للأدوات المنفصلة حسب كل حالة على حدة. |
| مطوِّر فردي لا يمثّل شركة | حدِّد اسم شركتك على النحو التالي: Individual. يمكنك تقديم عناوين URL بديلة، مثل عنوان URL لملفك الشخصي على GitHub أو LinkedIn، بدلاً من عنوان URL للشركة. |
يجب أن يكون لديك شكل من أشكال التواجد على الإنترنت، ويجب أن تقدّم إلى Google عنوان URL يساعدنا في تقييم ما تخطّط لفعله باستخدام Google Ads API. لا يتم قبول عناوين URL العامة، مثل test.com وexample.com. |
كيفية تقديم طلب للحصول على رمز مميّز للمطوِّر
هناك خطوتان عند تقديم طلب للحصول على رمز مميّز للمطوّر.
الخطوة 1: اختيار حساب إداري على "إعلانات Google" أو إنشاؤه
إذا كان لديك حساب إداري على "إعلانات Google"، اختَره عند تقديم طلب للحصول على الرمز المميز للمطوِّر. إذا لم يكن هذا الحساب الإداري مرتبطًا بحساباتك الأخرى، ننصحك بوضعه في جذر التسلسل الهرمي لحسابك لتسهيل عملية مراجعة الرمز المميز وتبسيط إدارة الحساب لاحقًا.
إذا لم يكن لديك حساب إداري، يمكنك اتّباع تعليمات مركز المساعدة لإنشاء حساب.
الخطوة 2: تقديم طلب للحصول على إذن الوصول إلى Google Ads API
يُرجى العِلم أنّ عملية مراجعة الرمز المميز للمطوّر قد تستغرق بعض الوقت. مزيد من المعلومات
انتقِل إلى https://ads.google.com/aw/apicenter في متصفّح الويب. سجِّل الدخول إلى حسابك الإداري على "إعلانات Google" إذا طُلب منك ذلك.
املأ نموذج الوصول إلى واجهة برمجة التطبيقات واقبل البنود والشروط.
تأكَّد من صحة معلوماتك ومن أنّ عنوان URL لموقع شركتك الإلكتروني يعمل بشكل سليم. إذا لم يكن الموقع الإلكتروني متاحًا، قد يتعذّر على Google معالجة طلبك ورفضه.
تأكَّد من أنّ عنوان البريد الإلكتروني الخاص بجهة الاتصال المعنيّة بواجهة برمجة التطبيقات الذي تقدّمه يؤدي إلى صندوق وارد يتم التحقّق منه بانتظام. قد يتواصل فريق الامتثال لواجهات برمجة التطبيقات في Google مع هذا العنوان الإلكتروني أثناء عملية المراجعة للحصول على توضيحات. إذا تعذّر التواصل معك، قد لا تواصل Google معالجة طلبك.
يمكنك تعديل عنوان البريد الإلكتروني الخاص بالتواصل بشأن واجهة برمجة التطبيقات في مركز واجهات برمجة التطبيقات. يُرجى إبقاء هذه المعلومات محدَّثة، حتى بعد انتهاء عملية تقديم الطلب، كي تتمكّن Google من إرسال إشعارات مهمة بشأن الخدمة إليك.
بعد إكمال عملية تقديم الطلب، سيظهر الرمز المميز للمطوِّر في "مركز واجهة برمجة التطبيقات" مع إحدى النتائج التالية:
- الرمز المميز للمطوِّر لديه مستوى الوصول إلى الإصدار التجريبي بحالة موافق عليه. هذا يعني أنّ Google تمكّنت من مراجعة طلب رمز المطوّر والموافقة عليه تلقائيًا لمستوى الوصول Explorer. يمكنك البدء في تقديم طلبات البيانات من واجهة برمجة التطبيقات إلى حسابك على الإصدار العلني أو حسابك التجريبي.
- يملك الرمز المميز للمطوِّر مستوى الوصول إلى الحسابات الاختبارية مع الحالة في انتظار الموافقة. هذا يعني أنّه تعذّر على Google مراجعة طلب الحصول على رمز مطوّر للمستوى "الوصول إلى Explorer" والموافقة عليه تلقائيًا. يمكنك البدء في إرسال طلبات البيانات من واجهة برمجة التطبيقات إلى حسابات الاختبار. بعد إكمال هذا الدليل، ننصحك بالاطّلاع على كيفية تقديم طلب للحصول على مستوى الوصول الأساسي.
التأكّد من تسجيل الدخول إلى حساب إداري على "إعلانات Google"
يجب تسجيل الدخول إلى حسابك الإداري على "إعلانات Google" للوصول إلى الرمز المميز للمطوِّر، ويجب ألا يكون حسابًا إداريًا تجريبيًا على "إعلانات Google".
للتحقّق مما إذا كنت مسجّلاً الدخول إلى الحساب الإداري على "إعلانات Google"، اتّبِع الخطوات التالية:
انتقِل إلى https://ads.google.com/aw/apicenter في متصفّح الويب.
إذا كنت مسجّلاً الدخول إلى حساب عميل، ستعرض الصفحة الرسالة تطبيق API Center متاح فقط للحسابات الإدارية..
إذا ظهرت عبارة حساب تجريبي باللون الأحمر في أعلى يسار الصفحة، يعني ذلك أنّ حسابك هو حساب مدير تجريبي أو حساب معلِن تجريبي.
مكان العثور على الرمز المميز للمطوّر
يمكنك العثور على الرمز المميز للمطوِّر، إذا كان متوفّرًا، في صفحة مركز واجهة برمجة التطبيقات ضمن حسابك الإداري على "إعلانات Google".
الوصول إلى "مركز واجهات برمجة التطبيقات"