ヘルスチェック

Google は、デプロイされたアクションをモニタリングし、アクションが使用可能であることと、ユーザーのリクエストに応答していることを確認します。

各アクションのエンドポイントは、パラメータ呼び出しのないデフォルトの呼び出しに応答する必要があります。これは、ユーザーが追加情報を提供せずにアクションとの会話を求めるシナリオをサポートします(たとえば、「呼び出し名と話したい」など)。

よくある質問

ヘルスチェックをサポートするために固有のものを実装する必要がありますか?

いいえ。アクションのヘルスチェックは、アクションとやり取りするための標準的なリクエストと同じように機能します。

アクションのヘルスチェックはどのくらいの頻度で行われますか?

アクションは 1 日中モニタリングされる場合があります。

リクエストがヘルスチェックであることを検出するには、どうすればよいですか?

開発プラットフォームとして Actions Builder を使用している場合、次のようなヘルスチェック リクエストが送信されます。

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

このリクエストを受け取った場合は、200 レスポンス コードを返す必要があります。それ以外の場合は、アクションは異常とみなされます。次のスニペットは、適切にフォーマットされたレスポンスの例です。

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

開発プラットフォームとして Dialogflow を使用している場合は、"is_health_check" 引数が追加され、インテントに渡されます。この引数は、Webhook リクエストの Input オブジェクト内にあります。

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

Google が正常でないアクションを検出するとどうなりますか? アクションが停止していることを Google が検出すると、アクションは一時停止されます。異常なアクションをリクエストしたユーザーには、「ACTION_NAME is not available」と読み上げられます。

アクションが異常としてマークされた場合、どのように通知されますか? Google は正常でないアクションを検出すると、Actions プロジェクトに関連付けられているメイン デベロッパーに通知メールを送信します。

アカウントのリンクを使用するアクションが異常としてマークされるとどうなりますか? 他のアクションとは異なり、アカウント リンクを使用するアクションは、Google が異常と宣言しても一時停止されません。ユーザーは、通知メールを受け取ってから 7 日間はアクションにアクセスできます。ただし、7 日以内にアカウントのリンクの問題を修正しなかった場合、アクションは削除されます。

アクションのヘルス ステータスを確認するにはどうすればよいですか? デベロッパー コンソールでアクションのステータスを確認できます。異常なアクションはステータスが「異常」になります。正常なアクションは「デプロイ済み」とマークされます。

アクションをデプロイ済み状態に戻すプロセスについて教えてください。デプロイメントを確認して、アクションが起動インテントに応答しない原因となる可能性のある問題に対処する必要があります。

アクションが正常でない場合でも、Google は定期的に定期的にアクションのヘルスをモニタリングします。アクションが期待どおりに応答していることを Google が検出すると、アクションはデプロイ済み状態に戻ります。