Modifications

L'API Google Play Developer Publishing Méthodes de modification vous permet de préparer un certain nombre de modifications à apporter à votre application Google Play, puis de les déployer simultanément. Pour ce faire, créez une modification qui contient toutes les modifications que vous souhaitez apporter à l'application. La modification contient les informations suivantes:

• Fichiers APK associés à l'application et "track" pour chaque fichier APK.

  Chacune d'entre elles est associée à un "track" qui détermine quels utilisateurs peuvent la voir. Cela vous permet de fournir des versions alpha et bêta de l'application à vos testeurs. En outre, vous pouvez fournir une version à déploiement limité de l'application. Celle-ci est automatiquement diffusée auprès d'un nombre limité d'utilisateurs (déterminé par le pourcentage de déploiement que vous avez défini), ce qui vous permet de déployer progressivement une nouvelle version de production.

• Versions linguistiques et régionales des fiches Play Store de l'application

  Chaque version locale de la fiche Play Store peut contenir des captures d'écran et d'autres images promotionnelles, du texte descriptif localisé, etc.

Remarque:Toutes les méthodes fournies par l'API Google Play Developer n'utilisent pas la nouvelle fonctionnalité de modification et de modification transactionnelle. Les méthodes associées aux ressources inappproducts, products et subscriptions prennent effet immédiatement, qu'il existe ou non une modification en cours pour l'application. Chaque page de référence de l'API indique spécifiquement si les méthodes pour cette ressource utilisent le modèle "edits" (modifications).

Lorsque vous créez une modification, celle-ci est une copie de l'état actuellement déployé de l'application. Vous pouvez ensuite la modifier en appelant les méthodes "Edits". Lorsque la modification est prête, vous vous engagez à l'appliquer. Vous pouvez également annuler la modification à tout moment, en la supprimant et en laissant votre application telle quelle.

Vous ne pouvez utiliser cette API que pour modifier une application existante (dans laquelle au moins un APK a été importé). Vous devez donc importer au moins un APK via la Play Console pour pouvoir utiliser cette API. De plus, vous ne pouvez pas utiliser cette API pour faire passer une application de l'état "Publiée" à "non publiée", ni pour fournir les autorisations légales requises pour la publication. Pour publier l'application, vous devez utiliser la Play Console.

Attention : Si quelqu'un apporte des modifications à l'application via la Google Play Console alors qu'une modification est en cours, celle-ci est supprimée et les modifications de la Play Console prennent effet.

Workflow

Cette section explique comment utiliser les méthodes de modification de l'API Google Play Developer Publishing pour modifier une application.

1. Créez une modification en appelant Edits: Insert (Modifications : Insérer) et en spécifiant l'application que vous souhaitez modifier.

   Cette opération crée une modification de l'application spécifiée. Les paramètres initiaux de l'application (APK, fiches Play Store, fichiers d'extension, etc.) sont tous copiés à partir de la version déployée de l'application.

2. Apportez les modifications souhaitées.

   Vous pouvez apporter la plupart des modifications via la Google Play Console. Pour ce faire, appelez la méthode appropriée de l'API Google Play Developer, puis transmettez les ID de l'application et de la modification que vous souhaitez modifier. Notamment :

   • Vous pouvez importer de nouveaux APK en appelant Edits.apks: upload. L'APK est ainsi placé dans une zone de stockage et peut donc être attribué à une piste de cette modification ou d'une modification ultérieure.
   • Vous pouvez attribuer des APK aux pistes en appelant Edits.tracks: update. Vous pouvez également modifier les attributions de suivi pour les APK existants en appelant Edits.tracks: patch.
   • Vous pouvez créer une fiche Play Store localisée en appelant Edits.listings: update. Vous pouvez modifier une fiche Play Store existante en appelant Edits.listings: patch.
   • Vous pouvez ajouter ou modifier des fichiers d'extension en appelant les méthodes Edits.expansionfiles resource.

   Ces méthodes modifient la modification en cours, mais ne modifient pas la version en ligne de l'application. Vous pouvez apporter d'autres modifications ou supprimer la modification en cours sans affecter l'expérience utilisateur.

   Remarque:Chaque utilisateur ne peut ouvrir qu'une seule modification à la fois. Si vous créez une modification, toute modification existante que vous avez ouverte est invalidée. En outre, si un utilisateur valide une application ou apporte des modifications à une application via la Play Console, toutes les autres modifications de l'application (appartenant à un utilisateur) sont invalidées. Si vous essayez de valider une modification non valide, l'opération génère une exception et n'a aucun effet.

3. Validez la modification.

   Lorsque vous appelez Edits: commit, en l'absence d'erreurs de validation, toutes les modifications spécifiées dans la ressource de modification sont mises en ligne et remplacent l'état actuel de l'application. Ces modifications peuvent prendre plusieurs heures, tout comme lorsque vous apportez des modifications via la Play Console.