Each Google Ads API developer token is assigned an access level and "permissible use." The access level determines whether you can affect production accounts and the number of operations and requests that you can execute daily. Permissible use determines the specific Google Ads API features that the developer token is allowed to use.
سطوح دسترسی
There are four different developer token access levels listed in order in the table. If you don't already have Google Ads API access, you can start by signing up to obtain a developer token with Test Account Access level. You can increase the access level by completing some additional steps in the application.
| سطح دسترسی | امکان دسترسی ... | محدودیت کارکرد روزانه ۱ | چگونه درخواست دهیم | بررسیها معمولاً چقدر طول میکشد؟ |
|---|---|---|---|---|
| سطح دسترسی حساب آزمایشی | Test accounts | ۱۵۰۰۰ عملیات در روز | دستورالعملها | |
| سطح دسترسی اکسپلورر | حسابهای آزمایشی و تولیدی | 2,880 operations / day for production accounts 15,000 operations / day for test accounts | دستورالعملها | |
| سطح دسترسی پایه | Test and production accounts | 15,000 operations / day for both test and production accounts | دستورالعملها | ۵ روز کاری |
| سطح دسترسی استاندارد | Test and production accounts | عملیات نامحدود در روز برای حسابهای آزمایشی و عملیاتی | دستورالعملها | ۱۰ روز کاری |
1 "Per day" is based on a sliding 24 hour time period in which API requests were made with your developer token. Your application will receive an error if it exceeds the request limit for your access level within the last 24 hours.
سطح دسترسی حساب آزمایشی
پس از تکمیل ثبت نام اولیه برای API تبلیغات گوگل، یک توکن توسعهدهنده با سطح دسترسی حساب آزمایشی به شما داده میشود. این بدان معناست که توکن توسعهدهنده فقط میتواند درخواستهای API تبلیغات گوگل را برای حسابهای آزمایشی ارسال کند.
نحوه درخواست سطح دسترسی حساب آزمایشی
Complete the Google Ads API sign-up on the Google Ads web interface to automatically be granted the Test Account Access level.
سطح دسترسی اکسپلورر
After you've completed the initial sign-up for the Google Ads API, Google may automatically upgrade your developer token from Test Account Access level to the Explorer Access level in some cases. Explorer Access level allows the developer token to make Google Ads API requests against both test accounts and production accounts. Production accounts are any accounts that serve real, live Google ads—test accounts don't serve ads.
سطح دسترسی اکسپلورر به توکن توسعهدهنده اجازه میدهد تا روزانه تا ۲۸۸۰ عملیات را در حسابهای کاربری عملیاتی اجرا کند. این مقدار برای اکثر توسعهدهندگان جهت شروع کار با API و ساخت اتوماسیون اولیه کافی است.
سطح دسترسی اکسپلورر، دسترسی به ویژگیهای زیر را محدود میکند. اگر نیاز به استفاده از این ویژگیها دارید، باید برای سطح دسترسی پایه یا سطح دسترسی استاندارد درخواست دهید.
| Restricted Functionality | خدمات و روشهای محدود |
|---|---|
| ایجاد حساب کاربری | CustomerService.CreateCustomerClient |
| مدیریت کاربران | CustomerUserAccessInvitationServiceCustomerUserAccessService |
| برنامهریزی | KeywordPlanServiceKeywordPlanIdeaServiceKeywordPlanCampaignServiceKeywordPlanCampaignKeywordServiceKeywordPlanAdGroupServiceKeywordPlanAdGroupKeywordServiceAudienceInsightsServiceKeywordPlanIdeaServiceReachPlanService |
| صورتحساب و پرداخت حساب | PaymentsAccountServiceBillingSetupServiceAccountBudgetProposalServiceInvoiceService |
نحوه درخواست برای سطح دسترسی اکسپلورر
Complete the Google Ads API sign-up on the Google Ads web interface. In some cases, Google may automatically upgrade your developer token to the Explorer Access level once you complete the signup.
سطح دسترسی پایه
Basic Access level allows the developer token to make Google Ads API requests against both test accounts and production accounts. Production accounts are any accounts that serve real, live Google ads—test accounts don't serve ads.
سطح دسترسی پایه به توکن توسعهدهنده اجازه میدهد تا روزانه تا ۱۵۰۰۰ عملیات انجام دهد. این برای اکثر توسعهدهندگان کافی است.
نحوه درخواست برای سطح دسترسی پایه
اگر توکن توسعهدهندهای با سطح دسترسی حساب آزمایشی یا دسترسی اکسپلورر دارید، میتوانید برای سطح دسترسی پایه به شرح زیر درخواست دهید:
Navigate to the API Center in your web browser. Sign in to your Google Ads manager account if prompted.
تأیید کنید که سطح دسترسی شما یا Test Account است یا Explorer .
Ensure that the API Contact Email in the API center is up-to-date. You won't be able to complete the application process without a valid, regularly checked email address. Ensure you have linked all of your active Google Ads accounts to the Google Ads manager account with the API token.
روی فلش کشویی کنار سطح دسترسی کلیک کنید و روی پیوند «درخواست برای دسترسی پایه» کلیک کنید.
تکمیل فرآیند تأیید برند پروژههای گوگل کلود
Google Ads API uses the brand verification status of Google Cloud projects associated with a developer token while reviewing the applications for Basic Access level. You can complete the brand verification process in your Google Cloud project to expedite the review process of your basic access application. In some cases, Google may also ask you to complete brand verification in your Google Cloud projects as a prerequisite to processing your basic access application. Refer to the brand verification guide to learn more.
سطح دسترسی استاندارد
Standard Access level allows the developer token to execute an unlimited number of operations per day for most services. This includes but is not limited to GoogleAdsService Search and SearchStream . For more details on limits and exceptions to Standard Access level, see API quotas .
The Standard Access level are only granted to developers who require unlimited Google Ads API operations, such as large companies or tools that serve many users.
نحوه درخواست برای سطح دسترسی استاندارد
اگر توکن توسعهدهندهای با سطح دسترسی پایه دارید، میتوانید برای سطح دسترسی استاندارد به شرح زیر اقدام کنید:
Navigate to the API Center in your web browser. Sign in to your Google Ads manager account if prompted.
Verify that your Access level is Basic .
Ensure that the API Contact Email in the API center is up-to-date. You won't be able to complete the application process without a valid, regularly checked email address. Ensure you have linked all of your active Google Ads accounts to the Google Ads manager account with the API token.
روی فلش کشویی کنار سطح دسترسی کلیک کنید و روی پیوند «درخواست برای دسترسی استاندارد» کلیک کنید.
If your tool is used by external users, be prepared to provide demo sign-in access to your tool. Note that your tool must comply with the Required Minimum Functionality .
سهمیههای API و محدودیتهای نرخ سیستم
Regardless of the access level, all API operations are subject to system rate limits, which restricts how many operations you may perform in a period of time, that is the number of operations per hour. To learn more about how to handle rate limit errors, see error types .
Individual services may enforce additional limits and quota restrictions due to reasons such as product design limitations, product policy restrictions, API performance and latency considerations. See the documentation about API quotas to learn more about these restrictions.
استفاده مجاز
Permissible use only applies to developer tokens with Basic Access and Standard Access levels. Permissible use is allocated based on intended use of the Google Ads API. These permissions determine which features of the API a developer token can be used for, as elaborated in the following table:
| استفاده مجاز | توضیحات |
|---|---|
| ایجاد / مدیریت تبلیغات | Provide access to all services of the API for creating and managing Google Ads campaigns, ad groups, ads, and keywords. |
| گزارشدهی | Only make GoogleAdsService.Search or GoogleAdsService.SearchStream requests, or read-only calls. This is for developers who only use the API to request stats. |
| تحقیق در مورد کلمات کلیدی و توصیهها | Allow the developer token to access RecommendationService , KeywordPlanIdeaService , and KeywordPlanService . This is only used by tools requiring suggestions to help facilitate the creation and management of Google Ads campaigns. |
نحوه تغییر کاربری مجاز
If your developer token has been approved for either the Basic Access level or Standard Access level, you can fill out the application to update permissible use . Fill out the application if you would like to update your permissible use or grant your clients access to your tool.