Методы редактирования Google Play Developer Publishing API позволяют подготовить ряд изменений в вашем приложении Google Play, а затем развернуть их все одновременно. Вы делаете это, создавая редактирование , в котором хранятся все изменения, которые вы хотите внести в приложение. Редактирование содержит такую информацию, как:
Какие APK-файлы связаны с приложением, а также «дорожка» для каждого APK.
Каждый связан с «дорожкой», определяющей, какие пользователи его увидят. Это позволяет вам предоставлять альфа- и бета-версии приложения для ваших тестировщиков. Кроме того, вы можете предоставить ограниченную версию приложения для поэтапного внедрения; это приложение автоматически предоставляется ограниченному числу пользователей приложения (определяется установленным вами процентом развертывания), что позволяет постепенно развертывать новую производственную версию приложения.
Версии приложения в Google Play Store для конкретного языка и локали.
Каждая версия страницы приложения для конкретного региона может содержать снимки экрана и другую рекламную графику, локализованный описательный текст и т. д.
Когда вы впервые создаете изменение, оно представляет собой копию текущего развернутого состояния приложения. Затем вы можете изменить редактирование, вызвав методы Edits. Когда редактирование готово к работе, вы фиксируете его, внося изменения в действие. Вы также можете в любой момент отказаться от редактирования, отменив изменения и оставив приложение в прежнем виде.
Вы можете использовать этот API только для внесения изменений в существующее приложение (в которое загружен хотя бы один APK); таким образом, вам придется загрузить хотя бы один APK через Play Console, прежде чем вы сможете использовать этот API. Кроме того, вы не можете использовать этот API для изменения состояния приложения с «опубликовано» на «неопубликовано» или для заполнения юридических разрешений, необходимых для публикации. Чтобы опубликовать приложение, вам необходимо использовать Play Console.
Рабочий процесс
В этом разделе показан типичный способ использования методов редактирования Google Play Developer Publishing API для внесения изменений в приложение.
Создайте новое изменение, вызвав Edits: Insert и указав приложение, которое вы хотите изменить.
При этом создается новая редакция указанного приложения. Исходные настройки приложения — APK-файлы, списки магазинов, файлы расширений и т. д. — копируются из развернутой версии приложения.
Измените редактирование по желанию.
Вы можете внести большинство изменений, которые можно внести через консоль Google Play. Это делается путем вызова соответствующего метода API разработчика Google Play и передачи идентификаторов приложения и изменений, которые вы хотите изменить. Конкретно:
- Вы можете загрузить новые APK-файлы, вызвав Edits.apks:upload . При этом APK помещается в область хранения, поэтому его можно назначить треку в этом или последующем редактировании.
- Вы можете назначить APK трекам, вызвав Edits.tracks: update . Вы также можете изменить назначения треков для существующих APK, вызвав Edits.tracks: patch .
- Вы можете создать новый локализованный список магазинов, вызвав Edits.listings: update . Вы можете изменить существующий список магазинов, вызвав Edits.listings: patch .
- Вы можете добавлять или изменять файлы расширения, вызывая методы ресурса Edits.expansionfiles .
Эти методы вносят изменения в выполняемое вами редактирование, но не изменяют живую версию приложения. Вы можете внести дальнейшие изменения или отменить текущее редактирование, не влияя на взаимодействие с пользователем.
Зафиксируйте редактирование.
Когда вы вызываете Edits: commit , если нет ошибок проверки, все изменения, указанные в ресурсе редактирования, переходят в «живой» режим, заменяя текущее состояние приложения. Для вступления изменений в силу может потребоваться несколько часов, как и при внесении изменений через Play Console.