Modifiche

I metodi di modifica dell'API Google Play Developer Publishing ti consentono di preparare una serie di modifiche alla tua app Google Play, per poi implementarle tutte contemporaneamente. Per farlo, crea una modifica, che contiene tutte le modifiche che vuoi apportare all'app. La modifica contiene informazioni quali:

• Gli APK associati all'app e un "traccia" per ogni APK.

  Ciascuno di questi elementi è associato a una "traccia", che determina quali utenti possono visualizzarlo. In questo modo puoi fornire ai tester le versioni alpha e beta dell'app. Inoltre, puoi fornire una versione "implementazione graduale" dell'app in release limitata. L'app viene pubblicata automaticamente per un numero limitato di utenti dell'app (determinata dalla percentuale di implementazione impostata), in modo da poter implementare gradualmente una nuova versione di produzione dell'app.

• Versioni della scheda del Google Play Store dell'app specifiche per lingua e per lingua

  Ogni versione della scheda dello Store specifica per ogni lingua può contenere screenshot e altre immagini promozionali, testo descrittivo localizzato e così via.

Quando crei una modifica per la prima volta, questa è una copia dello stato attuale di cui è stato eseguito il deployment dell'app. Puoi quindi modificare la modifica chiamando i metodi Edits. Quando la modifica è pronta, ne esegui il commit e le modifiche vengono pubblicate. Puoi anche abbandonare la modifica in qualsiasi momento, annullando le modifiche e lasciando l'app com'era.

Puoi utilizzare questa API soltanto per apportare modifiche a un'app esistente (in cui è stato caricato almeno un APK); pertanto, dovrai caricare almeno un APK tramite Play Console prima di poter utilizzare questa API. Inoltre, non puoi utilizzare questa API per cambiare lo stato di un'app da "pubblicata" a "non pubblicata" o per compilare i consensi legali necessari per la pubblicazione. Per pubblicare l'app, devi usare Play Console.

Flusso di lavoro

Questa sezione mostra il modo tipico in cui utilizzeresti i metodi di modifica dell'API Google Play Developer Publishing per apportare modifiche a un'app.

1. Crea una nuova modifica chiamando Edits: Insert e specificando l'app da modificare.

   Viene creata una nuova modifica per l'app specificata. Le impostazioni iniziali dell'app (APK, schede dello Store, file di espansione e così via) vengono tutte copiate dalla versione dell'app di cui è stato eseguito il deployment.

2. Modifica la modifica come preferisci.

   Puoi apportare la maggior parte delle modifiche che puoi apportare tramite Google Play Console. Per farlo, chiama il metodo API Google Play Developer appropriato, trasmetti gli ID dell'app e trasmetti la modifica che vuoi modificare. In particolare:

   • Puoi caricare nuovi APK chiamando Edits.apks: upload. L'APK viene inserito in un'area di archiviazione in modo che possa essere assegnato a una traccia in questa modifica o in una successiva.
   • Puoi assegnare gli APK ai canali chiamando Edits.tracks: update. Puoi anche modificare le assegnazioni delle tracce per gli APK esistenti chiamando Edits.tracks: patch.
   • Puoi creare una nuova scheda dello Store localizzata chiamando Edits.listings: update. Puoi modificare una scheda dello Store esistente chiamando Edits.listings: patch.
   • Puoi aggiungere o modificare i file di espansione chiamando i metodi della risorsa Edits.expansionfiles.

   Questi metodi apportano modifiche alla modifica in corso, ma non modificano la versione pubblicata dell'app. Puoi apportare ulteriori modifiche o ignorare la modifica in corso senza influire sull'esperienza utente.

3. Esegui il commit della modifica.

   Quando chiami Modifiche: commit, se non ci sono errori di convalida, tutte le modifiche specificate nella risorsa di modifica vengono pubblicate, sostituendo lo stato attuale dell'app. L'applicazione di queste modifiche può richiedere diverse ore, proprio come quando apporti modifiche tramite Play Console.