تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
الرمز المميز للمطوِّر هو سلسلة أبجدية رقمية تتألف من 22 حرفًا وتتيح لتطبيقك الربط بواجهة Google Ads API. بعد أن تخصّص لك Google الرمز المميز، يمكنك الاطّلاع عليه أو إنشاء رمز جديد في صفحة مركز واجهة برمجة التطبيقات ضمن حسابك الإداري على "إعلانات Google".
يتم تحديد مستوى وصول لكل رمز مميز للمطوّر، ويتحكّم هذا المستوى في عدد طلبات البيانات من واجهة برمجة التطبيقات التي يمكنك إرسالها يوميًا باستخدام الرمز المميز، بالإضافة إلى البيئة التي يمكنك إرسال الطلبات إليها.
لإجراء طلبات بيانات من واجهة برمجة التطبيقات مقابل حسابك النشط، يجب طلب مستوى إذن الوصول الأساسي أو مستوى إذن الوصول العادي للرمز المميز للمطوِّر أثناء عملية تقديم طلب الحصول على الرمز المميز. بما أنّ مستويات الوصول هذه غير مطلوبة لإجراء مكالمات مع حسابات تجريبية، يمكنك المتابعة مع التمارين، ولكن ننصحك بالاطّلاع على كيفية تقديم طلب للحصول على مستوى الوصول الأساسي بعد إكمال هذا الدليل.
هل تحتاج إلى رمز مميّز جديد للمطوّر؟
يعتمد قرار الاشتراك في رمز مميّز جديد للمطوّرين على بعض العوامل. وفي ما يلي بعض السيناريوهات الشائعة:
السيناريو
الخطوات التالية
لم يسبق لشركتك استخدام Google Ads API وتريد تطوير تطبيقاتك الخاصة
تستخدم شركتك Google Ads API بشكل نشط أو استخدمتها في الماضي
تمنح Google عادةً رمزًا مميزًا واحدًا للمطوّر لكل شركة، لذا إذا كانت شركتك تستخدم Google Ads API، عليك إعادة استخدام الرمز المميز الحالي للمطوّر. مزيد من المعلومات
تستخدم شركتك حاليًا Google Ads API، ولكنّها تعمل أيضًا على تطوير منتج أو أداة جديدة.
إذا كنت متأكدًا من أنّه لا يمكنك استخدام رمز المطوّر الحالي، يمكنك تقديم طلب للحصول على رمز جديد مع توضيح حالة الاستخدام في الطلب. بالنسبة إلى بقية هذا الدليل، يمكنك استخدام الرمز المميز الحالي الخاص بالمطوّر. مزيد من المعلومات
تستخدم شركتك تطبيقًا تابعًا لجهة خارجية
لا تحتاج إلى رمز مميز للمطوِّر إلا إذا كنت بصدد تطوير تطبيقك الخاص. أما إذا كنت تستخدم تطبيقًا أو خدمة تابعة لجهة خارجية، فيجب أن يحصل مطوِّر هذا التطبيق على رمز مميز للمطوِّر. إذا لم يكن الأمر واضحًا بالنسبة إليك، يمكنك التواصل مع فريق الالتزام بسياسات واجهة برمجة التطبيقات.
كيفية تقديم طلب للحصول على رمز مميّز للمطوِّر
هناك خطوتان عند تقديم طلب للحصول على رمز مميّز للمطوّر.
الخطوة 1: اختيار حساب إداري على "إعلانات Google" أو إنشاؤه
إذا كان لديك حساب إداري على "إعلانات Google"، اختَره عند تقديم طلب للحصول على الرمز المميّز. إذا لم يكن هذا الحساب الإداري مرتبطًا بحساباتك الأخرى، ننصحك بوضعه في جذر التسلسل الهرمي لحسابك لتسهيل عملية مراجعة الرمز المميز وتبسيط إدارة الحساب لاحقًا.
املأ نموذج الوصول إلى واجهة برمجة التطبيقات واقبل الأحكام والشروط.
تأكَّد من صحة معلوماتك ومن أنّ عنوان URL الخاص بموقع شركتك الإلكتروني يعمل بشكل صحيح. إذا كان الموقع الإلكتروني غير متاح، قد لا تتمكّن Google من معالجة طلبك وسترفضه.
تأكَّد من أنّ عنوان البريد الإلكتروني الخاص بجهة الاتصال المعنيّة بواجهة برمجة التطبيقات الذي تقدّمه يؤدي إلى صندوق وارد يتم التحقّق منه بانتظام. قد يتواصل فريق الامتثال لواجهات برمجة التطبيقات في Google مع هذا العنوان الإلكتروني أثناء عملية المراجعة للحصول على توضيحات. إذا تعذّر التواصل معك، قد لا تتابع Google طلبك.
يمكنك تعديل عنوان البريد الإلكتروني الخاص بالتواصل بشأن واجهة برمجة التطبيقات في مركز واجهات برمجة التطبيقات. يُرجى إبقاء هذه المعلومات محدَّثة، حتى بعد انتهاء عملية تقديم الطلب، كي تتمكّن Google من إرسال إشعارات الخدمة المهمة إليك.
بعد إكمال عملية تقديم الطلب، سيظهر الرمز المميز للمطوِّر في مركز واجهة برمجة التطبيقات بحالة في انتظار الموافقة. أصبح الرمز المميز للمطوِّر يتضمّن مستوى الوصول إلى الحسابات الاختبارية، ويمكنك البدء في طلب بيانات من واجهة برمجة التطبيقات مقابل الحسابات الاختبارية.
بعد الحصول على الرمز المميز للمطوِّر، سجِّل قيمته لأنّك ستحتاج إليها عند إجراء أول طلب إلى واجهة برمجة التطبيقات.
التأكّد من تسجيل الدخول إلى حساب إداري
يجب تسجيل الدخول إلى حسابك الإداري للوصول إلى الرمز المميز للمطوِّر، ويجب ألا يكون حسابًا إداريًا تجريبيًا.
للتحقّق مما إذا كنت مسجّلاً الدخول إلى الحساب الإداري، اتّبِع الخطوات التالية:
تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eA developer token, a 22-character alphanumeric string, is required to connect your app to the Google Ads API and can be created or viewed in the API Center of your Google Ads manager account.\u003c/p\u003e\n"],["\u003cp\u003eDeveloper tokens have access levels that dictate daily API call limits and environments; Basic or Standard Access is needed for production accounts.\u003c/p\u003e\n"],["\u003cp\u003eYou likely need a new developer token if your company is new to the Google Ads API or developing a new product requiring separate access, while existing users should generally reuse their company's current token.\u003c/p\u003e\n"],["\u003cp\u003eApplying for a developer token involves selecting/creating a Google Ads manager account and completing the API Access form, which may involve a review period before granting access.\u003c/p\u003e\n"],["\u003cp\u003eAfter obtaining the developer token, locate it in the API Center of your Google Ads manager account and securely store it for use in API calls.\u003c/p\u003e\n"]]],[],null,["| **Key Point:** A developer token is a prerequisite to making your first API call. After you obtain the token, make sure to note its value for the next steps.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nThe **developer token** is a 22-character long alphanumeric string that lets\nyour app connect to the Google Ads API. After the token is assigned to you by Google,\nyou can view it or create a new one on the **API Center** page of your Google Ads\nmanager account.\n\nEach developer token is assigned an [access level](/google-ads/api/docs/access-levels#access_levels_2) which\ncontrols the number of API calls you can make per day with the token, as well\nas the environment to which you can make calls.\n\nTo make API calls against your production account, you must request\n**Basic Access** level or **Standard Access** level for your developer token\nduring the token application process. Since these access levels are not required\nto make calls against test accounts, you can proceed with the exercises, but\nyou're encouraged to check out [how to apply for Basic\nAccess level](/google-ads/api/docs/access-levels#applying_for_basic_access) after you've completed this guide.\n\nDo you need a new developer token?\n\nWhether you should sign up for a new developer token or not depends on a few\nfactors. Here are some common scenarios:\n\n|---------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Scenario | Next steps |\n| Your company has never used the Google Ads API before and you want to develop your own apps | Sign up for a new developer token. [Learn more](#apply-token) |\n| Your company is actively using or has used the Google Ads API in the past | Google usually grants one developer token per company, so if your company already uses the Google Ads API, then you should reuse your existing developer token. [Learn more](#find-token) |\n| Your company already uses the Google Ads API but is also developing a new product or tool | If you're certain that you cannot use your existing developer token, then you can apply for a new one explaining your use case in the application. For the rest of this guide, you can use your existing developer token. [Learn more](#apply-token) |\n| Your company uses a third-party app | You need a developer token only if you're developing your own app. If you use a third-party app or service, then the developer of that app needs to get a developer token for the app. If you're unclear about your case, [contact the API compliance team](//support.google.com/adspolicy/contact/contact_ads_api). |\n\nHow to apply for a developer token\n\nThere are two steps when applying for a developer token.\n\nStep 1: Select or create a Google Ads manager account\n\nIf you already have a Google Ads manager account, select it when applying for the\ntoken. If this manager account is not already linked to your other accounts, we\nrecommend putting it at the root of your account hierarchy to ease the token\nreview process and simplify account management later on.\n\nIf you don't have a manager account, you can follow the [Help Center\ninstructions](//support.google.com/google-ads/answer/7459399) to create one.\n| **Note:** You must use an email address that hasn't already been associated with a Google Ads account to create your manager account.\n\nStep 2: Apply for access to the Google Ads API\n\nNote that the developer token review process can take some time to complete.\n[Learn more](/google-ads/api/docs/productionize/access-levels).\n\n1. Navigate to\n [https://ads.google.com/aw/apicenter](//ads.google.com/aw/apicenter)\n in your web browser. Sign in to your Google Ads manager account if prompted.\n\n [Access API Center](//ads.google.com/aw/apicenter)\n2. Complete the API Access form and accept the Terms and Conditions.\n\n- Ensure that your information is correct and your company's website\n URL is functioning. If the website is not live, Google might not be able to\n process your application and reject it.\n\n- Ensure that the API contact email you provide leads to a regularly monitored\n inbox. Google's API compliance team might reach out to this email address\n during the review process for clarifications. If you can't be reached, Google\n might not continue with your application.\n\n You can edit your **API contact email** in the **API Center**. Keep this\n information up-to-date, even after the application process, so Google can send\n you important service announcements.\n\nAfter you've completed the application process, the developer token appears in\nyour API Center with a **Pending Approval** status. Your developer token now has\n**Test Account Access** level and you can start making API calls against [test\naccounts](/google-ads/api/docs/best-practices/test-accounts).\n\nAfter you've obtained your developer token, note its value as you will require\nit when making your first API call.\n\nVerify if you are signed into a manager account\n\nYou must sign in to your manager account to access your developer token, and it\ncannot be a test manager account.\n\nTo verify if you are signed in to the manager account, follow these steps:\n\n1. Navigate to\n [https://ads.google.com/aw/apicenter](//ads.google.com/aw/apicenter)\n in your web browser.\n\n2. If you are logged into a customer account, the page will display\n **The API Center is only available to manager accounts.**.\n\n3. If **Test account** appears in red in the upper right corner, your account is\n either\n [a test manager or a test advertiser](/google-ads/api/docs/best-practices/test-accounts).\n\nWhere to find your developer token\n\nYou can find the developer token, if it exists, in the **API Center** page of\nyour Google Ads manager account.\n\n[Access API Center](https://ads.google.com/aw/apicenter)"]]
