Уровни доступа, управляемые облаком

Примечание: Google принимает заявки на участие в этой программе. Зарегистрируйтесь .

Эта функция позволяет управлять уровнями доступа к вашему API через организацию Google Cloud , предоставляя вам следующие преимущества:

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

• Создавайте отдельные проекты Google API Console для разных приложений: любой проект, связанный с организацией Google Cloud, наследует уровень доступа к API этой организации. Это позволяет создавать несколько проектов Google API Console в рамках этой организации для таких целей, как детальное управление проектами, отдельные проекты для разных приложений и несколько проектов Google API Console для членов вашей команды.

• Более детальный мониторинг и управление квотами : вы можете отслеживать использование API отдельными проектами или ограничивать использование API .

Предварительные требования

• Утвержденный токен разработчика

  Для использования этой опции у вас уже должен быть утвержденный токен разработчика. Вы можете найти существующий токен разработчика в Центре API в своем аккаунте Google Ads Manager. Войдите в систему , затем перейдите в раздел Администрирование > Центр API. В Центре API перейдите в раздел Доступ к API > Токен разработчика.

• Организация Google Cloud

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

  Сценарий	Шаги
  Вы являетесь действующим клиентом Google Workspace или Google Cloud Identity.	Вероятно, у вас уже есть ресурс организации. Вы можете проверить это и создать его при необходимости.
  Вы не используете Google Workspace или Google Cloud Identity.	Зарегистрируйтесь для получения бесплатной версии Google Cloud Identity. Затем создайте ресурс вашей организации .
  Ни один из вышеперечисленных вариантов вам не подходит.	Опишите свою ситуацию при регистрации в пилотном проекте и запросите у Google создание для вас ресурса организации. Google будет владеть этим ресурсом организации и управлять им бесплатно.

• Подготовьте свои проекты в Google API Console для пилотной программы.

  Для участия в пилотной программе вам необходимо подготовить проекты Google API Console, используемые с Google Ads API, следующим образом:

  Сценарий	Шаги
  У вас уже есть организация Google Cloud или вы создали её на предыдущем шаге.	Убедитесь, что все проекты в Google API Console, в которых вы включили Google Ads API, находятся в этой организации. Если это не так, перенесите их в эту организацию . Если вы уже являетесь клиентом Google Workspace или Google Cloud Identity , скорее всего, проекты Google API Console уже находятся в вашей организации, поэтому вы можете пропустить этот шаг.
  У вас нет организации Google Cloud, и вы не смогли создать её на предыдущем шаге.	Убедитесь, что вы являетесь администратором как в своей учетной записи Google Ads API Manager, так и в проекте Google API Console. Эти права необходимы для выполнения дополнительных действий после одобрения пилотного приложения.

• Актуальный адрес электронной почты для связи по вопросам API.

  Убедитесь, что ваш адрес электронной почты для связи с Google Ads API актуален. Контактные данные API указаны на странице Центра API в вашем аккаунте Google Ads API Manager. Войдите в систему , затем перейдите в ИНСТРУМЕНТЫ И НАСТРОЙКИ > НАСТРОЙКА > Центр API .

Зарегистрируйтесь для участия в пилотной программе

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

Если вы запросили у Google создание организации в Google Cloud, потребуется выполнить несколько дополнительных шагов:

1. Google создаст для вас ресурс организации в облачной среде, принадлежащей Google. Всем администраторам вашей учетной записи Google Ads API Manager будет предоставлена ​​роль roles/resourcemanager.projectCreator в новой созданной организации.

2. Google отправит на указанный вами адрес электронной почты контактного лица API подробную информацию о новом ресурсе организации.

3. Для переноса проекта Google API Console в новую организацию необходимо войти в свою учетную запись Google API Console и следовать инструкциям.

4. Ответьте на электронное письмо, чтобы сообщить Google о том, что ваши проекты переведены в новую организацию.

5. Команда Google по вопросам соответствия требованиям рассмотрит вашу заявку и отправит электронное письмо на адрес электронной почты, указанный при обращении к API, с информацией о статусе одобрения и дополнительными подробностями.

Измените ваши API-запросы

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

Java

Вскоре!

.СЕТЬ

Загрузите и установите библиотеку Google Ads API .NET версии 17.1.0 или новее.

Далее, измените свой код следующим образом:

// Create a client.
GoogleAdsClient client = new GoogleAdsClient();

// Opt into the pilot.
client.Config.UseCloudOrgForApiAccess = true;

// Make the API calls.
...

PHP

Вскоре!

Python

Вскоре!

Руби

Вскоре!

Perl

Вскоре!

HTTP-клиент (REST)

В HTTP-запросах не следует указывать заголовок developer-token :

curl -i -X POST https://googleads.googleapis.com/v24/customers/CUSTOMER_ID/googleAds:searchStream \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "login-customer-id: LOGIN_CUSTOMER_ID" \
  --data-binary "@query.json"

Часто задаваемые вопросы

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

Означает ли это изменение, что для использования API Google Ads мне необходимо быть клиентом Google Workspace или Google Cloud?

Нет. Вам нужна организация Google Cloud, которую можно получить несколькими способами . Это требование аналогично тому, как сегодня для использования Google Ads API необходим проект в Google API Console.

Мне нужно изменить уровни доступа к API. Как это сделать?

На данный момент вам следует продолжать использовать Центр API для запроса любых изменений уровней доступа к API .

Предусмотрены ли какие-либо простои в связи с участием в этом пилотном проекте?

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

Сколько усилий требуется для участия в этом пилотном проекте?

Ожидайте минимальных изменений в коде . Большинство разработчиков смогут внести изменения в свое приложение менее чем за 30 минут.

Будет ли с меня взиматься плата, если я приму участие в этом пилотном проекте?

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

Возможные сценарии получения организации в Google Cloud следующие:

1. Вы являетесь действующим клиентом Google Workspace или Google Cloud Identity :

   За обычное использование этих продуктов с вас будет взиматься обычная плата. За создание организации Google Cloud для участия в этом пилотном проекте плата взиматься не будет.

2. Вы создали учетную запись бесплатной версии Google Cloud Identity :

   С вас не будет взиматься плата при регистрации бесплатной учетной записи Google Cloud Identity или при создании организации Google Cloud для участия в этом пилотном проекте.

3. Компания Google создала для вас специальный ресурс для организации облачных сервисов :

   Это внутренний ресурс облачной организации, управляемый Google, поэтому с вас не будет взиматься плата.

У меня есть несколько токенов разработчика для разных инструментов. Как этот пилотный проект повлияет на меня?

Данный вариант использования не поддерживается, поэтому вы не сможете принять участие в этом пилотном проекте.

Повлияет ли это на существующую авторизацию API для аккаунтов, которыми я управляю с помощью Google Ads API?

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

Я принял участие в пилотном проекте и у меня возникла проблема или есть замечания. Как мне связаться со службой поддержки?

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