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'입니다. 작업 패키지는 하나 이상의 작업을 선언해야 합니다.

fulfillment

object (Fulfillment)

이 작업을 실행하는 방법입니다.

intent

object (Intent)

이 작업이 처리하는 인텐트입니다. 일반적인 Action on Google 인텐트의 이름은 'actions'로 시작합니다. 대화형 에이전트용 작업 패키지에는 이름이 'actions.intent.MAIN'인 인텐트가 있어야 합니다. https://developers.google.com/actions/reference/rest/intents를 참고하세요.

description

string

작업의 기능을 설명하는 영어 설명입니다. 주로 Google에서 작업을 검토하거나 디버깅할 때 사용됩니다. 이 설명은 사용자에게 표시되지 않습니다. ASCII 문자 100자 미만이어야 합니다.

signInRequired

boolean

이 작업에 로그인이 필요한지 여부를 나타냅니다. 이는 ActionPackage 객체에 AccountLinking 속성이 지정된 경우에만 유효합니다.

source
(deprecated)

string

이 작업을 만든 도구의 문자열 식별자입니다.

주문 처리

작업을 실행하는 방법

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

이 필드는 대화상자 흐름 처리의 사용 여부를 나타냅니다.

인텐트

사용자의 쿼리를 일치시키는 데 사용되는 인텐트 및 관련 쿼리 패턴 초기 트리거에 사용됩니다.

JSON 표현
{
  "name": string,
  "parameters": [
    {
      object (Parameter)
    }
  ],
  "trigger": {
    object (Trigger)
  }
}
필드
name

string

이 인텐트의 이름을 나타냅니다. 예: BOOK_A_TABLE. actions.로 시작하는 내장 인텐트일 수 있습니다. 이 경우 매개변수와 쿼리 패턴이 암시적으로 사용되므로 무시됩니다.

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

지정된 인텐트를 식별하는 데 사용되는 패턴 목록입니다. 쿼리 패턴은 매개변수 필드에 선언된 매개변수만 참조해야 합니다.