Управление настройками проекта Play Games Services в Google Cloud.

В некоторых случаях вам может потребоваться просматривать и редактировать свой проект Play Games Services непосредственно в Google Cloud.

Типичные сценарии включают в себя:

  • Включение дополнительных API для вашего проекта (например, Google Drive).
  • Редактирование информации о брендинге вашей игры в диалоговом окне OAuth 2.0.
  • Просмотр вашей квоты API и запрос на увеличение (при необходимости).
  • Редактирование разрешенных URI или источников JavaScript в созданных вами ранее идентификаторах клиентов.

Просмотреть ваш проект

Чтобы просмотреть свой проект в Google Cloud:

  1. Выберите учетные данные для вашей игры на странице «Конфигурация» ( Увеличение числа пользователей > Службы Play Games > Настройка и управление > Конфигурация ).
  2. Перейдите в раздел «Аутентификация» и нажмите «Просмотреть в Google Cloud» .

Настройте квоты на использование API.

В Google Cloud вы можете просмотреть установленные для вашей игры лимиты использования API и объем использованной квоты. Вы также можете установить лимиты для каждого пользователя, чтобы предотвратить исчерпание квоты злоумышленниками (или неисправным игровым клиентом).

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

  1. Если у вас еще нет платежного аккаунта для вашего проекта, создайте его.
  2. Перейдите на страницу «Включенные API» в библиотеке API в консоли API и выберите API из списка.
  3. Чтобы просмотреть и изменить настройки, связанные с квотами, выберите «Квоты» . Чтобы просмотреть статистику использования, выберите «Использование» .

Обратите внимание, что "пользователи" определяются на основе IP-адреса клиента, отправляющего запрос на выделение квоты. Например, если все ваши запросы поступают с одного сервера, этот сервер может быть ошибочно помечен как один и тот же спам-пользователь. Чтобы предотвратить это, вы можете добавить аргумент userIp=xxxx к запросам к вашим API-интерфейсам.

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

Помимо лимита на одного пользователя, существует общеприложениевый суточный лимит для API сервисов Google Play Games. Как правило, вам не потребуется изменять предварительно выделенный лимит. Однако, если вы ожидаете значительного увеличения объема запросов (например, в связи с предстоящим запуском), вы можете запросить дополнительную квоту, нажав на ссылку «Запросить больше» .

Активируйте другие API

При создании идентификатора клиента в Play Console API Google Play Games Services автоматически включается для вашего проекта. Вы можете активировать другие API Google из Google Cloud.

Чтобы включить API для вашего проекта, выполните следующие действия:

  1. Откройте библиотеку API в консоли Google API. При появлении запроса выберите проект или создайте новый. В библиотеке API отображаются все доступные API, сгруппированные по семействам продуктов и популярности.

  2. Если нужный вам API отсутствует в списке, воспользуйтесь поиском, чтобы его найти.

  3. Выберите API, который хотите включить, затем нажмите кнопку «Включить» .

  4. При появлении запроса включите оплату.

  5. При появлении запроса примите условия использования API.

Изменить информацию о бренде

Чтобы изменить информацию о брендинге (название, логотип и т. д.) вашей игры, которая отображается в диалоговом окне OAuth 2.0, задайте атрибуты на экране согласия в Google Cloud.

Чтобы настроить экран согласия для вашего проекта, выполните следующие действия:

  1. Откройте страницу «Экран согласия» в Play Console. Если появится запрос, выберите проект или создайте новый.
  2. Заполните форму и нажмите «Сохранить» .

Измените тип пользователя OAuth.

Если вы проводите тестирование в производственной среде (тестирование и выпуск > производство) с использованием личной тестовой учетной записи , вам также необходимо настроить параметры аудитории OAuth в Google Cloud как «Внешняя» . Дополнительную информацию см. в разделе «Управление аудиторией приложения» .

Изменить атрибуты, связанные с идентификатором клиента.

Чтобы изменить атрибуты, связанные с вашим идентификатором клиента OAuth 2.0 (источники веб-сайта и URL-адреса перенаправления для веб-приложения и т. д.):

  1. Откройте Play Console и найдите свою игру.
  2. Выберите учетные данные для вашей игры на странице «Конфигурация» ( Увеличение числа пользователей > Службы Play Games > Настройка и управление > Конфигурация ).
  3. Прокрутите страницу до конца раздела «Аутентификация» и нажмите «Просмотреть в Google Cloud» .
  4. В Google Cloud выберите свой проект.
  5. В боковой панели слева выберите «API и аутентификация» . Убедитесь, что в отображаемом списке API статус «Google Play Games Services API» установлен на «ВКЛ» .
  6. В боковой панели слева выберите «Зарегистрированные приложения» .
  7. Разверните раздел «Идентификатор клиента OAuth 2.0» и найдите атрибут для редактирования.

Перенос OAuth-клиентов из существующего облачного проекта.

Чтобы просмотреть свой проект в Google Cloud, выполните действия, описанные в разделе «Просмотр проекта» .

Для настройки Play Games Services (PGS) требуется уникальный проект Google Cloud. Если несколько игр используют один проект Cloud, необходимо перенести их клиенты Android OAuth в отдельные проекты для обеспечения правильной конфигурации.

Общий обзор двух игр, использующих один проект Google Cloud.
Рисунок 1. Пример совместной работы игр 1 и 2 над проектом в Google Cloud.

В приведенном выше примере игры 1 и 2 создали свои веб- и Android-клиенты в рамках одного проекта Google Cloud для входа через Google. Нам необходимо перенести веб- и Android-клиенты игры 2 из текущего устаревшего проекта Google Cloud в новый целевой проект Google Cloud.

Общий обзор миграции игры 2 в новый проект Google Cloud.
Рисунок 2. Миграция клиентов игры 2 на новый целевой проект Google Cloud.

Шаг 1: Подготовка бэкэнда

Перед выполнением переключения необходимо адаптировать вашу серверную часть и клиентские приложения для одновременной обработки старых и новых идентификаторов веб-клиентов.

  • Конфигурация на стороне сервера : Если ваш сервер проверяет идентификатор веб-клиента в токене ID, вам потребуется обновить логику на стороне сервера, чтобы одновременно поддерживать токены ID, выданные как старыми клиентами в проекте Legacy Cloud, так и новыми клиентами, которые вам необходимо сгенерировать в проекте Target Cloud.
  • Конфигурация на стороне клиента : Ваше клиентское приложение должно поддерживать несколько идентификаторов веб-клиента для входа в систему с использованием нового идентификатора веб-клиента при переключении. Вы можете использовать любой из следующих методов:
    • В клиентское приложение встроены 2 идентификатора веб-клиента, переключение на новый идентификатор веб-клиента происходит по истечении срока действия старого идентификатора.
    • Для завершения переключения необходимо динамически получить с сервера последний идентификатор веб-клиента.
  • Предварительное создание веб-клиентов : В целевом проекте необходимо заранее создать новый веб-клиент, чтобы избежать возможных задержек во время атомарного переключения.

Шаг 2: Настройте новые веб- и Android OAuth-клиенты в соответствующем облаке Google.

Шаг 2.1: Создайте новый веб-клиент OAuth для Игры 2 в целевом проекте Google Cloud:

Пользовательский интерфейс Google Cloud для создания нового идентификатора клиента Web OAuth.
Рисунок 3. Создание нового веб-клиента OAuth.

Шаг 2.2: Внимание: Изменение Android-клиента не позволит пользователям вашей игры входить в систему с помощью входа через Google, поэтому необходимо выполнить шаг 2.3 сразу после шага 2.2. Рекомендуется открывать две веб-страницы одновременно для выполнения операций, чтобы минимизировать временной интервал между изменением и повторным созданием.

Измените имя пакета Android-клиента игры 2 в устаревшем проекте Google Cloud на недопустимое значение, например, com.noexist.none .

Пользовательский интерфейс Google Cloud для изменения имени пакета клиента Android.
Рисунок 4. Изменение имени пакета Android-клиента в устаревшем проекте.

Шаг 2.3: Немедленно создайте новый Android-клиент для Игры 2 с тем же отпечатком SHA-1 и именем пакета Игры 2 в целевом проекте Google Cloud:

Пользовательский интерфейс Google Cloud для создания нового идентификатора клиента Android OAuth.
Рисунок 5. Создание нового Android-клиента в целевом проекте.

Шаг 3: Развертывание конфигурации в режиме реального времени

После успешного создания нового Android-клиента в целевом проекте немедленно выполните следующие действия:

  • Перенаправление клиентов : используйте механизм динамической конфигурации (например, Remote Config), чтобы немедленно переключить клиентское приложение на использование нового идентификатора веб-клиента.
  • Сохраните старых клиентов : Сохраните старых клиентов OAuth в качестве резервного варианта для возврата к предыдущей версии входа через OAuth в случае возникновения каких-либо проблем.