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

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

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

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

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

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

Предпосылки

• Одобренный токен разработчика

  Для использования этой опции у вас уже должен быть одобренный токен разработчика. Вы можете найти существующий токен разработчика в API Center вашего аккаунта Google Ads Manager. Войдите в систему , затем перейдите в раздел «Администрирование» > «Центр API». В API Center выберите «Доступ к 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, которые вы используете с API Google Ads для пилотной программы, следующим образом:

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

• Актуальный контактный адрес электронной почты API

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

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

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

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

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

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

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

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

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

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

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

Ява

Вскоре!

.СЕТЬ

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

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

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

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

// Make the API calls.
...

PHP

Вскоре!

Питон

Вскоре!

Руби

Вскоре!

Перл

Вскоре!

HTTP-клиент (REST)

Исключите заголовок developer-token в ваших HTTP-запросах:

curl -i -X POST https://googleads.googleapis.com/v20/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"

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

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

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

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

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

На данный момент вам следует продолжать использовать API Center для запроса любых изменений уровней доступа 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-авторизацию для аккаунтов, которыми я управляю с помощью API Google Ads?

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

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

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