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

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

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

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

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

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

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

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

• Облачная организация Google

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

// Make the API calls.
...

curl -i -X POST https://googleads.googleapis.com/v16/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, чтобы использовать Google Ads API?

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

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

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

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

Нет, нет. API Google Рекламы автоматически начнет использовать уровни доступа к API на уровне организации, как только он будет одобрен.

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

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

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

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

Возможные сценарии получения организации 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 Рекламы?

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

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

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