Modifiche

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

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

  Ognuno è associato a una "traccia", che determina quali utenti lo vedono. In questo modo, puoi fornire ai tester le versioni alpha e beta dell'app. Inoltre, puoi fornire una versione dell'app con "implementazione graduale" a rilascio limitato. Questa app viene automaticamente mostrata a un numero limitato di utenti dell'app (determinato dalla percentuale di implementazione che imposti), consentendoti di implementare gradualmente una nuova versione di produzione dell'app.

• Versioni specifiche per lingua e località della scheda dello Store Google Play dell'app

  Ogni versione specifica per le impostazioni internazionali della scheda dello Store 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 la nuova funzionalità "modifiche" transazionali. I metodi per le risorse inappproducts, products e subscriptions hanno effetto immediatamente, indipendentemente dal fatto che sia aperta una modifica per l'app. La pagina di riferimento API di ogni risorsa indica in modo specifico se i metodi per quella risorsa utilizzano il modello "modifiche".

Quando crei una modifica, questa è una copia dello stato di implementazione attuale dell'app. Puoi quindi modificarla chiamando i metodi Edits. Quando la modifica è pronta, la esegui, rendendo effettive le modifiche. Puoi anche abbandonare la modifica in qualsiasi momento, annullando le modifiche e lasciando l'app così com'era.

Puoi utilizzare questa API solo per apportare modifiche a un'app esistente (che ha 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 modificare 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 eliminata e le modifiche di Play Console vengono applicate.

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 che vuoi modificare.

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

2. Modifica la modifica come preferisci.

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

   • Puoi caricare nuovi APK chiamando Edits.apks: upload. In questo modo, l'APK viene inserito in un'area di archiviazione, in modo che possa essere assegnato a un canale in questa o in una modifica 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 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 live dell'app. Puoi apportare ulteriori modifiche o eliminare 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 che potresti aver aperto viene invalidata. Inoltre, se qualcuno esegue una modifica o apporta modifiche a un'app tramite Play Console, tutte le altre modifiche all'app (di proprietà di qualsiasi utente) vengono invalidate. 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 modifiche 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.