Action

アクションは、アクション プロジェクトがサポートする特定のインタラクションを表します。インタラクションは、シングルショットでも複数のステップでもかまいません。

JSON 表現
{
  "name": string,
  "fulfillment": {
    object (Fulfillment)
  },
  "intent": {
    object (Intent)
  },
  "description": string,
  "signInRequired": boolean,
  "source": string
}
フィールド
name

string

指定します。共通の Action on Google インテント(「actions.」で始まる)を使用している場合でも、名前を指定する必要があります。たとえば、「actions.intent.MAIN」インテントを使用している場合、アクション名は慣例的に「MAIN」です。アクション パッケージは、少なくとも 1 つのアクションを宣言する必要があります。

fulfillment

object (Fulfillment)

このアクションの実行方法。

intent

object (Intent)

このアクションが処理するインテント。一般的な Action on Google インテントの名前は「actions.」で始まります。会話エージェント用のアクション パッケージには、「actions.intent.MAIN」という名前のインテントが必要です。https://developers.google.com/actions/reference/rest/intents をご覧ください。

description

string

アクションの内容の英語の説明。これは主に、Google によるアクションの確認やデバッグに使用されます。この説明はユーザーには表示されません。100 文字未満の ASCII 文字列にする必要があります。

signInRequired

boolean

このアクションにログインが必要かどうかを示します。これは、ActionPackage オブジェクトに AccountLinking プロパティが指定されている場合にのみ有効です。

source
(deprecated)

string

このアクションを作成したツールの文字列 ID

フルフィルメント

アクションを実行する方法。

JSON 表現
{

  // Union field conversation can be only one of the following:
  "conversationName": string,
  "useDialogflowFulfillment": boolean
  // End of list of possible types for union field conversation.
}
フィールド

共用体フィールド conversation

conversation は次のいずれかになります。

conversationName

string

会話フルフィルメントを介してアクションを実行します。これは、ActionPackage.conversations フィールドの Conversations の「name」フィールドを参照します。

useDialogflowFulfillment

boolean

このフィールドは、Dialogflow フルフィルメントを使用するかどうかを示します。

インテント

ユーザークエリの照合に使用されるインテントとそれに関連付けられたクエリパターン。初期トリガーに使用されます。

JSON 表現
{
  "name": string,
  "parameters": [
    {
      object (Parameter)
    }
  ],
  "trigger": {
    object (Trigger)
  }
}
フィールド
name

string

このインテントの名前を示します。例:BOOK_A_TABLEactions. で始まる組み込みインテントを指定できます。その場合、パラメータとクエリパターンは暗黙的に指定されるため無視されます。

parameters[]

object (Parameter)

queryPatterns 内のパラメータのリスト。queryPatterns 内のすべてのパラメータを指定する必要があります。

trigger

object (Trigger)

このインテントのトリガーの仕様。

パラメータ

クエリパターン内で使用されるパラメータ。これは、queryPatterns のパラメータの構造化表現です(例: $Color:color)。

JSON 表現
{
  "name": string,
  "type": string
}
フィールド
name

string

パラメータの名前(例: color)。

type

string

パラメータの型です。一般的なタイプ、またはアクション パッケージの一部として宣言されたカスタムタイプを指定できます(例: Color)。

トリガー

トリガーの仕様。

JSON 表現
{
  "queryPatterns": [
    string
  ]
}
フィールド
queryPatterns[]

string

指定されたインテントの識別に使用されるパターンのリスト。クエリパターンは、parameters フィールドで宣言されたパラメータのみを参照する必要があります。