Даты прекращения поддержки

В этом документе указан график прекращения поддержки SDK Play Games Services v1.

В связи с прекращением поддержки API Google Sign-in (GSI) и запланированным закрытием мы прекращаем поддержку SDK и API Play Games Services v1. Для получения доступа к новейшим функциям вам необходимо перевести свою игру на SDK Play Games Services v2.

Сроки прекращения поддержки следующие:

Дата Амортизация
важная веха
Влияние Разработчик
действие
Май 2026 г. Удаление API GSI Если в игру добавлены новые функции, такие как Liveops, миссии или карты, которые не требуют аутентификации Google, за исключением API Play Games Services v1, эти функции будут продолжать работать.

Если ваша игра использует сторонний SDK или SDK Google, отличный от Play Games Services v1, который требует обновления аутентификации, обновление до последней версии этого SDK может привести к ошибкам компиляции.
  1. При возникновении ошибки компиляции следуйте указанному здесь пути устранения проблемы.
  2. Обязательно выполните миграцию на Play Games Services v2 в соответствии с указанным здесь планом решения сразу после его выпуска в конце второго квартала 2026 года.
15 июня 2026 г. Удаление API сервисов Play Games v1 Будет выпущена новая версия SDK Play Games Services v1 с удалёнными API GSI, без дальнейших исправлений ошибок или обновлений существующих функций Play Games Services v1.
Если существующая игра версии 1 обновится до последней версии Play Games Services v1, функциональность Play Games Services в этой новой версии перестанет работать.
  1. Games on Play Games Services v1 не должны обновлять свой SDK v1 до версии com.google.android.gms:play-services-games:25.0.0 , поскольку это удаляет API версии v1.
  2. В любой игре, которая не перешла на Play Games Services v2, могут возникать ошибки компиляции, поскольку с мая 2026 года play-services-auth больше не предоставляет GSI.
  3. Следуя графику, упомянутому в предыдущем разделе, разработчики игр могут следить за обновлением других SDK и убедиться, что другие SDK не используют новый SDK Credential Manager до тех пор, пока они не будут переведены на Play Games Services v2.
Май 2027 г. Сервисы Play Games v1 завершили работу. Весь трафик от Play Games Services v1 заблокирован, игра не компилируется.

Существующие API-интерфейсы Play Games Services v1 перестают работать в производственной среде.
Единственный вариант — перейти на Play Games Services v2 до истечения этого срока, чтобы избежать проблем с подключением и авторизацией игроков.
  • После сентября 2025 года SDK и API для игр версии 1 будут признаны устаревшими. Существующие игры с предыдущими интеграциями версии 1 продолжат функционировать. Google Play не будет публиковать новые игры, использующие SDK и API версии 1.

  • Начиная с 15 июня 2026 года, устаревшие API будут удалены из SDK.

  • Начиная с июня 2027 года, SDK для игр версии 1 будет удален. Вызовы к этим API будут завершаться ошибкой, даже если вы используете предыдущие версии SDK.

В таблице ниже перечислены версии игры v1 (SDK), даты их устаревания и руководства по миграции:

версия SDK Дата выпуска Руководство по миграции
play-services-games:v24.0.0 12 сентября 2025 г.
Устаревший
Переход на версию 2 (Java или Kotlin)
v0.10.15 Unity 17 сентября 2025 г.
Устаревший
Переход на версию 2 (Unity)
play-services-games:v25.0.0 15 июня 2026 г.
API Play Games Services v1 удален из SDK.
Переход на версию 2 (Java или Kotlin)

Пример влияния удаления API GSI

Рассмотрим сценарий, в котором SDK (SDK1) получает список друзей из учетной записи Google игрока. Для использования этой функции игрокам необходимо авторизовать свою учетную запись Google с помощью SDK аутентификации Google.

В следующих ситуациях может потребоваться обновление SDK аутентификации Google:

  • Устранена критическая ошибка в процессе аутентификации.
  • Реализуйте новые возможности ввода паролей, предоставляемые SDK менеджера учетных данных.

В таблице ниже описаны три сценария обновления интеграции аутентификации в вашей игре:

  • Сценарий 1: SDK1 обновляется до последней версии Google Authentication SDK.
  • Сценарий 2: SDK1 интегрируется с Credential Manager, при этом SDK аутентификации Google остается без изменений.
  • Сценарий 3: SDK1 интегрируется с Credential Manager и удаляет Google Authentication SDK.
Особенность Сценарий 1 Сценарий 2 Сценарий 3
Сценарии обновления аутентификации
  1. Информация об удалении API GSI отсутствует, игра обновлена ​​до последней версии SDK аутентификации.
  2. Существующая функциональность аутентификации перестаёт работать, и SDK1 вынужден интегрировать SDK Credential Manager.
  3. Вышла последняя версия игры с новейшими SDK для аутентификации и SDK для управления учетными данными.
Учитывая удаление API GSI, SDK1 не обновляет SDK аутентификации, а использует SDK Credential Manager в своей последней версии для обеспечения функциональности аутентификации Google. В своей последней версии SDK1 обеспечивает работу функции аутентификации Google с помощью Credential Manager SDK и полностью удаляет SDK аутентификации.
Play Games Services v1 SDK Без изменений Без изменений Без изменений
Что происходит при компиляции игры?
  1. Для работы Play Games Services v1 требуется отдельная интеграция с SDK аутентификации -> Поскольку в обновленной версии SDK аутентификации отсутствуют API GSI, Play Games Services v1 перестанет работать.
  2. В игре возникают ошибки на этапе компиляции.
  3. Затем игра пытается следовать пути разрешения.
В игре возникают ошибки компиляции. Затем игра пытается следовать пути разрешения.
Возможный опыт игрока Недоступно. Поскольку игра не компилируется, публикация невозможна.
  1. При аутентификации с использованием Play Games Services v1 игрок видит окно выбора учетной записи Play Games Services.
  2. При аутентификации в функции SDK1 игрок видит нижний экран диспетчера учетных данных.
  1. При аутентификации с использованием Play Games Services v1 игрок видит окно выбора учетной записи Play Games Services.
  2. При аутентификации в функции SDK1 игрок видит нижний экран диспетчера учетных данных.
Путь разрешения для разработчика игры
  1. Выясните, какой SDK вызывает обновление SDK аутентификации.
  2. Откатить версию SDK до SDK1.
  3. Перекомпилируйте их игру, добавив их собственную функцию.
  4. Если для новой игровой функции требуется обновление до SDK1, свяжитесь с разработчиками SDK1, чтобы они адаптировали сценарии 2 или 3 для своей версии.
  1. Ничего
  2. Однако, если вы также используете кнопку «Войти через Google» , вам, возможно, придется использовать два типа авторизации через Google для игроков.
  1. Ничего
  2. Однако, если вы также используете кнопку «Войти через Google» , вам, возможно, придется использовать два типа авторизации через Google для игроков.
Итоговый результат для Play Games Services v1 Игре не требуется обновление до Play Games Services v2, но SDK1 по-прежнему устарел. Для игры не требуется обновление с версии Play Games Services v1 до v2. Для игры не требуется обновление с версии Play Games Services v1 до v2.