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과 같은 기타 앱 ID가 보관됩니다.
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

이 앱의 기본 표시 이름(번역이 없는 경우)입니다(예: 'Starbucks'). 사용자가 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).

유형

작업 내에서 참조할 수 있는 유형입니다. 액션별로 고유한 맞춤 유형일 수도 있고, 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

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