Vérifications d'état

Google surveille les actions déployées pour vérifier qu'elles sont disponibles et répondre aux requêtes des utilisateurs.

Le point de terminaison de chaque action est requis pour répondre à un appel par défaut sans paramètre. Cette approche est compatible avec le scénario dans lequel l'utilisateur demande à communiquer avec une action sans fournir d'informations supplémentaires (par exemple, "Je veux parler à nom d'appel").

Questions fréquentes

Dois-je implémenter quelque chose de spécifique pour assurer les vérifications d'état ?

Non. Les vérifications de l'état des actions fonctionnent comme une requête standard de communication avec une action.

À quelle fréquence l'état de mon action est-il vérifié ?

Votre action peut être surveillée tout au long de la journée.

Comment déterminer si une requête est une vérification d'état ?

Si vous utilisez Actions Builder comme plate-forme de développement, vous recevrez une requête de vérification de l'état semblable à l'extrait ci-dessous:

{
  "handler": {
    "name": "actions.handler.HEALTH_CHECK"
  },
  "intent": {
    "name": "actions.intent.HEALTH_CHECK"
  },
  "session": {
    "id": "actions.session.HEALTH_CHECK"
  },
  "user": {
    "locale":"en-US"
  },
  "device": {
    "capabilities": []
  }
}
  

Lorsque vous recevez cette requête, vous devez renvoyer un code de réponse 200. Sinon, votre action est considérée comme non opérationnelle. L'extrait de code suivant est un exemple de réponse correctement formatée:

  {"prompt":{"override":true,"firstSimple":{"speech":"ok","text":""}}}

Si vous utilisez Dialogflow comme plate-forme de développement, Google ajoute un argument "is_health_check" et le transmet à l'intent. Cet argument se trouve dans l'objet Input de la requête de webhook:

{
  ...
  "originalDetectIntentRequest": {
    ...
    "payload": {
      ...
      "inputs": [{
        ...
        "arguments": [{
          "name": "is_health_check",
          "boolValue": true,
          "textValue": "1"
        }]
      }],
      ...
    }
  }
}
  

Que se passe-t-il si Google détecte une action de mauvaise qualité ? Si Google détecte que l'action rencontre une panne, elle est suspendue. Les utilisateurs qui demandent l'action non opérationnelle entendront "ACTION_NAME is not available" (L'action "ACTION_NAME n'est pas disponible").

Comment serai-je informé si une action est marquée comme non opérationnelle ? Lorsque Google détecte une action non opérationnelle, nous envoyons un e-mail de notification au développeur principal associé au projet Actions.

Que se passe-t-il si mon action qui utilise l'association de comptes est marquée comme non opérationnelle ? Contrairement aux autres actions, les actions qui utilisent l'association de comptes ne sont pas suspendues une fois que Google les déclare non opérationnelles. Les utilisateurs peuvent toujours accéder à votre action pendant sept jours après la réception de l'e-mail de notification. Toutefois, si vous n'avez pas résolu le problème d'association de comptes au bout de sept jours, votre action sera supprimée.

Comment vérifier l'état de mon action ? Vous pouvez consulter l'état de votre action dans la Play Console. Les actions non opérationnelles sont associées à l'état Non opérationnelle. Les actions opérationnelles sont marquées comme Déployées.

Quel est le processus de retour d'une action à l'état déployé ? Vous devez examiner votre déploiement et résoudre les problèmes qui pourraient empêcher l'action de répondre à un intent de lancement.

Google continuera de surveiller régulièrement l'état de l'action tant qu'elle n'est pas opérationnelle. Lorsque Google détecte que l'action répond comme prévu, elle revient à l'état déployé.