Modifications

Les méthodes d'édition 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, vous devez créer une modification, qui contient toutes les modifications que vous souhaitez apporter à l'application. La modification contient des informations telles que :

• Les APK associés à l'application et un "canal" pour chaque APK.

  Chacune est associée à un "canal", qui détermine les utilisateurs qui la voient. Cela vous permet de fournir des versions alpha et bêta de l'application à vos testeurs. Vous pouvez également fournir une version de l'application en version limitée "déploiement par étapes". Cette application est automatiquement proposée à un nombre limité d'utilisateurs de l'application (déterminé par le pourcentage de déploiement que vous définissez), ce qui vous permet de déployer progressivement une nouvelle version de production de l'application.

• Versions de la fiche Google Play Store de l'application spécifiques à une langue et à un paramètre régional

  Chaque version de la fiche Play Store spécifique à une langue peut contenir des captures d'écran et d'autres éléments graphiques promotionnels, du texte descriptif traduit, etc.

Remarque : Toutes les méthodes fournies par l'API Google Play Developer n'utilisent pas la nouvelle fonctionnalité transactionnelle de "modification". Les méthodes associées aux ressources inappproducts, products et subscriptions prennent immédiatement effet, qu'une modification soit en cours ou non pour l'application. La page de documentation de référence de l'API de chaque ressource indique expressément si les méthodes de cette dernière ont recours au modèle "modification".

Lorsque vous créez une modification pour la première fois, il s'agit d'une copie de l'état de déploiement actuel de l'application. Vous pouvez ensuite modifier la modification en appelant les méthodes Edits. Lorsque la modification est prête, vous l'enregistrez pour qu'elle soit appliquée. Vous pouvez également abandonner la modification à tout moment, en supprimant les modifications et en laissant votre application telle quelle.

Vous ne pouvez utiliser cette API que pour apporter des modifications à une application existante (qui a au moins un APK importé). Vous devrez donc 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 modifier l'état d'une application de "publiée" à "non publiée", ni pour remplir les consentements légaux requis pour la publication. Pour publier l'application, vous devez utiliser la Play Console.

Attention : Si quelqu'un modifie l'application dans la Google Play Console pendant que vous êtes en train de la modifier, vos modifications seront supprimées et celles de la Play Console seront appliquées.

Workflow

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

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

   Une nouvelle version modifiable de l'application spécifiée est alors créé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. Modifiez la vidéo comme vous le souhaitez.

   Vous pouvez apporter la plupart des modifications qui pouvaient être effectuées dans la Google Play Console. Pour ce faire, appelez la méthode appropriée de l'API Google Play Developer et transmettez les ID de l'application et de la modification que vous souhaitez modifier. Plus spécifiquement :

   • Vous pouvez importer de nouveaux APK en appelant Edits.apks: upload. L'APK est alors placé dans une zone de stockage, ce qui permet de l'attribuer à un niveau de sortie lors de cette modification ou d'une modification ultérieure.
   • Vous pouvez attribuer des APK à des canaux en appelant Edits.tracks:update. Vous pouvez également modifier les affectations de pistes 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 active de l'application. Vous pouvez apporter d'autres modifications ou ignorer 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, toute modification existante que vous avez peut-être ouverte est invalidée. De plus, si quelqu'un modifie une application ou y apporte des changements dans la Play Console, toutes les autres modifications apportées à l'application (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, si aucune erreur de validation n'est détectée, toutes les modifications spécifiées dans la ressource "edits" sont appliquées, remplaçant l'état actuel de l'application. Ces modifications peuvent prendre plusieurs heures, tout comme lorsque vous les apportez dans la Play Console.