Los métodos Edits de la API de Google Play Developer Publishing te permiten preparar varios cambios para la app que se publica en Google Play y, luego, implementarlos todos a la vez. Para ello, tienes que crear una edición que contenga todos los cambios que quieras realizar en la app. La edición debe incluir la siguiente información:
Cuáles son los APKs asociados con la app y un "segmento" para cada uno de ellos
Cada APK está asociado con un "segmento", que determina qué usuarios lo ven. Esto te permite proporcionar versiones alfa y beta de la app a los verificadores. Además, puedes proporcionar una versión de "lanzamiento en etapas" limitada de la app. Esa app se entrega automáticamente a una cantidad limitada de usuarios (determinada por el porcentaje de lanzamiento que hayas establecido), lo que te permite implementar una nueva versión de producción de la app de manera gradual.
Versiones específicas de la configuración regional y el idioma de la ficha de Google Play Store de la app
Cada versión de la ficha específica de la configuración regional puede contener capturas de pantalla y otros gráficos promocionales, texto descriptivo localizado, etcétera
Cuando creas una edición por primera vez, esta se genera como una copia del estado actual implementado de la app. Luego, puedes llamar a los métodos Edits para modificar la edición. Cuando la edición está lista, la confirmas y se publican los cambios. También puedes abandonar la edición en cualquier momento; para ello, descarta los cambios y deja la app tal como estaba.
Solo puedes usar esta API para realizar cambios en una app existente (que tenga al menos un APK subido). Por lo tanto, deberás subir al menos un APK a través de Play Console para poder usar la API. Además, no puedes usar esta API para cambiar el estado de una app de "publicada" a "sin publicar" ni para completar los consentimientos legales que se exigen a efectos de la publicación. Para publicar la app, debes usar Play Console.
Flujo de trabajo
En esta sección, se muestra la forma típica en que puedes usar los métodos Edits de la API de Google Play Developer Publishing para realizar modificaciones en una app.
Llama a Edits: Insert y especifica la app que quieras modificar para crear una nueva edición.
Se creará una edición nueva de la app especificada y se copiará la configuración inicial de la app (los APKs, las fichas de Play Store, los archivos de expansión, etc.) de la versión implementada de la app.
Modifica la edición según lo desees.
Podrás realizar la mayoría de los cambios que se pueden hacer desde Google Play Console. Para ello, llama al método apropiado de la API de Google Play Developer y pasa los IDs de la app y la edición que quieras modificar. Más precisamente:
- Puedes llamar a Edits.apks: upload para subir APKs nuevos. De esta forma, se colocará el APK en un área de almacenamiento, de manera que se pueda asignar a un segmento de esta edición o una posterior.
- Para asignar APKs a segmentos, llama a Edits.tracks: update. También puedes llamar a Edits.tracks: patch para cambiar las asignaciones de segmentos para los APKs existentes.
- Puedes llamar a Edits.listings: update para crear una nueva ficha de Play Store localizada. Para modificar una ficha de Play Store existente, llama a Edits.listings: patch.
- Puedes llamar a los métodos Edits.expansionfiles resource para agregar o modificar archivos de expansión.
Estos métodos realizan cambios en la edición que tienes en curso, pero no modifican la versión publicada de la app. Puedes realizar otros cambios o descartar la edición en curso sin afectar la experiencia del usuario.
Confirma la edición.
Cuando llamas a Edits: commit, si no hay errores de validación, se publican todos los cambios especificados en el recurso de edición y se reemplaza el estado actual de la app. Estos cambios pueden demorar varias horas en aplicarse, al igual que cuando realizas cambios a través de Play Console.