با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
توکن توسعه دهنده یک رشته الفبایی 22 کاراکتری است که به برنامه شما امکان می دهد به API Google Ads متصل شود. پس از اینکه توکن توسط Google به شما اختصاص داده شد، می‌توانید آن را مشاهده کنید یا در صفحه API Center حساب مدیر Google Ads خود یک نشانه جدید ایجاد کنید.
به هر توکن توسعه‌دهنده سطح دسترسی اختصاص داده می‌شود که تعداد تماس‌های API را که می‌توانید در روز با توکن برقرار کنید و همچنین محیطی را که می‌توانید با آن تماس برقرار کنید، کنترل می‌کند.
برای برقراری تماس‌های API با حساب تولیدی خود، باید سطح دسترسی پایه یا سطح دسترسی استاندارد را برای توکن توسعه‌دهنده خود در طول فرآیند درخواست توکن درخواست کنید. از آنجایی که این سطوح دسترسی برای برقراری تماس با حساب‌های آزمایشی لازم نیست، می‌توانید تمرین‌ها را ادامه دهید، اما توصیه می‌شود پس از تکمیل این راهنما ، نحوه درخواست سطح دسترسی پایه را بررسی کنید.
آیا به یک توکن توسعه دهنده جدید نیاز دارید؟
اینکه آیا باید برای یک توکن توسعه دهنده جدید ثبت نام کنید یا نه به چند عامل بستگی دارد. در اینجا چند سناریو رایج وجود دارد:
سناریو
مراحل بعدی
شرکت شما قبلاً هرگز از Google Ads API استفاده نکرده است و شما می خواهید برنامه های خود را توسعه دهید
برای یک توکن توسعه دهنده جدید ثبت نام کنید. بیشتر بدانید
شرکت شما به طور فعال از Google Ads API در گذشته استفاده کرده یا از آن استفاده کرده است
Google معمولاً به هر شرکت یک توکن توسعه دهنده اعطا می کند، بنابراین اگر شرکت شما قبلاً از Google Ads API استفاده می کند، باید از توکن توسعه دهنده موجود خود دوباره استفاده کنید. بیشتر بدانید
شرکت شما قبلاً از Google Ads API استفاده می‌کند، اما در حال توسعه یک محصول یا ابزار جدید است
اگر مطمئن هستید که نمی‌توانید از توکن توسعه‌دهنده موجود خود استفاده کنید، می‌توانید برای توضیح مورد استفاده خود در برنامه برای یک توکن جدید درخواست دهید. برای بقیه این راهنما، می توانید از توکن توسعه دهنده موجود خود استفاده کنید. بیشتر بدانید
شرکت شما از یک برنامه شخص ثالث استفاده می کند
تنها در صورتی که در حال توسعه اپلیکیشن خود هستید، به توکن توسعه دهنده نیاز دارید. اگر از یک برنامه یا سرویس شخص ثالث استفاده می کنید، توسعه دهنده آن برنامه باید یک توکن توسعه دهنده برای برنامه دریافت کند. اگر در مورد پرونده خود نامشخص هستید، با تیم سازگاری API تماس بگیرید .
نحوه درخواست توکن توسعه دهنده
هنگام درخواست توکن توسعه دهنده دو مرحله وجود دارد.
مرحله 1: یک حساب مدیر Google Ads را انتخاب یا ایجاد کنید
اگر قبلاً یک حساب مدیر Google Ads دارید، هنگام درخواست توکن، آن را انتخاب کنید. اگر این حساب مدیر قبلاً به حساب‌های دیگر شما مرتبط نیست، توصیه می‌کنیم آن را در ریشه سلسله مراتب حساب خود قرار دهید تا روند بررسی نشانه‌ها آسان شود و بعداً مدیریت حساب را ساده کنید.
فرم دسترسی API را تکمیل کنید و شرایط و ضوابط را بپذیرید.
اطمینان حاصل کنید که اطلاعات شما صحیح است و URL وب سایت شرکت شما کار می کند. اگر وب سایت فعال نباشد، ممکن است Google نتواند درخواست شما را پردازش کند و آن را رد کند.
مطمئن شوید که ایمیل تماس API که ارائه می‌دهید به یک صندوق ورودی که به طور منظم نظارت می‌شود منتهی شود. تیم انطباق API Google ممکن است در طول فرآیند بررسی برای شفاف سازی با این آدرس ایمیل تماس بگیرد. اگر امکان دسترسی به شما وجود ندارد، ممکن است Google به برنامه شما ادامه ندهد.
می‌توانید ایمیل تماس API خود را در مرکز API ویرایش کنید. این اطلاعات را حتی پس از فرآیند درخواست به‌روز نگه دارید تا Google بتواند اعلان‌های خدمات مهم را برای شما ارسال کند.
پس از تکمیل فرآیند درخواست، توکن توسعه دهنده در مرکز API شما با وضعیت تأیید در انتظار ظاهر می شود. نشانه توسعه‌دهنده شما اکنون دارای سطح دسترسی به حساب آزمایشی است و می‌توانید تماس‌های API را علیه حساب‌های آزمایشی شروع کنید.
پس از اینکه توکن توسعه دهنده خود را دریافت کردید، به ارزش آن توجه کنید زیرا هنگام برقراری اولین تماس API خود به آن نیاز خواهید داشت.
بررسی کنید که آیا به یک حساب مدیر وارد شده اید یا خیر
برای دسترسی به رمز توسعه دهنده خود باید به حساب مدیر خود وارد شوید، و این نمی تواند یک حساب مدیر آزمایشی باشد.
برای تأیید اینکه آیا به حساب مدیر وارد شده اید، این مراحل را دنبال کنید:
تاریخ آخرین بهروزرسانی 2025-09-03 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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-09-03 بهوقت ساعت هماهنگ جهانی."],[[["\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,["# Obtain a developer token\n\n| **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----------------------------------\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----------------------------------\n\nThere are two steps when applying for a developer token.\n\n### Step 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\n### Step 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-----------------------------------------------\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----------------------------------\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)"]]
