ActionPackage에는 앱 초안과 배포된 각 버전의 콘텐츠가 포함됩니다. 여기에는 디렉터리 등록정보 세부정보, 대화 구성, 계정 연결이 포함됩니다.
JSON 표현 | |
---|---|
{ "manifest": { object ( |
필드 | |
---|---|
manifest |
앱의 세부정보입니다. 여기에는 디렉터리 목록 및 displayName과 같은 기타 앱 ID가 보관됩니다. |
accountLinking |
이 앱의 계정 연결에 대한 세부정보입니다. |
actions[] |
앱에서 처리할 수 있는 작업 목록입니다. |
types[] |
개발자가 정의한 유형 목록입니다. |
conversations |
|
locale |
이 작업 패키지의 언어입니다. 이는 'en', 'en-US', 'fr', 'fr-CA', 'sr-Latn', 'zh-Hans', 'zh-Hans-CN', 'zh-Hant', 'zh-Hant-HK' 등의 BCP-47 언어 문자열로 표현됩니다. 앱이 둘 이상의 언어를 지원하는 경우 필요합니다. 지원되는 언어마다 자체 ActionPackage가 있습니다. 값을 제공하지 않으면 에이전트의 기본 언어가 함축됩니다. |
매니페스트
앱의 메타데이터 집합입니다. 이 메시지의 콘텐츠는 여러 컨텍스트에서 사용됩니다.
- Google 디렉터리 등록정보 페이지의 작업
- 명시적 호출을 위한 앱의 고유 ID (
displayName
) 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 ( |
필드 | |
---|---|
displayName |
이 앱의 기본 표시 이름(번역이 없는 경우)입니다(예: 'Starbucks'). 사용자가 |
invocationName |
음성 (음성) 컨텍스트 내에서 직접 호출하는 이 앱의 고유한 이름입니다. 정책에 따라 호출 이름은 음성상으로 |
enabledRegions[] |
사용자의 위치를 기반으로 앱이 허용되는 지역의 애드워즈 기준 ID입니다. 참조: https://developers.google.com/adwords/api/docs/appendix/geotargeting |
disabledRegions[] |
사용자의 위치에 따라 앱이 차단된 지역의 애드워즈 기준 ID. 참조: https://developers.google.com/adwords/api/docs/appendix/geotargeting |
shortDescription |
앱에 대한 간단한 기본 설명 (번역이 없는 경우)입니다. 80자(영문 기준)로 제한됩니다. |
longDescription |
앱에 대한 자세한 기본 설명 (번역이 없는 경우)입니다. 4,000자(영문 기준)로 제한됩니다. |
category |
앱의 카테고리입니다. 값은 앱에 허용되는 카테고리 중 하나여야 합니다. 허용되는 카테고리 목록은 Google 콘솔의 작업을 참고하세요. |
smallSquareLogoUrl |
작은 정사각형 이미지 크기는 192x192픽셀이어야 합니다. |
largeLandscapeLogoUrl |
큰 가로 모드 이미지입니다. 크기는 2208x1242픽셀입니다. |
companyName |
앱과 연결된 회사의 이름입니다. |
contactEmail |
사용자가 앱과 관련하여 문의할 수 있는 연락처 이메일 주소입니다. |
termsOfServiceUrl |
앱의 서비스 약관 (ToS)으로 연결되는 URL입니다. |
privacyUrl |
앱의 개인정보처리방침 URL입니다. |
sampleInvocation[] |
샘플 호출 구문은 모든 앱의 디렉터리에 앱 설명의 일부로 표시됩니다. 값은 5개만 입력할 수 있습니다. |
introduction |
앱이 할 수 있는 작업을 요약합니다. 사용자에게 앱을 소개하는 데 사용됩니다. '이 앱을 사용하여...'과 같은 문장을 완성하는 동사구여야 합니다. |
testingInstructions |
앱 검토자를 위한 자유 형식 테스트 안내입니다. |
voiceName |
사용할 음성 이름입니다. 지원되는 값 예시: |
externalVoiceName |
이 에이전트의 외부 음성 이름입니다. 언어 정보를 포함하지 않습니다. |
voiceLocale |
이 에이전트의 음성 언어입니다. 빈 문자열로 설정하면 런타임 시 사용자의 언어로 확인됩니다. |
surfaceRequirements |
앱이 트리거되려면 충족해야 하는 Google 어시스턴트 클라이언트 표시 경로의 요구사항 모음입니다. |
SurfaceRequirements
에이전트가 트리거되기 위해 충족해야 하는 클라이언트 표시 경로에 관한 일련의 요구사항이 포함되어 있습니다. 여기에 나열된 요구사항이 충족되지 않으면 에이전트가 트리거되지 않습니다.
JSON 표현 | |
---|---|
{
"minimumCapabilities": [
{
object ( |
필드 | |
---|---|
minimumCapabilities[] |
에이전트가 작동하는 데 필요한 최소한의 역량 집합입니다. 노출 영역에 이 중 하나라도 없으면 상담사가 트리거되지 않습니다. |
기능
지정된 기능의 가용성에 대한 요구사항을 나타냅니다.
JSON 표현 | |
---|---|
{ "name": string } |
필드 | |
---|---|
name |
기능 이름입니다(예: actions.capability.AUDIO_OUTPUT). |
유형
작업 내에서 참조할 수 있는 유형입니다. 액션별로 고유한 맞춤 유형일 수도 있고, Google에서 정의하고 액션 내에서 참조되는 공통 유형일 수도 있습니다.
JSON 표현 | |
---|---|
{
"name": string,
"entities": [
{
object ( |
필드 | |
---|---|
name |
커스텀 유형의 이름으로, |
entities[] |
이 유형의 항목 목록입니다. 각각에는 키와 동의어 목록이 포함됩니다. |
isUserDefined |
항목이 사용자 정의되었는지 여부 (사용자마다 다름) |
항목
각 항목은 이 유형에 대해 고유합니다. 키가 고유해야 하며 트리거에 동의어 목록이 사용됩니다.
JSON 표현 | |
---|---|
{ "key": string, "synonyms": [ string ] } |
필드 | |
---|---|
key |
이 항목의 고유 키입니다. |
synonyms[] |
이 항목을 참조하는 데 사용할 수 있는 동의어 목록입니다. |