ActionPackage 會保留應用程式草稿和每個已部署版本的內容。包括列出詳細資料、對話設定和帳戶連結。
JSON 表示法 | |
---|---|
{ "manifest": { object ( |
欄位 | |
---|---|
manifest |
應用程式的詳細資料。這裡會保留目錄清單及其他應用程式識別資訊,例如 displayName。 |
accountLinking |
這個應用程式中的帳戶連結詳細資料。 |
actions[] |
應用程式可處理的動作清單。 |
types[] |
開發人員定義的類型清單。 |
conversations |
可與 這個物件中包含 |
locale |
這個動作套件的語言代碼。以 BCP-47 語言字串表示,例如「en」、「en-US」、「fr」、「fr-CA」、「sr-Latn」、「zh-Hans」、「zh-Hans-CN」、「zh-Hant」、「zh-Hant-HK」等等。如果應用程式支援多種語言,就必須執行這項操作。每個支援的語言代碼都有專屬的 ActionPackage。如未提供值,系統會隱含代理程式的預設語言代碼。 |
資訊清單
應用程式的中繼資料集。這則訊息的內容可在多個情境中使用:
- 動作。
- 用於明確叫用的應用程式專屬識別 (
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[] |
根據使用者所在地,決定應用程式的 AdWords 條件 ID。詳情請參閱 https://developers.google.com/adwords/api/docs/appendix/geotargeting |
disabledRegions[] |
根據使用者所在地,禁止該區域的 AdWords 條件 ID。詳情請參閱 https://developers.google.com/adwords/api/docs/appendix/geotargeting |
shortDescription |
應用程式的預設簡短說明 (如果沒有翻譯的話)。字數上限為 80 個字元。 |
longDescription |
應用程式的預設詳細說明 (如果沒有翻譯)。字數上限為 4,000 個字元。 |
category |
應用程式的類別。值必須是應用程式允許使用的類別之一。如要查看允許類別清單,請前往 Google 控制台查看動作。 |
smallSquareLogoUrl |
小型正方形圖片。尺寸必須為 192 x 192 像素。 |
largeLandscapeLogoUrl |
大型橫向圖片。尺寸必須為 2208 x 1242 像素。 |
companyName |
與應用程式相關聯的公司名稱。 |
contactEmail |
讓使用者可以就應用程式相關問題聯絡的聯絡電子郵件地址。 |
termsOfServiceUrl |
應用程式的《服務條款》(服務條款) 網址。 |
privacyUrl |
應用程式的隱私權政策網址。 |
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[] |
可用來指稱這個項目的同義詞清單。 |