Вашему облачному проекту Google Cloud назначается уровень доступа и "допустимое использование". Уровень доступа определяет, можете ли вы управлять рабочими аккаунтами, и устанавливает ограничение на число операций и запросов в сутки. Разрешенное использование определяет, какие функции Google Ads API можно использовать в проекте.
Уровни доступа
В таблице ниже перечислены четыре уровня доступа к API. Если у вас ещё нет доступа к Google Ads API, начните с того, что включите API, чтобы получить тестовый уровень доступа для вашего облачного проекта Google Cloud. Чтобы повысить уровень доступа, выполните дополнительные действия в приложении.
| Уровень доступа | Аккаунты | Дневной лимит на операции 1 | Как подать заявку | Сколько времени обычно занимает проверка? |
|---|---|---|---|---|
| Тест | Тестовые аккаунты | 15 000 операций в день | Запросить доступ к тестированию | |
| Исследователь | Тестовые и рабочие | 2880 операций в день для рабочих аккаунтов 15 000 операций в день для тестовых аккаунтов |
Как подать заявку на доступ к Explorer | |
| Основные | Тестовые и рабочие | 15 000 операций в день для тестовых и рабочих аккаунтов. | Как подать заявку на базовый доступ | |
| Стандартный | Тестовые и рабочие | Неограниченное количество операций в день для тестовых и рабочих аккаунтов | Как запросить стандартный доступ | 10 рабочих дней |
1 "В день" – это скользящий 24-часовой период времени, в течение которого с помощью вашего облачного проекта Google Cloud были сделаны запросы к API. Если за последние 24 часа вы превысили лимит запросов для вашего уровня доступа, приложение получит сообщение об ошибке.
Проверьте доступ
После включения Google Ads API вашему облачному проекту Google Cloud будет предоставлен тестовый доступ. Это означает, что проект может отправлять запросы к Google Ads API только в тестовые аккаунты.
Как запросить доступ к тестовой версии
Включите Google Ads API в своем облачном проекте Google Cloud, чтобы автоматически получить тестовый доступ.
Уровень доступа Explorer
После того как вы зарегистрируетесь в Google Ads API, Google может предложить вам подать заявку на уровень доступа Explorer.
Уровень доступа Explorer позволяет вашему облачному проекту Google Cloud отправлять запросы к Google Ads API как для тестовых, так и для рабочих аккаунтов. Рабочие аккаунты – это аккаунты, в которых показываются реальные объявления Google. В тестовых аккаунтах объявления не показываются.
Уровень доступа Explorer позволяет вашему облачному проекту Google Cloud выполнять до 2880 операций в день в рабочих аккаунтах. Этого достаточно для большинства разработчиков, чтобы начать работу с API и создать базовую автоматизацию.
Уровень доступа "Исследователь" ограничивает доступ к следующим функциям: Если вам нужны эти функции, подайте заявку на базовый или стандартный уровень доступа.
| Ограниченная функциональность | Ограниченные сервисы и методы |
|---|---|
| Создание аккаунта | CustomerService.CreateCustomerClient |
| Управление доступом | CustomerUserAccessInvitationServiceCustomerUserAccessService |
| Планирование | KeywordPlanServiceKeywordPlanIdeaServiceKeywordPlanCampaignServiceKeywordPlanCampaignKeywordServiceKeywordPlanAdGroupServiceKeywordPlanAdGroupKeywordServiceAudienceInsightsServiceReachPlanService |
| Оплата и платежи в аккаунте | PaymentsAccountServiceBillingSetupServiceAccountBudgetProposalServiceInvoiceService |
Как подать заявку на получение уровня доступа "Исследователь"
- Перейдите на обзорную страницу Google Ads API в проекте Google Cloud.
- Убедитесь, что на странице указан уровень доступа Тестовый.
- Откройте раздел Повышение уровня доступа.
- Убедитесь, что в качестве следующего уровня доступа указан Исследователь.
- Нажмите кнопку Запросить доступ, чтобы подать заявку на уровень доступа "Исследователь".
После того как вы отправите заявку, Google может автоматически повысить уровень доступа к API вашего проекта до "Исследователь".
Базовый уровень доступа
Уровень доступа "Базовый" позволяет проекту Google Cloud отправлять запросы к Google Рекламе API как в тестовые, так и в рабочие аккаунты. Рабочие аккаунты – это аккаунты, в которых показываются реальные объявления Google. В тестовых аккаунтах объявления не показываются.
Базовый уровень доступа позволяет выполнять в проекте Google Cloud до 15 000 операций в день. Этого достаточно для большинства разработчиков.
Как подать заявку на базовый уровень доступа
- Перейдите на обзорную страницу Google Ads API в проекте Google Cloud.
- Убедитесь, что на странице указан текущий уровень доступа – Исследователь.
- Откройте раздел Повышение уровня доступа.
- Убедитесь, что в поле Следующий уровень доступа указано Базовый.
- Убедитесь, что нет предупреждений о том, что вы не завершили проверку бренда для проекта. Если да, то следуйте инструкциям, чтобы завершить проверку бренда, прежде чем продолжить.
- Нажмите кнопку Запросить доступ, чтобы запросить базовый уровень доступа.
Google может автоматически повысить уровень доступа к API для вашего проекта до базового после того, как вы отправите заявку.
Стандартный доступ
Стандартный уровень доступа позволяет вашему проекту Google Cloud выполнять неограниченное количество операций в день для всех сервисов. Для отдельных сервисов и функций могут действовать ограничения частоты запросов и другие ограничения, которые будут применяться, даже если у вашего проекта стандартный уровень доступа.
Стандартный доступ предоставляется только разработчикам, которым требуется неограниченное количество операций Google Ads API, например крупным компаниям или инструментам, обслуживающим множество пользователей.
Как подать заявку на стандартный доступ
- Перейдите на обзорную страницу Google Ads API в проекте Google Cloud.
- Убедитесь, что на странице указан ваш текущий уровень доступа – Базовый.
- Разверните раздел Повысить уровень доступа.
- Убедитесь, что в поле Следующий уровень доступа указано значение Стандартный.
- Нажмите кнопку Подать заявку, чтобы начать подачу заявки на стандартный уровень доступа.
Заявка на стандартный доступ предполагает подробную проверку приложения вручную. Будьте готовы ответить на вопросы о функциях инструмента и его целевой аудитории. Если вашим инструментом пользуются внешние пользователи, предоставьте доступ к демоверсии. Обратите внимание, что ваш инструмент должен соответствовать требованиям к минимальной функциональности.
В ходе проверки команда Google по соблюдению нормативных требований будет связываться с вами по электронной почте. Чтобы ускорить рассмотрение заявки на стандартный доступ, своевременно отвечайте на вопросы специалистов по соблюдению нормативных требований. Когда проверка будет завершена, Google отправит вам электронное письмо с ее результатами.
Квоты API и системные ограничения частоты запросов
Независимо от уровня доступа все операции API подчиняются системным ограничениям скорости, которые определяют, сколько операций можно выполнить за определенный период времени, например за час. Чтобы узнать больше о том, как устранять ошибки, связанные с ограничением частоты запросов, ознакомьтесь с типами ошибок.
Отдельные сервисы могут устанавливать дополнительные ограничения на использование и квоты по причинам, связанным с дизайном продукта, правилами в отношении продукта, производительностью API и задержками. Подробнее о квотах API…
Разрешения
Допустимое использование применяется только к проектам Google Cloud со стандартным уровнем доступа. Разрешенное использование определяется на основе того, как вы планируете использовать Google Ads API. Эти разрешения определяют, какие функции API может использовать ваш инструмент, как описано в таблице ниже.
| Разрешение | Описание |
|---|---|
| Создание объявлений и управление ими | Предоставлять доступ ко всем сервисам API для создания кампаний Google Рекламы, групп объявлений, объявлений и ключевых слов и управления ими. |
| Отчеты | Выполняйте только запросы GoogleAdsService.Search или GoogleAdsService.SearchStream или вызовы, доступные только для чтения. Подходит разработчикам, которые используют API исключительно для получения статистики. |
| Анализ ключевых слов и рекомендаций | Разрешите облачному проекту Google Cloud доступ к RecommendationService, KeywordPlanIdeaService и KeywordPlanService. Эти данные используются только инструментами, которым нужны рекомендации, чтобы упростить создание кампаний Google Рекламы и управление ими. |
Изменить допустимое использование
Если для вашего облачного проекта Google Cloud одобрен стандартный доступ, вы можете заполнить заявку на обновление допустимого использования. Заполните заявку, если вы хотите обновить допустимое использование или предоставить клиентам доступ к вашему инструменту.