ActionPackage

ActionPackage에는 앱 초안 및 각 배포된 버전의 콘텐츠가 포함됩니다. 여기에는 디렉터리 목록 세부정보, 대화 구성, 계정 연결이 포함됩니다.

JSON 표현 
{
  "manifest": {
    object (Manifest)
  },
  "accountLinking": {
    object (AccountLinking)
  },
  "actions": [
    {
      object (Action)
    }
  ],
  "types": [
    {
      object (Type)
    }
  ],
  "conversations": {
    string: {
      object(ConversationFulfillment)
    },
    ...
  },
  "locale": string
}
필드
manifest

object (Manifest)

앱의 세부정보입니다. 여기에 디렉터리 목록은 물론 다른 앱 식별(예: displayName)이 보관됩니다.
accountLinking

object (AccountLinking)

이 앱의 계정 연결에 대한 세부정보입니다.
actions[]

object (Action)

앱이 처리할 수 있는 작업의 목록입니다.
types[]

object (Type)

개발자가 정의한 유형 목록입니다.
conversations

map (key: string, value: object (ConversationFulfillment))

actions에서 공유할 수 있는 대화를 매핑합니다. 예를 들어 Fulfillment의 conversationName를 참고하세요.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
locale

string

이 작업 패키지의 언어입니다. 'en', 'en-US', 'fr', 'fr-CA', 'sr-Latn', 'zh-Hans', 'zh-Hans-CN', 'zh-Hant', 'zh-Hant-HK'와 같은 BCP-47 언어 문자열로 표현됩니다. 이는 앱이 두 개 이상의 언어를 지원하는 경우 필요합니다. 지원되는 언어마다 자체 ActionPackage가 있습니다. 값을 입력하지 않으면 에이전트의 기본 언어가 암시됩니다.

매니페스트

앱의 메타데이터 집합입니다. 이 메시지의 내용은 여러 컨텍스트에서 사용됩니다.

  1. Google 디렉터리 목록 페이지의 작업
  2. 명시적 호출을 위한 앱의 고유 ID입니다 (displayName).
  3. ActionPackage의 다른 부분에 관한 콘텐츠 (shortDescription는 AccountLinking에 표시하는 데 사용되고, displayName는 actions에서 사용자에게 앱 이름을 표시하는 데 사용됨)

이 메시지는 읽기 전용입니다. 이 메시지의 필드는 작업 패키지가 아닌 작업 콘솔을 통해 지정합니다.

JSON 표현 
{
  "displayName": string,
  "invocationName": string,
  "enabledRegions": [
    string
  ],
  "disabledRegions": [
    string
  ],
  "shortDescription": string,
  "longDescription": string,
  "category": string,
  "smallSquareLogoUrl": string,
  "largeLandscapeLogoUrl": string,
  "companyName": string,
  "contactEmail": string,
  "termsOfServiceUrl": string,
  "privacyUrl": string,
  "sampleInvocation": [
    string
  ],
  "introduction": string,
  "testingInstructions": string,
  "voiceName": string,
  "externalVoiceName": string,
  "voiceLocale": string,
  "surfaceRequirements": {
    object (SurfaceRequirements)
  }
}
필드
displayName

string

번역 기능이 없는 경우 이 앱의 기본 표시 이름입니다. 예: "스타벅스". 사용자가 invocationName 외에 이 앱을 호출하는 방법으로도 사용됩니다. 표시 이름은 고유해야 하며 소리나는 대로 invocationName와 매우 유사해야 합니다.
invocationName

string

앱이 음성 (음성) 컨텍스트 내에서 직접 호출할 수 있는 고유 이름입니다. 정책에 따라 호출 이름은 음성학적으로 displayName 필드와 매우 유사해야 합니다.
enabledRegions[]

string (int64 format)

사용자의 현재 위치를 기준으로 앱이 허용되는 지역의 애드워즈 기준 ID입니다. https://developers.google.com/adwords/api/docs/appendix/geotargeting 페이지를 참조하세요.
disabledRegions[]

string (int64 format)

사용자의 현재 위치를 기준으로 앱이 차단된 지역의 애드워즈 기준 ID https://developers.google.com/adwords/api/docs/appendix/geotargeting 페이지를 참조하세요.
shortDescription

string

앱에 대한 간단한 기본 설명 (번역이 없는 경우)입니다. 80자(영문 기준)로 제한됩니다.
longDescription

string

앱에 대한 자세한 상세 설명 (번역이 없는 경우)입니다. 4,000자(영문 기준)로 제한됩니다.
category

string

앱의 카테고리입니다. 값은 앱에 허용되는 카테고리 중 하나여야 합니다. 허용되는 카테고리 목록은 Google 콘솔의 작업을 참고하세요.
smallSquareLogoUrl

string

작은 정사각형 이미지입니다. 크기는 192x192픽셀이어야 합니다.
largeLandscapeLogoUrl

string

큰 가로 모드 이미지입니다. 크기는 2208x1242픽셀이어야 합니다.
companyName

string

앱과 관련된 회사의 이름입니다.
contactEmail

string

사용자가 앱과 관련하여 문의할 수 있는 연락처 이메일 주소입니다.
termsOfServiceUrl

string

앱의 서비스 약관 (ToS)으로 연결되는 URL입니다.
privacyUrl

string

앱의 개인정보처리방침으로 연결되는 URL입니다.
sampleInvocation[]

string

모든 앱 디렉터리에서 앱 설명의 일부로 표시되는 샘플 호출 문구입니다. 5개의 값만 지정할 수 있습니다.
introduction

string

앱이 할 수 있는 작업의 요약입니다. 사용자에게 앱을 소개하는 데 사용됩니다. '이 앱을 사용하여...'과 같은 문장을 완성하는 동사구여야 합니다.
testingInstructions

string

앱 검토자를 위한 자유 형식 테스트 안내입니다.
voiceName

string

사용할 음성 이름입니다. 지원되는 값 예시: male_1, male_2, female_1, female_2
externalVoiceName

string

이 에이전트의 외부 음성 이름입니다. 언어 정보는 포함하지 않습니다.
voiceLocale

string

이 에이전트의 음성 언어입니다. 빈 문자열로 설정하면 런타임 시 사용자의 언어로 확인됩니다.
surfaceRequirements

object (SurfaceRequirements)

앱을 트리거하기 위해 충족해야 하는 Google 어시스턴트 클라이언트 표시 경로 관련 요구사항 모음입니다.

SurfaceRequirements

에이전트가 트리거되기 위해 충족해야 하는 클라이언트 노출 영역의 요구사항이 포함되어 있습니다. 여기에 나열된 요구사항이 충족되지 않으면 상담사가 트리거되지 않습니다.

JSON 표현 
{
  "minimumCapabilities": [
    {
      object (Capability)
    }
  ]
}
필드
minimumCapabilities[]

object (Capability)

에이전트가 작동하는 데 필요한 최소한의 기능 집합입니다. 노출 영역에 이러한 항목이 누락된 경우 상담사가 트리거되지 않습니다.

역량

특정 기능의 가용성에 대한 요구사항을 나타냅니다.

JSON 표현 
{
  "name": string
}
필드
name

string

기능의 이름입니다. 예: actions.capability.AUDIO_OUTPUT

유형

Action 내에서 참조할 수 있는 유형입니다. 작업 고유의 맞춤 유형일 수도 있고, Google에서 정의하고 작업 내에서 참조되는 일반 유형일 수도 있습니다.

JSON 표현 
{
  "name": string,
  "entities": [
    {
      object (Entity)
    }
  ],
  "isUserDefined": boolean
}
필드
name

string

type 형식의 커스텀 유형 이름입니다.
entities[]
(deprecated)

object (Entity)

이 유형의 항목 목록입니다. 각 항목에는 키와 동의어 목록이 포함됩니다.
isUserDefined

boolean

항목이 사용자 정의인지 여부 (사용자마다 다름)

항목

각 항목은 이 유형에 대해 고유합니다. 키는 고유해야 하며 동의어 목록이 트리거에 사용됩니다.

JSON 표현 
{
  "key": string,
  "synonyms": [
    string
  ]
}
필드
key

string

이 항목의 고유 키입니다.
synonyms[]

string

이 항목을 참조하는 데 사용할 수 있는 동의어 목록입니다.