Annuler votre action

En testant votre action auprès des utilisateurs, vous pouvez recevoir des commentaires à l'avance et résoudre les problèmes techniques ou d'expérience utilisateur avant de la publier à grande échelle.

La console Actions est compatible avec les environnements de publication. Vous pouvez ainsi accorder à un nombre limité d'utilisateurs un accès pour tester une nouvelle action ou une version plus récente de votre action existante, avant de la déployer en mode public.

Cycle de vie d'une release

Le schéma suivant illustre les chemins potentiels que peut emprunter le cycle de vie d'une action:

Figure 1. Cycle de vie d'une action avec les environnements de publication

La console Actions est compatible avec deux types d'environnements de préproduction:

• Alpha: utilisez ce canal pour tester rapidement les premières versions de votre action.

  • Vous permet de distribuer votre action à un petit groupe d'utilisateurs sans avoir à effectuer un examen complet de Google.
  • Les utilisateurs reçoivent des avertissements indiquant que l'action n'a pas été examinée par Google pour vérifier qu'elle respecte les règles.
  • Idéal pour les tests internes.

• Bêta: cette chaîne vous permet de distribuer une action à un nombre limité d'utilisateurs après avoir passé un examen Google complet.

  • Ce canal doit permettre aux utilisateurs externes à votre organisation d'accéder aux versions préliminaires de l'action.
  • Les utilisateurs seront informés que l'action est une version preview.
  • La version bêta ayant été examinée par Google, vous pouvez la rendre publique à tout moment sans que Google ait besoin de l'examiner de nouveau.

Remarque :Vous ne pouvez publier qu'une seule version alpha ou bêta "en direct" de votre action.

Comparaison des environnements de publication

Le tableau ci-dessous récapitule les différences entre les canaux de déploiement.

	Simulateur	Alpha	Bêta	Production
Audience visée	Développeur uniquement	Premiers testeurs de votre équipe, de vos amis et de votre famille	Testeurs externes à votre équipe	Tous les utilisateurs de l'Assistant Google
Examen Google obligatoire	Non	Non	Oui	Oui
Autorisations d'accès	Développeur uniquement	Liste d'utilisateurs définie par le développeur. Les utilisateurs doivent activer cette option.	Liste d'utilisateurs définie par le développeur. Les utilisateurs doivent activer cette option.	Disponible publiquement pour tous les utilisateurs de l'Assistant Google
Nombre maximal d'utilisateurs	1	20	200	N/A
Pays dans lesquels l'assistant Wi-Fi est disponible	Simulateur et tous les appareils dotés de l'Assistant	Tous les appareils dotés de l'Assistant	Tous les appareils dotés de l'Assistant	Tous les appareils dotés de l'Assistant
Actions Builder	Compatible	Compatible	Compatible	Oui
SDK Actions	Compatible	Compatible	Compatible	Oui
Dialogflow	Compatible	Compatible	Compatible	Oui
Maison connectée	Compatible (nécessite l'association de comptes)	Non compatible	Non compatible	Oui
Modèles	Compatible	Incompatible	Non compatible	Oui
Appel explicite	Compatible	Compatible	Compatible	Oui
appel implicite	Compatible	Compatible	Compatible	Oui
Associer des comptes	Compatible	Compatible	Compatible	Oui

Remarque :Si vous utilisez la gestion des versions de Dialogflow, vous pouvez déployer différentes versions dans différents environnements de publication. Pour en savoir plus, consultez Envoyer votre projet.

Gérer les tests des versions alpha ou bêta

Pour configurer vos tests pour les versions alpha ou bêta, procédez comme suit:

1. Cliquez sur Gérer les testeurs alpha ou sur Gérer les testeurs bêta.

2. Saisissez les adresses e-mail des testeurs, séparées par une virgule. Vous pouvez spécifier jusqu'à 20 testeurs alpha et jusqu'à 200 testeurs bêta.

   Remarque :Les testeurs doivent disposer d'un compte Google (@gmail.com) ou Google Workspace. Vous ne pouvez pas désigner plusieurs utilisateurs via un alias d'adresse e-mail de groupe Google.

   

3. Copiez le lien d'activation à partager avec vos testeurs.

4. Cliquez sur Enregistrer.

Vous devez envoyer un e-mail d'invitation à vos testeurs avec un lien vers la version alpha ou bêta de votre action (le lien d'activation). Pour en savoir plus, consultez Obtenir des commentaires.

Lien d'activation

Le lien d'activation représente la page de votre annuaire d'actions et ne change jamais. Le lien redirige les testeurs vers votre page d'annuaire, puis affiche la fiche d'activation correspondant à l'environnement éligible. Si vous avez répertorié les mêmes testeurs pour la version alpha et bêta, ils sont éligibles pour les deux, et une fiche d'activation apparaît d'abord pour la version alpha.

Implémenter le traitement pour une version alpha ou bêta

Les informations sur la version disponible ne sont pas incluses dans la requête HTTP envoyée à l'Assistant à votre traitement. Pour gérer les versions disponibles dans votre traitement, vous devez fournir différentes URL de traitement (par exemple, une URL pour la version bêta et une autre pour la version de production de votre action).

Obtenez des retours

Une fois que votre action a été publiée sur la version alpha ou bêta, vous devez inviter vos testeurs en partageant votre lien d'activation (identique à celui de l'annuaire de vos assistants).

Veillez à indiquer à vos testeurs qu'ils doivent:

• Téléchargez l'application Assistant Google sur leurs appareils mobiles pour effectuer des tests alpha ou bêta.
• Connectez-vous à l'application Assistant Google avec le compte que vous avez désigné comme testeur alpha ou bêta.

Une fois votre action déployée, les nouveaux testeurs doivent attendre au moins trois heures avant de pouvoir accéder à l'action à l'aide du lien d'activation.

Lorsque les utilisateurs cliquent sur ce lien, ils sont redirigés vers la page d'annuaire de l'action correspondante. Il doit cliquer sur le bouton J'accepte en bas de la page du répertoire des actions pour participer en tant que testeur pour la première fois.

Une fois que le testeur a activé cette option sur son téléphone, votre action est immédiatement disponible sur tous ses appareils. Pour les testeurs, votre action apparaît dans la section Mes applications de l'application Assistant Google et présente l'un des modes suivants: Alpha, Bêta ou Aucun test. L'option Aucun test permet de diffuser auprès des utilisateurs la version de production de votre action, si elle est disponible. Si aucune version de production n'est disponible, aucune version de production ne sera diffusée.

Remarque :Les utilisateurs ne peuvent pas évaluer votre action dans l'application Assistant Google s'ils utilisent des versions alpha ou bêta. Vous devez plutôt fournir aux testeurs un moyen de donner leur avis par e-mail, via un site Web, dans un forum ou via un autre mécanisme approprié.

Bonnes pratiques

• Assurez-vous que les utilisateurs peuvent participer aux tests. Pour participer à un test, vos testeurs doivent disposer d'un compte Google (@gmail.com) ou G Suite.
• Choisissez le type de test approprié. Un groupe de test alpha doit être petit et tester les versions expérimentales les moins stables de vos actions (par exemple, au sein de votre entreprise ou de votre équipe). Utilisez des tests bêta auprès d'un groupe d'utilisateurs plus important pour tester les versions stables de vos actions qui sont presque proches du lancement.
• Ajoutez un canal permettant aux testeurs de vous envoyer des commentaires. Les versions alpha et bêta ne sont disponibles que pour vos testeurs. Assurez-vous qu'ils ont la possibilité de donner leur avis par e-mail, via un site Web, sur un forum ou via un autre mécanisme approprié.
• Exécutez des tests simultanés sur la même action. Vous pouvez exécuter des tests alpha et bêta en même temps.

Problèmes connus

• L'annuaire de l'Assistant pour le Web n'est pas compatible avec les versions alpha ou bêta. Assurez-vous que vos testeurs suivent le lien sur leur appareil mobile (Android ou iOS).
• La prise en compte des modifications peut prendre quelques heures. Veuillez patienter quelque temps avant de partager le lien d'activation avec vos utilisateurs.

Créer une version alpha ou bêta

Pour déployer votre version d'action sur la version alpha ou bêta, procédez comme suit:

1. Dans la console Actions, cliquez sur Déployer > Publier.

2. Cliquez sur Lancer une nouvelle release.

   

3. Sélectionnez Alpha ou Bêta, puis cliquez sur Envoyer.

4. Si vous y êtes invité, indiquez que vous avez effectué les étapes requises dans la checklist Action requise.

5. Le cas échéant, sélectionnez les langues dans lesquelles votre release sera disponible.

6. Cliquez sur Envoyer.

Une fois la version alpha ou bêta envoyée, elle apparaît dans la section Gérer les versions.

Remarque :Après un déploiement, la version sera à l'état Déploiement pendant trois heures maximum avant d'être disponible pour les utilisateurs. Une fois le déploiement terminé, les autres versions actives de cet environnement sont supprimées.

Remarque :Si vous êtes un développeur du projet, la version de test est activée par défaut sur votre appareil. Si vous souhaitez accéder aux versions alpha et bêta, désactivez l'option Tests sur l'appareil dans le simulateur de la console Actions.

Mettre à jour une version existante en version alpha ou bêta en production

Les versions de production peuvent être un déploiement complet pour tous les utilisateurs de l'Assistant Google, un déploiement par étapes dans des régions spécifiques ou un pourcentage d'utilisateurs. Les déploiements par étapes contribuent à tester la stabilité de votre projet d'action. Il est préférable de publier votre application auprès d'un petit groupe d'utilisateurs et d'augmenter progressivement jusqu'à atteindre 100% des utilisateurs. Cela vous permet de corriger les bugs avant de les déployer à toute la base d'utilisateurs.

Remarque :Que votre déploiement soit complet ou par étapes, votre action doit passer par un processus d'examen avant de pouvoir être déployée en production. Un seul examen est requis. Cependant, si votre action est modifiée, elle devra être réexaminée. Pour lancer l'examen, vous devez soumettre une nouvelle version de votre action en version bêta ou de production.

Déploiement par étapes

Les déploiements par étapes permettent aux développeurs de gérer leurs versions de production en les lançant auprès d'un sous-ensemble d'utilisateurs et en augmentant progressivement la capacité de l'application pour tous les utilisateurs. Vous pouvez augmenter progressivement le nombre de régions ou le pourcentage d'utilisateurs dans votre déploiement.

Remarque :Vous ne pouvez pas sélectionner un pourcentage d'utilisateurs dans une région sélectionnée. Vous ne pouvez pas changer de type de préproduction (localisation ou pourcentage d'utilisateurs) lorsque vous mettez à niveau une version en cours. Vous devez annuler la version et en démarrer une nouvelle si vous souhaitez modifier le type de préproduction. Il ne peut y avoir qu'une seule version active sur le canal de déploiement par étapes.

Pour déployer votre action par étapes:

1. Sous Gérer les versions, sélectionnez la version dont vous souhaitez passer au déploiement en production.
2. Cliquez sur Gérer les déploiements.
3. Sélectionnez Déployer en production.
4. Sélectionnez Déploiement par étapes.
5. Cliquez sur Sélectionner un type de déploiement.

6. Sélectionnez Zones géographiques spécifiées ou Pourcentage d'utilisateurs. Pour plus d'informations sur cette sélection, consultez Déployer en fonction des zones géographiques spécifiées ou Déployer en fonction du pourcentage de la base d'utilisateurs.

   

7. Cliquez sur Envoyer.

Pour avancer la phase de votre déploiement, consultez la section Avancer l'étape du déploiement d'une release.

Déploiement complet

Si vous sélectionnez cette option, votre projet d'action sera disponible pour tous les utilisateurs de tous les pays que vous ciblez.

Pour déployer votre action en tant que déploiement complet, procédez comme suit:

1. Sous Gérer les versions, sélectionnez la version dont vous souhaitez passer au déploiement en production.

2. Cliquez sur Gérer les déploiements.

   

3. Sélectionnez Déployer en production.

4. Sélectionnez Déploiement complet.

5. Cliquez sur Envoyer.

Créer une version de production sans test alpha ni bêta

Les versions de production peuvent être un déploiement complet pour tous les utilisateurs de l'Assistant Google, un déploiement par étapes dans des régions spécifiques ou un pourcentage d'utilisateurs. Les déploiements par étapes contribuent à tester la stabilité de votre projet d'action. Il est préférable de publier votre application auprès d'un petit groupe d'utilisateurs et d'augmenter progressivement jusqu'à atteindre 100% des utilisateurs. Cela vous permet de corriger les bugs avant de les déployer à toute la base d'utilisateurs.

Remarque :Que votre déploiement soit complet ou par étapes, votre action doit passer par un processus d'examen avant de pouvoir être déployée en production. Un seul examen est requis. Toutefois, si vous modifiez votre action et que vous la mettez en production, elle doit être réexaminée. Pour lancer l'examen, vous devez envoyer une nouvelle version de votre action (en version bêta ou de production).

Déploiement par étapes

Les déploiements par étapes permettent aux développeurs de gérer leurs versions de production en les lançant auprès d'un sous-ensemble d'utilisateurs et en augmentant progressivement la capacité de l'application pour tous les utilisateurs. Vous pouvez augmenter progressivement le nombre de régions ou le pourcentage d'utilisateurs dans votre déploiement.

Remarque :Vous ne pouvez pas sélectionner un pourcentage d'utilisateurs dans une région sélectionnée. Vous ne pouvez pas changer de type de préproduction (localisation ou pourcentage d'utilisateurs) lorsque vous mettez à niveau une version en cours. Vous devez annuler la version et en démarrer une nouvelle si vous souhaitez modifier le type de préproduction. Il ne peut y avoir qu'une seule version active sur le canal de déploiement par étapes.

Pour déployer votre action par étapes:

1. Dans la console Actions, cliquez sur Déployer > Publier.

2. Cliquez sur Lancer une nouvelle release.

   

3. Sélectionnez Production.

4. Si vous y êtes invité, indiquez que vous avez effectué les étapes requises dans la checklist Action requise.

5. Le cas échéant, sélectionnez les langues dans lesquelles votre release sera disponible.

6. Sélectionnez Déploiement par étapes.

7. Cliquez sur Sélectionner un type de déploiement.

8. Sélectionnez Zones géographiques spécifiées ou Pourcentage d'utilisateurs. Pour plus d'informations sur cette sélection, consultez Déployer en fonction des zones géographiques spécifiées ou Déployer en fonction du pourcentage de la base d'utilisateurs.

   

9. Cliquez sur Envoyer.

Déployer selon les zones géographiques spécifiées

Sélectionner cette option permet de publier votre projet d'action dans les pays ou régions de votre choix.

Pour déployer votre action par emplacement, procédez comme suit:

1. Cliquez sur Sélectionner des pays ou régions, puis cochez les cases correspondant aux régions à cibler pour votre release.

2. Cliquez sur Envoyer.

   Remarque :Seules les régions que vous avez sélectionnées dans le ciblage géographique sont autorisées.

Déploiement en pourcentage de la base d'utilisateurs

Cette option permet de libérer votre action pour un pourcentage d'utilisateurs sélectionnés au hasard.

Pour déployer votre action auprès d'un certain pourcentage d'utilisateurs, procédez comme suit:

1. Cliquez sur Pourcentage d'utilisateurs.

2. Sélectionnez le pourcentage d'utilisateurs auprès desquels vous souhaitez retirer votre action.

   

3. Cliquez sur Envoyer.

   Remarque :Vous pouvez annuler ce type de release en définissant le pourcentage sur 0%.

Déploiement complet

Si vous sélectionnez cette option, votre projet d'action sera disponible pour tous les utilisateurs de tous les pays que vous ciblez.

Pour déployer votre action en tant que déploiement complet, procédez comme suit:

1. Dans la console Actions, cliquez sur Déployer > Publier.

2. Cliquez sur Lancer une nouvelle release.

   

3. Sélectionnez Production.

4. Si vous y êtes invité, indiquez que vous avez effectué les étapes requises dans la checklist Action requise.

5. Le cas échéant, sélectionnez les langues dans lesquelles votre release sera disponible.

6. Sélectionnez Déploiement complet.

7. Cliquez sur Envoyer.

Une fois la version de production envoyée, elle apparaît dans la section Gérer les versions.

Remarque :Après un déploiement, l'état de la version est Déploiement pendant trois heures au maximum avant de le mettre à la disposition des utilisateurs. Une fois le déploiement terminé, les autres versions actives de cet environnement ne seront pas déployées automatiquement.

Modifier ou annuler le déploiement d'une version

Une fois que vous avez envoyé votre action à une version disponible, vous pouvez toujours apporter des modifications. Vous pouvez tester la version actuelle, retirer la version de l'examen, afficher les détails de la version, gérer les déploiements, annuler le déploiement et mettre à niveau les étapes de déploiement. Vous pouvez également consulter les informations sur les versions précédentes.

Afficher et modifier une version

Pour afficher les détails de la release ou la modifier, procédez comme suit:

1. Sous Gérer les versions, sélectionnez la version sous Nom de l'album.
2. Sélectionnez Modifier le déploiement, Gérer les déploiements ou En savoir plus.

Avancer la phase de déploiement d'une release

Pour avancer la phase de déploiement de votre action, procédez comme suit:

1. Sous Gérer les versions, sélectionnez la version à mettre à niveau.
2. Cliquez sur le bouton Modifier le déploiement.
3. Apportez les modifications requises à votre déploiement. Par exemple, vous pouvez faire passer la base d'utilisateurs de 5% à 20%.
4. Cliquez sur Envoyer.

Annuler le déploiement en production

• Si vous devez déployer votre déploiement par étapes hors connexion, cliquez sur Modifier le déploiement sous Gérer les versions. Vous pouvez effacer toutes les régions ou sélectionner 0%, selon que votre déploiement se fait par zone géographique ou pourcentage de base d'utilisateurs.
• Pour annuler le déploiement d'une action qui est entièrement déployée (100% de la base d'utilisateurs), cliquez sur le bouton Gérer les déploiements sous Gérer les versions, puis sélectionnez Annuler le déploiement en production.