Cette page a été traduite par l'API Cloud Translation.

APK et suivi

L'API Google Play Developer vous permet d'importer de nouveaux APK pour vos applications et de les publier dans différents canaux de publication. Cela vous permet de déployer les versions alpha et bêta de votre application, mises à la disposition des utilisateurs approuvés. Cela vous permet également de déployer une version avec déploiement par étapes, qui est automatiquement disponible pour un petit nombre d'utilisateurs de l'application. Une fois la version de déploiement par étapes déployée, vous pouvez augmenter progressivement le nombre d'utilisateurs qui obtiennent cette version de l'application, jusqu'à ce que vous la déployiez en tant que version de "production".

Ajouter et modifier des APK

Importez un ou plusieurs APK en appelant la méthode Edits.apks: upload.

Cette méthode importe l'APK dans un "bucket" de stockage, où il peut être attribué à un "track" pour le déployer auprès des utilisateurs. (Si la modification est supprimée, tous les APK importés pour cette modification sont également perdus.)
Publiez des fichiers APK sur &trackt;tracks en appelant Edits.tracks: update. Vous pouvez publier des APK sur les canaux suivants:
- Tester des canaux tels que "alpha" et "beta"
  
  Les versions alpha et bêta de l'application sont déployées pour les utilisateurs attribués aux groupes de test alpha et bêta. Vous pouvez attribuer des utilisateurs à ces groupes à l'aide de la Google Play Console.
- Canal de test interne : "internal"
  
  Les versions internes de votre application sont déployées sur votre canal de test interne tel qu'il est configuré dans la Google Play Console.
- Canal de production: "production"
  
  Les versions de production sont déployées pour tous les utilisateurs. Vous pouvez utiliser les versions par étapes en production pour d'abord déployer votre version en toute sécurité sur un petit pourcentage d'utilisateurs en production, puis augmenter progressivement ce pourcentage à mesure que votre niveau de confiance augmente.
Les utilisateurs en mode simple ne doivent pas placer plusieurs fichiers APK par canal. Les utilisateurs en mode avancé qui acceptent plusieurs fichiers APK peuvent importer des fichiers APK, un ou un par canal.

Exemple de workflow APK

Cette section décrit une utilisation courante de l'API Tracks. Dans ce cas, nous partons du principe que vous souhaitez importer de nouvelles versions de l'APK pour chaque niveau de sortie et attribuer un nombre d'utilisateurs pour la réception d'une version de déploiement par étapes. En pratique, il est peu probable qu'un développeur effectue toutes ces actions dans la même opération. À la place, vous pouvez mettre à jour la version bêta un jour, créer une version par étapes en &production un autre jour, etc.

Ouvrez une nouvelle modification, comme décrit dans la section Modifier le workflow.
Appelez la méthode Edits.apks: upload pour chaque APK que vous souhaitez importer. Transmettez l'APK dans le corps de la requête de la méthode. (L'APK se trouve ainsi dans une zone de stockage, mais ne le publie pas sur un canal ni ne le déploie.) La méthode renvoie un code de version pour chaque APK que vous importez. Ce code de version vous permettra de faire référence à l'APK lorsque vous le publierez sur un canal.
Appelez la méthode Edits.tracks: update pour chaque canal sur lequel vous souhaitez publier des APK. Dans le corps de la requête, transmettez une ressource Edits.tracks contenant la version que vous souhaitez déployer. Par exemple, pour publier un APK avec le code de version 88 :
```
{
"releases": [{
  "versionCodes": ["88"],
  "status": "completed"
}]
}
```
À ce stade, les utilisateurs n'ont toujours pas accès aux APK. Comme pour les autres modifications, celles-ci ne sont pas mises en ligne tant que vous ne les avez pas validées.
Appelez la méthode Edits: commit pour valider les modifications. Les utilisateurs de chaque niveau recevront la version mise à jour de l'APK. (Comme pour toutes les modifications, un délai de plusieurs heures peut être nécessaire pour qu'elles soient prises en compte.)

Déploiements par étapes

Lorsque vous souhaitez déployer progressivement une nouvelle version de votre APK, vous pouvez choisir de la publier en tant que version de "déploiement par étapes". Dans ce cas, Google Play la déploie automatiquement dans la fraction souhaitée des utilisateurs de l'application que vous spécifiez. Si le fichier APK de déploiement ne présente aucun problème (par exemple, un plantage), vous pouvez augmenter le nombre d'utilisateurs qui reçoivent cette version. Une fois que vous êtes prêt, vous pouvez déployer cet APK en tant que nouvelle version de production.

Cette section décrit les étapes à suivre pour effectuer le déploiement par étapes d'un APK, puis le promouvoir en production:

Créez une modification, comme décrit dans Modifier le workflow.
Importez un nouveau fichier APK dans la modification à l'aide de la méthode Edits.apks: upload.
Démarrez une version par étapes "inProgress" sur le canal de production à l'aide de la méthode Edits.tracks: update. Choisissez la fraction des utilisateurs qui recevront le nouvel APK. À ce stade, l'APK n'est toujours disponible pour aucun utilisateur final.
```
{
"releases": [{
  "versionCodes": ["99"],
  "userFraction": 0.05,
  "status": "inProgress"
}]
}
```
Validez les modifications dans la modification active en appelant Edits: commit. Au cours des prochaines heures, le nouveau fichier APK sera déployé auprès des utilisateurs. La fraction d'utilisateurs que vous sélectionnez recevra le nouveau fichier APK.

En fonction du succès du déploiement par étapes, vous pouvez augmenter le pourcentage d'utilisateurs éligibles à cette version ou interrompre la release.

Augmenter la fraction d'utilisateurs pour un déploiement par étapes

En supposant que vous effectuiez un déploiement par étapes de 5%, comme décrit dans la section précédente, cette section explique comment augmenter le pourcentage dans le cas où la release se déroule comme suit:

Créez une modification, comme décrit dans Modifier le workflow.
Modifiez la version par étapes "inProgress" sur le canal de production à l'aide de la méthode Edits.tracks: update. Augmenter le nombre d'utilisateurs devant recevoir le nouveau fichier APK :
```
{
"releases": [{
  "versionCodes": ["99"],
  "userFraction": 0.1,
  "status": "inProgress"
}]
}
```
Validez les modifications dans la modification active en appelant Edits: commit. Au cours des prochaines heures, le nouveau fichier APK sera déployé auprès des utilisateurs. La fraction d'utilisateurs que vous sélectionnez recevra le nouveau fichier APK.

Interrompre un déploiement par étapes

En supposant que vous ayez un déploiement par étapes en cours d'exécution à 5%, comme décrit dans la section précédente, cette section décrit comment interrompre le déploiement par étapes si vous découvrez un problème:

Créez une modification, comme décrit dans Modifier le workflow.
Modifiez la version par étapes "inProgress" sur le canal de production à l'aide de la méthode Edits.tracks: update. Définissez l'état sur "halted".
```
{
"releases": [{
  "versionCodes": ["99"],
  "status": "halted"
}]
}
```
Validez les modifications dans la modification active en appelant Edits: commit. Votre release ne sera plus disponible pour les nouveaux utilisateurs.

Si vous décidez par la suite de reprendre une version interrompue, vous pouvez redéfinir son état sur "inProgress".

Effectuer un déploiement par étapes

Une fois que vous êtes satisfait de votre déploiement par étapes et que vous souhaitez déployer la version auprès de l'ensemble des utilisateurs, vous pouvez définir l'état de la version sur "completed" :

Créez une modification, comme décrit dans Modifier le workflow.
Modifiez la version par étapes "inProgress" sur le canal de production à l'aide de la méthode Edits.tracks: update. Définissez l'état sur "halted".
```
{
"releases": [{
  "versionCodes": ["99"],
  "status": "completed"
}]
}
```
Validez les modifications dans la modification active en appelant Edits: commit. Au cours des prochaines heures, le nouveau fichier APK sera déployé auprès des utilisateurs. La fraction d'utilisateurs que vous sélectionnez recevra le nouveau fichier APK.

Versions brouillons

Les versions brouillons vous permettent d'importer automatiquement des APK et de créer une version via l'API, qui peut ensuite être déployée via la Google Play Console. Pour créer une version brouillon d'un canal:

Ouvrez une nouvelle modification, comme décrit dans la section Modifier le workflow.
Appelez la méthode Edits.apks: upload pour chaque APK que vous souhaitez importer. Transmettez l'APK dans le corps de la requête de la méthode. La méthode renvoie un code de version pour chaque APK que vous importez. Ce code de version vous permettra de faire référence à l'APK lorsque vous l'attribuerez à une version.
Appelez la méthode Edits.tracks: update pour chaque titre que vous souhaitez publier. Dans le corps de la requête, transmettez une ressource Edits.tracks contenant le brouillon de la version que vous souhaitez créer. Par exemple,
```
{
"releases": [{
  "name": "My draft release",
  "versionCodes": ["88"],
  "status": "draft"
}]
}
```
.
Appelez la méthode Edits: commit pour valider les modifications. Vous pouvez maintenant inspecter votre version brouillon et la déployer via la Google Play Console ou l'API.

Spécifier les notes de version

Lorsque vous publiez une nouvelle version de votre application, vous pouvez présenter les nouveautés aux utilisateurs en spécifiant des notes de version.

Pour ce faire, utilisez le champ "releaseNotes" lorsque vous fournissez une ressource Edits.tracks à la méthode Edits.tracks: update.

{
  "releases": [{
      "name": "Release with notes",
      "versionCodes": ["88"],
      "status": "completed",
      "releaseNotes": [
        {"language": "en-US", "text": "Describe what's new in this release."}
      ]
  }]
}