Modifications

Les méthodes de modification de l'API Google Play Developer Publishing vous permettent de préparer un certain nombre de modifications à apporter à votre application Google Play, puis de les déployer toutes en même temps. Pour ce faire, créez une opération edit qui contient toutes les modifications que vous souhaitez apporter à l'application. La modification contient les informations suivantes:

• Les fichiers APK associés à l'application et un "niveau" pour chacun d'eux

  Chacun est associé à un "canal", ce qui détermine quels utilisateurs le voient. Vous pouvez ainsi fournir des versions alpha et bêta de l'application à vos testeurs. En outre, vous pouvez fournir une version limitée de l'application avec "déploiement par étapes". Celle-ci est automatiquement diffusée auprès d'un nombre limité d'utilisateurs de l'application (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 de la fiche Google Play Store de l'application

  Chaque version de la fiche Play Store spécifique à un pays peut contenir des captures d'écran et d'autres images promotionnelles, un texte descriptif localisé, etc.

Remarque :Toutes les méthodes fournies par l'API Google Play Developer n'utilisent pas la nouvelle fonctionnalité 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 ouverte pour l'application. La page de référence de l'API de chaque ressource indique spécifiquement si les méthodes de cette ressource utilisent le modèle "modification".

Lorsque vous créez une modification pour la première fois, il s'agit d'une copie de l'état déployé actuel de l'application. Vous pouvez ensuite modifier la modification en appelant les méthodes Edits. Lorsque la modification est prête, vous pouvez la valider pour appliquer les modifications. Vous pouvez également abandonner la modification à tout moment, 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é). Par conséquent, vous devez importer au moins un APK via la Play Console avant de 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 remplir les autorisations légales requises pour la publication. Pour publier l'application, vous devez utiliser la Play Console.

Attention :Si quelqu'un modifie l'application via la Google Play Console pendant qu'une modification est en cours, celle-ci est supprimée et les modifications apportées dans la Play Console prennent effet.

Workflow

Cette section explique comment apporter des modifications à une application à l'aide de la section Méthodes de modification de l'API Google Play Developer Publishing.

1. Créez une modification en appelant Edits: Insert et en spécifiant l'application à modifier.

   Cette action crée une nouvelle 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 effectuer la plupart des modifications qui pourraient être effectuées via la Google Play Console. Pour ce faire, appelez la méthode API Google Play Developer appropriée et transmettez les ID de l'application et de la modification à modifier. Notamment :

   • Vous pouvez importer de nouveaux APK en appelant Edits.apks: upload. Cela place l'APK dans un espace de stockage, de sorte qu'il puisse être attribué à une piste dans cette modification ou une modification ultérieure.
   • Vous pouvez attribuer des APK à des canaux en appelant Edits.tracks: update. Vous pouvez également modifier les attributions de canal 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 de la ressource Edits.expansionfiles.

   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 avoir qu'une seule modification ouverte à la fois. Si vous créez une modification, l'une de vos modifications existantes sera invalidée. De plus, si quelqu'un commet une modification ou apporte des modifications à une application via la Play Console, toutes les autres modifications de l'application (détenues par n'importe quel 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 (Modifications : commit), en l'absence d'erreurs de validation, toutes les modifications spécifiées dans la ressource de modifications sont mises en ligne et remplacent l'état actuel de l'application. La prise en compte de ces modifications peut prendre plusieurs heures, tout comme lorsque vous apportez des modifications via la Play Console.