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