Modifiche

L'API Google Play Developer Publishing modifica i metodi ti consente di preparare una serie di modifiche alla tua app Google Play e di eseguirne il deployment contemporaneamente. A tal fine, puoi creare una modifica che contenga tutte le modifiche che vuoi apportare all'app. La modifica contiene informazioni quali:

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

  Ognuno di essi è associato a un "track", che determina quali utenti lo visualizzano. In questo modo puoi fornire ai tester le versioni alpha e beta dell'app. Inoltre, puoi fornire una versione a rilascio limitata dell'app; questa app viene pubblicata automaticamente per un numero limitato di utenti (determinata dalla percentuale di implementazione impostata) e consente di eseguire gradualmente il deployment di una nuova versione di produzione dell'app.

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

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

Nota: non tutti i metodi forniti dall'API Google Play Developer utilizzano le nuove "modifiche" transazionali. I metodi per le risorse inappproducts, products e subscriptions vengono applicati immediatamente, indipendentemente dal fatto che vi sia o meno una modifica aperta per l'app. Ogni pagina di riferimento all'API di ciascuna risorsa indica se i metodi per la risorsa utilizzano il modello "edits".

Quando crei per la prima volta una modifica, questa è una copia dello stato attuale del deployment dell'app. Puoi quindi modificarla modificando i metodi. Quando la modifica è pronta, puoi impegnarla, pubblicando le modifiche. Puoi anche abbandonare la modifica in qualsiasi momento, annullando le modifiche e lasciando l'app invariata.

Puoi utilizzare questa API soltanto per apportare modifiche a un'app esistente (con almeno un APK caricato); 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 richiesti per la pubblicazione. Per pubblicare l'app, devi utilizzare Play Console.

Attenzione: se qualcuno apporta modifiche all'app tramite Google Play Console mentre è in corso una modifica, la tua modifica viene ignorata e le modifiche di Play Console diventano effettive.

Flusso di lavoro

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

1. Crea una nuova modifica chiamando Modifiche: e specifica l'app da modificare.

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

2. Modifica la modifica nel modo più appropriato.

   Puoi apportare la maggior parte delle modifiche che potrebbero essere apportate tramite Google Play Console. A tale scopo, chiama il metodo appropriato dell'API Google Play Developer e trasmetti gli ID dell'app e modificala. Nello specifico:

   • Puoi caricare nuovi APK chiamando Edits.apks:upload. L'APK viene inserito in un'area di archiviazione, quindi può essere assegnato a un canale in questa o in una modifica successiva.
   • Puoi assegnare APK alle tracce chiamando Edits.tracks:update. Puoi anche modificare le assegnazioni delle tracce per gli APK esistenti chiamando il file 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 Edits.expansionfiles.

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

   Nota: ogni utente può avere una sola modifica aperta alla volta. Se crei una nuova modifica, qualsiasi modifica esistente aperta potrebbe essere invalidata. Inoltre, se qualcuno esegue una modifica o apporta modifiche a un'app tramite Play Console, tutte le altre modifiche dell'app (di proprietà di qualsiasi utente) vengono annullate. Se provi a eseguire una modifica non valida, l'operazione genererà un'eccezione e non avrà alcun effetto.

3. Esegui il commit della modifica.

   Quando chiami Modifiche: commit, se non sono presenti errori di convalida, tutte le modifiche specificate nella risorsa di modifica vengono applicate "in tempo reale", sostituendo lo stato attuale dell'app. Queste modifiche possono richiedere diverse ore prima di essere applicate, proprio come quando apporti modifiche tramite Play Console.