Присоединяйтесь к нам в прямом эфире на Discord- сервере сообщества Google Advertising and Measurement и на YouTube 29 января в 10:00 утра по восточному времени! Мы обсудим новые функции, добавленные в версии 23 API Google Ads.

Эта страница переведена с помощью Cloud Translation API.

Уровни доступа и разрешенное использование

Каждому токену разработчика Google Ads API присваивается уровень доступа и «разрешенное использование». Уровень доступа определяет, можете ли вы влиять на рабочие аккаунты, а также количество операций и запросов, которые вы можете выполнять ежедневно. Разрешенное использование определяет конкретные функции Google Ads API, которые разрешено использовать токену разработчика.

Уровни доступа

В таблице перечислены четыре различных уровня доступа к токену разработчика. Если у вас еще нет доступа к API Google Ads, вы можете начать с регистрации , чтобы получить токен разработчика с уровнем доступа к тестовому аккаунту. Вы можете повысить уровень доступа, выполнив несколько дополнительных шагов в заявке.

Уровень доступа	Доступен...	Суточный лимит операций ^{: 1}	Как подать заявку	Сколько времени обычно занимает проверка отзывов?
Тестовый уровень доступа к учетной записи	Тестовые аккаунты	15 000 операций в день	Инструкции
Уровень доступа исследователя	Тестовые и производственные счета	2880 операций в день по производственным счетам 15 000 операций в день для тестовых аккаунтов	Инструкции
Базовый уровень доступа	Тестовые и производственные счета	15 000 операций в день как для тестовых, так и для производственных проектов.	Инструкции	2 рабочих дня
Стандартный уровень доступа	Тестовые и производственные счета	Неограниченное количество операций в день как для тестовых, так и для производственных аккаунтов.	Инструкции	10 рабочих дней

^1. «За день» — это сумма, рассчитываемая на основе скользящего 24-часового периода времени, в течение которого выполнялись запросы к API с использованием вашего токена разработчика. Ваше приложение получит ошибку, если превысит лимит запросов для вашего уровня доступа за последние 24 часа.

Тестовый уровень доступа к учетной записи

После завершения первоначальной регистрации в Google Ads API вам будет выдан токен разработчика с уровнем доступа к тестовому аккаунту. Это означает, что токен разработчика может отправлять запросы к Google Ads API только к тестовым аккаунтам.

Как подать заявку на получение уровня доступа к тестовому аккаунту

Завершите регистрацию в Google Ads API через веб-интерфейс Google Ads, чтобы автоматически получить доступ к тестовому аккаунту.

Уровень доступа исследователя

После завершения первоначальной регистрации в Google Ads API Google может в некоторых случаях автоматически повысить уровень доступа вашего токена разработчика с тестового до уровня доступа исследователя. Уровень доступа исследователя позволяет токену разработчика отправлять запросы к Google Ads API как к тестовым, так и к рабочим аккаунтам . Рабочие аккаунты — это любые аккаунты, в которых отображается реальная, работающая реклама Google; тестовые аккаунты рекламу не показывают.

Уровень доступа Explorer позволяет разработчику использовать токен для выполнения до 2880 операций в день с рабочими учетными записями. Этого достаточно для большинства разработчиков, чтобы начать работу с API и создавать базовую автоматизацию.

Уровень доступа «Исследователь» ограничивает доступ к следующим функциям. Если вам необходимо использовать эти функции, вам следует подать заявку на базовый или стандартный уровень доступа .

Ограниченная функциональность	Услуги и методы с ограниченным доступом
Создание учетной записи	`CustomerService.CreateCustomerClient`
Управление пользователями	`CustomerUserAccessInvitationService` `CustomerUserAccessService`
Планирование	`KeywordPlanService` `KeywordPlanIdeaService` `KeywordPlanCampaignService` `KeywordPlanCampaignKeywordService` `KeywordPlanAdGroupService` `KeywordPlanAdGroupKeywordService` `AudienceInsightsService` `KeywordPlanIdeaService` `ReachPlanService`
Выставление счетов и оплата	`PaymentsAccountService` `BillingSetupService` `AccountBudgetProposalService` `InvoiceService`

Как подать заявку на уровень доступа Explorer

Завершите регистрацию в Google Ads API через веб-интерфейс Google Ads. В некоторых случаях Google может автоматически повысить уровень доступа вашего токена разработчика до уровня Explorer Access после завершения регистрации.

Базовый уровень доступа

Базовый уровень доступа позволяет разработчику отправлять запросы к API Google Ads как к тестовым, так и к рабочим аккаунтам. Рабочие аккаунты — это любые аккаунты, в которых показывается реальная, работающая реклама Google; тестовые аккаунты рекламу не показывают.

Базовый уровень доступа позволяет разработчику выполнять до 15 000 операций в день. Этого достаточно для большинства разработчиков.

Как подать заявку на базовый уровень доступа

Если у вас есть токен разработчика с уровнем доступа к тестовой учетной записи и вы хотите подать заявку на доступ к рабочей учетной записи, заполните форму заявки на базовый уровень доступа . Убедитесь, что вы выполнили следующие шаги:

Убедитесь, что у вас уже есть токен разработчика с уровнем доступа «Тестовый аккаунт».
Убедитесь, что адрес электронной почты для связи с API в центре API актуален. Для доступа к центру API необходимо войти в свою учетную запись Google Ads Manager. Без действительного, регулярно проверяемого адреса электронной почты вы не сможете завершить процесс подачи заявки. Убедитесь, что все ваши активные учетные записи Google Ads связаны с учетной записью Google Ads Manager с помощью токена API.

Стандартный уровень доступа

Стандартный уровень доступа позволяет разработчику использовать токен для выполнения неограниченного количества операций в день для большинства сервисов. Это включает, помимо прочего, GoogleAdsService Search и SearchStream . Более подробную информацию об ограничениях и исключениях для стандартного уровня доступа см. в разделе «Квоты API» .

Стандартный уровень доступа предоставляется только разработчикам, которым требуется неограниченное количество операций с Google Ads API, например, крупным компаниям или инструментам, обслуживающим множество пользователей.

Как подать заявку на стандартный уровень доступа

Если у вас есть токен разработчика с базовым уровнем доступа и вы хотите подать заявку на неограниченное количество операций с Google Ads API, заполните форму заявки на стандартный уровень доступа .

Если ваш инструмент является сторонним, будьте готовы предоставить демонстрационный доступ для входа в систему. Обратите внимание, что ваш инструмент должен соответствовать минимальным требованиям к функциональности .

Квоты API и системные ограничения скорости

Независимо от уровня доступа, все операции API подлежат системным ограничениям скорости, которые ограничивают количество операций, которые вы можете выполнить за определенный период времени, то есть количество операций в час. Чтобы узнать больше о том, как обрабатывать ошибки, связанные с ограничением скорости, см. раздел «Типы ошибок» .

Отдельные сервисы могут устанавливать дополнительные ограничения и квоты по таким причинам, как ограничения, связанные с дизайном продукта, ограничения политики продукта, производительность API и задержки. Для получения дополнительной информации об этих ограничениях см. документацию по квотам API .

Допустимое использование

Разрешенное использование распространяется только на токены разработчиков с уровнями доступа «Базовый доступ» и «Стандартный доступ». Разрешенное использование определяется предполагаемым использованием API Google Ads. Эти разрешения определяют, для каких функций API может использоваться токен разработчика, как показано в следующей таблице:

Допустимое использование	Описание
Создание/управление рекламой	Предоставить доступ ко всем сервисам API для создания и управления рекламными кампаниями Google Ads, группами объявлений, объявлениями и ключевыми словами.
Отчетность	Выполняйте только запросы `GoogleAdsService.Search` или `GoogleAdsService.SearchStream` , или вызовы только для чтения. Это предназначено для разработчиков, которые используют API только для запроса статистики.
Исследование ключевых слов и рекомендаций.	Разрешите токену разработчика доступ к `RecommendationService` , `KeywordPlanIdeaService` и `KeywordPlanService` . Это используется только инструментами, которым требуются подсказки для упрощения создания и управления рекламными кампаниями Google Ads.

Как изменить допустимое использование

Если ваш токен разработчика одобрен для уровня базового или стандартного доступа, вы можете заполнить заявку на обновление разрешенного использования . Заполните заявку, если вы хотите обновить разрешенное использование или предоставить своим клиентам доступ к вашему инструменту.

Токен разработчика

Прейскурант