Настройка Service Account для Google Play Developer API

Для автоматизации публикации, отчётов и других серверных операций через Google Play Developer API нужен Service Account — специальный технический аккаунт, а не обычный вход через личный Google-аккаунт. Разберём настройку по шагам.

Что такое Service Account и зачем он нужен

Service Account — это учётная запись, предназначенная для программного (server-to-server) доступа к API без участия человека при каждом запросе. Используется для:

• автоматической публикации сборок (CI/CD);
• получения финансовых и статистических отчётов по расписанию;
• ответов на отзывы пользователей через API;
• управления подписками и заказами программно.

Шаг 1: включить Google Play Developer API в Google Cloud Console

1. Откройте Google Cloud Console и выберите существующий проект или создайте новый.
2. Перейдите на страницу Google Play Android Developer API (через поиск в библиотеке API).
3. Нажмите «Enable» — активация может занять несколько минут для полного распространения по системе.

Важно: включайте именно «Google Play Android Developer API», а не похожие по названию сервисы — это частая ошибка, которая потом приводит к ошибкам авторизации.

Шаг 2: создать Service Account

1. В Google Cloud Console перейдите в IAM & Admin → Service Accounts.
2. Нажмите «Create Service Account».
3. Укажите имя — на этом этапе НЕ нужно назначать роли Google Cloud (права доступа к Play Console настраиваются отдельно, позже).
4. Нажмите «Create and continue», затем «Done».

Шаг 3: создать JSON-ключ

1. В списке Service Accounts найдите созданный аккаунт.
2. Откройте вкладку Keys → Add Key → Create new key.
3. Выберите формат JSON — файл скачается автоматически.
4. Сохраните файл в защищённом месте — он содержит приватный ключ и не подлежит повторному скачиванию в исходном виде.

Скопируйте email service account из JSON-файла (поле client_email) — он понадобится на следующем шаге.

Шаг 4: предоставить доступ в Google Play Console

1. Откройте Google Play Console → Users and permissions.
2. Нажмите «Invite new user».
3. Вставьте email service account (из JSON-файла) вместо обычного email пользователя.
4. На вкладке App permissions выберите, к каким приложениям предоставляется доступ.
5. Отметьте нужные разрешения — например, «View app information», «View financial data», «Manage orders and subscriptions», в зависимости от того, что должен делать API-интеграция.
6. Нажмите «Invite user» и сохраните.

Частые проблемы при настройке

«Invalid Service Account JSON» при первом запросе

Обычно связано с тем, что Google ещё не активировал права полностью — может занять до 24 часов после первого сохранения прав в Play Console. Также стоит убедиться, что хотя бы одна сборка приложения загружена как минимум во внутренний тестовый трек (Internal testing track) — API может требовать наличие хотя бы одного релиза для полноценной работы с конкретным приложением.

Ошибка авторизации при вызове API

Проверьте:
— включена ли именно «Google Play Android Developer API» (не «Google Play Games Services» или другой похожий сервис);
— совпадает ли email service account в JSON с тем, что добавлен в Users and permissions;
— не истёк ли или не был ли случайно отозван ключ.

Недостаточно прав для конкретного действия

Если API возвращает ошибку доступа при попытке, например, изменить цену подписки, но не при чтении данных — проверьте конкретные разрешения service account в Play Console, они назначаются гранулярно и не включаются автоматически при базовом приглашении.

Меры безопасности

• Никогда не публикуйте JSON-ключ в открытых репозиториях кода — используйте переменные окружения или менеджеры секретов (Secret Manager, Vault и аналогичные).
• Предоставляйте только минимально необходимые разрешения — не используйте «Admin (all permissions)» для service account без явной необходимости.
• Периодически проверяйте список активных service accounts и их ключей, отзывайте неиспользуемые.

Частые вопросы

Нужно ли платить отдельно за использование Google Play Developer API?
Нет, использование API включено в стандартный аккаунт разработчика без дополнительной платы, за исключением возможных лимитов по количеству запросов.

Можно ли использовать один service account для нескольких приложений?
Да, права можно настроить как на уровне всего аккаунта (все приложения), так и на уровне отдельных выбранных приложений.

Как отозвать доступ service account, если он больше не нужен?
В Play Console: Setup → API access → найти нужный service account → Revoke access. Отдельно можно удалить и сам ключ в Google Cloud Console: IAM & Admin → Service Accounts → Keys → Delete.

Этот материал независим и не аффилирован с Google LLC. Официальная документация — на developers.google.com/android-publisher.

Читайте также: Роли и права доступа в Google Play Console · Верификация личности в Google Play Console · Аккаунт разработчика Google Play приостановлен: как подать апелляцию