Edits

Los métodos Edits de la API de Google Play Developer Publishing te permiten preparar varios cambios para la app de 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 APK 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 en cuanto a 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 de 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 a fin de 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 de Edits de la API de Google Play Developer Publishing a fin de realizar modificaciones en una app.

  1. 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 APK, las fichas de Play Store, los archivos de expansión, etc.) de la versión implementada de la app.

  2. Modifica la edición según lo desees.

    Podrás realizar la mayoría de los cambios que se pueden hacer a través de Google Play Console. Para ello, llama al método apropiado de la API de Google Play Developer y pasa los ID de la app y la edición que quieras modificar. Más precisamente, presenta las siguientes características:

    • Puedes llamar a Edits.apks: upload para subir APK 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 APK a segmentos, llama a Edits.tracks: update. También puedes llamar a Edits.tracks: patch a fin de cambiar las asignaciones de segmentos para los APK 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.

  3. 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.