Play Integrity API: руководство по связыванию облачных проектов и квотам

Для трафика из облачных проектов Google Cloud, которые не связаны с приложением в Google Play Console или SDK в Play SDK Console, Google Play Integrity API устанавливает ограничение в 10 000 запросов в день. Это ограничение уже действует для большинства проектов Google Cloud. Для небольшого числа проектов с ранее повышенной квотой срок завершения связывания до применения ограничения продлен до 16 февраля 2027 г.

В этом руководстве рассказывается, как связывание проектов влияет на квоту, как связать облачные проекты Google Cloud с приложением или SDK, а также приводятся ответы на часто задаваемые вопросы.

Краткая сводка

Основная информация Описание
Дата вступления в силу Уже активен для большинства проектов.
16 февраля 2027 года для проектов, получивших уведомление о крайнем сроке.
Правила Запросы Play Integrity API, поступающие из проектов Cloud, которые не связаны с вашим приложением или SDK, ограничены 10 000 запросов в день, независимо от того, настроена ли в проекте более высокая пользовательская квота.
Кого затронут изменения Приложения и SDK, которые выполняют более 10 000 запросов в день, используя проект Google Cloud, не связанный с этим приложением (в Play Console) или SDK (в Play SDK Console).
Требуется действие Свяжите свои облачные проекты Google Cloud со своим приложением в Google Play Console или с SDK в Google Play SDK Console.
Ошибка при превышении квоты Если вы не свяжете аккаунты,то при превышении лимита в 10 000 запросов в день будет возникать ошибка TOO_MANY_REQUESTS (код ошибки -8).

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

По умолчанию Play Integrity API предоставляет каждому облачному проекту Google Cloud квоту в 10 000 запросов в день. Разработчики, которым требуется больший объем, могут запросить увеличение квоты.

Чтобы защитить ваше приложение или SDK и не позволить посторонним лицам исчерпать вашу квоту, увеличенная дневная квота предоставляется только проектам Google Cloud, связанным с вашим приложением в Google Play Console или с вашим SDK в Google Play SDK Console.

Для приложений (Google Play Console):

  1. Войдите в Google Play Console и выберите приложение.
  2. В меню навигации слева выберите Защищено Google Play.
  3. Рядом с Play Integrity API выберите Начать или Настроить.
  4. Нажмите Установить связь с облачным проектом (или Добавить проект, если у вас уже есть связанные проекты).
  5. Выберите или введите номер проекта Google Cloud, с которым нужно установить связь, и подтвердите выбор.

Для SDK (Google Play SDK Console)

  1. Войдите в Google Play SDK Console и выберите SDK.
  2. В меню навигации слева выберите Целостность SDK.
  3. Рядом с Play Integrity API нажмите Настройки.
  4. Нажмите Установить связь с облачным проектом (или Добавить ещё один, если у вас уже есть связанные проекты).
  5. Выберите или введите номер проекта Google Cloud, с которым нужно установить связь, и подтвердите выбор.

Необходимые разрешения:

  • Play Console (для приложений). У вас должно быть разрешение Выпуск рабочей версии, исключение устройств и использование функции подписания приложений в Google Play.
  • Play SDK Console (для SDK). У вас должно быть разрешение Управление для SDK.
  • Google Cloud (оба варианта). У вас должны быть разрешения serviceusage.services.enable и resourcemanager.projects.get для целевого проекта Google Cloud.

Для приложений (Google Play Console):

  1. Откройте Google Play Console > Защита с помощью Google Play > Play Integrity API > Управление.
  2. Проверьте раздел "Конфигурация проекта".
  3. Убедитесь, что указанный номер проекта совпадает с тем, который используется для вызова Play Integrity API.

Для SDK (Google Play SDK Console)

  1. Откройте Google Play SDK Console > Целостность SDK > Настройки.
  2. Проверьте раздел "Конфигурация проекта".
  3. Убедитесь, что указанный номер проекта совпадает с тем, который используется для вызова Play Integrity API.

Как связать облачный проект, если моего приложения или SDK нет в Google Play?

Связывать облачный проект Google Cloud можно только с приложениями, управляемыми в Google Play Console, и SDK, зарегистрированными в Google Play SDK Console.

Если ваше приложение распространяется только за пределами Google Play или вашего SDK нет в Play SDK Console, вы не сможете установить связь с проектом Google Cloud. В этом случае трафик Play Integrity API будет ограничен 10 000 запросов в день по умолчанию. Чтобы получить право на увеличенную квоту, опубликуйте приложение в Google Play или зарегистрируйте соответствующий SDK в Play SDK Console и свяжите его с облачным проектом.

5. Можно ли связать несколько проектов Google Cloud или использовать один проект для разных приложений или SDK?

  • Несколько проектов для одного приложения или SDK. С одним приложением или SDK можно связать до пяти проектов Google Cloud.
  • Один проект для нескольких приложений. Вы можете связать один проект Google Cloud с несколькими приложениями в Google Play Console. Связывать один облачный проект Google Cloud с несколькими SDK или с SDK и приложением не поддерживается.

6. Что делать, если я управляю приложением или SDK, но облачный проект Google Cloud принадлежит другому сотруднику организации?

Чтобы установить связь, у пользователя, выполняющего действие в Play Console (или Play SDK Console), также должны быть необходимые разрешения в проекте Google Cloud. Это можно сделать двумя способами:

  • Вариант А. Попросите пользователя, который может управлять доступом IAM в проекте Google Cloud, временно предоставить вашему аккаунту Google разрешения serviceusage.services.enable и resourcemanager.projects.get. После этого разрешения больше не понадобятся для повседневных операций.
  • Вариант Б. Предоставьте участнику команды, у которого уже есть разрешения serviceusage.services.enable и resourcemanager.projects.get для облачного проекта Google Cloud, необходимое разрешение в Play Console, чтобы он мог выполнить связывание.
    • Для приложений (Play Console). Предоставьте разрешение Выпуск рабочей версии, исключение устройств и использование функции подписания приложений в Google Play.
    • Для SDK (Play SDK Console): предоставьте разрешение Управление для SDK.

7. Что произойдет, если я не свяжу облачный проект до 16 февраля 2027 года?

Если после 16 февраля 2027 года приложение или SDK отправит запрос к Play Integrity API, используя несвязанный проект Google Cloud:

  1. До 10 000 запросов в день. Запросы выполняются в обычном режиме в рамках базовой квоты по умолчанию.
  2. Более 10 000 запросов в день. Если количество запросов в день превысит 10 000, они будут отклоняться с ошибкой TOO_MANY_REQUESTS (код ошибки -8).

Мгновенное самостоятельное устранение проблем

Если после указанной даты ваше приложение или SDK получает ошибки TOO_MANY_REQUESTS из-за того, что облачный проект не связан, установите связь с отсутствующим облачным проектом Google Cloud в Play Console или Play SDK Console.

8. Я не использую Play Integrity API. Почему я получил сообщение с просьбой связать мой облачный проект?

Вы получили это уведомление,потому что ваш проект Google Cloud генерирует более 10 000 несвязанных запросов к Play Integrity API в день. Вот список распространенных причин:

  1. Библиотека или SDK, настроенные с использованием номера вашего проекта Google Cloud. Некоторые библиотеки вызывают Play Integrity API, используя ваш проект Google Cloud. Если ваше приложение или SDK использует такую библиотеку, свяжите этот проект со своим приложением в Play Console или со своим SDK в Play SDK Console.
  2. Другое приложение или команда в вашей организации. Другая команда может использовать этот проект Google Cloud в своем приложении или SDK. Обратитесь к разработчикам, чтобы определить приложение или SDK, а затем свяжите проект в Play Console или Play SDK Console.
  3. Неавторизованный трафик или устаревшая интеграция. Если неавторизованные или клонированные приложения отправляют запросы с номером вашего проекта или вы больше не используете API, никаких действий не требуется. Если вы не свяжете аккаунты, то в день будет обрабатываться не более 10 000 запросов, что позволит ограничить нежелательный трафик.

Контакты и поддержка

Если у вас есть вопросы о том, как связать облачный проект или управлять квотой Play Integrity API: