Вашему проекту в Google Cloud присваивается уровень доступа и параметр «допустимое использование». Уровень доступа определяет, можете ли вы влиять на рабочие аккаунты, а также количество операций и запросов, которые вы можете выполнять ежедневно. Допустимое использование определяет конкретные функции API Google Ads, которые разрешены для использования проектом.
Уровни доступа
В таблице перечислены четыре различных уровня доступа к API. Если у вас еще нет доступа к API Google Ads, вы можете начать с включения API , чтобы получить тестовый уровень доступа для вашего проекта Google Cloud. Вы можете повысить уровень доступа, выполнив несколько дополнительных шагов в приложении.
| Уровень доступа | Доступен... | Суточный лимит операций : 1 | Как подать заявку | Сколько времени обычно занимает проверка отзывов? |
|---|---|---|---|---|
| Тест | Тестовые аккаунты | 15 000 операций в день | Подать заявку на доступ к тестированию | |
| Исследователь | Тестовые и производственные счета | 2880 операций в день по производственным счетам 15 000 операций в день для тестовых аккаунтов | Подайте заявку на доступ к Explorer. | |
| Базовый | Тестовые и производственные счета | 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 предоставлен стандартный уровень доступа, вы можете заполнить заявку на обновление разрешенного использования . Заполните заявку, если вы хотите обновить разрешенное использование или предоставить своим клиентам доступ к вашему инструменту.