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

這個動作套件的語言代碼。以 BCP-47 語言字串表示，例如「en」、「en-US」、「fr」、「fr-CA」、「sr-Latn」、「zh-Hans」、「zh-Hans-CN」、「zh-Hant」、「zh-Hant-HK」等等。如果應用程式支援多種語言，就必須執行這項操作。每個支援的語言代碼都有專屬的 ActionPackage。如未提供值，系統會隱含代理程式的預設語言代碼。

資訊清單

應用程式的中繼資料集。這則訊息的內容可在多個情境中使用：

  1. 動作。
  2. 用於明確叫用的應用程式專屬識別 (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)

根據使用者所在地，決定應用程式的 AdWords 條件 ID。詳情請參閱 https://developers.google.com/adwords/api/docs/appendix/geotargeting
disabledRegions[]

string (int64 format)

根據使用者所在地，禁止該區域的 AdWords 條件 ID。詳情請參閱 https://developers.google.com/adwords/api/docs/appendix/geotargeting
shortDescription

string

應用程式的預設簡短說明 (如果沒有翻譯的話)。字數上限為 80 個字元。
longDescription

string

應用程式的預設詳細說明 (如果沒有翻譯)。字數上限為 4,000 個字元。
category

string

應用程式的類別。值必須是應用程式允許使用的類別之一。如要查看允許類別清單，請前往 Google 控制台查看動作。
smallSquareLogoUrl

string

小型正方形圖片。尺寸必須為 192 x 192 像素。
largeLandscapeLogoUrl

string

大型橫向圖片。尺寸必須為 2208 x 1242 像素。
companyName

string

與應用程式相關聯的公司名稱。
contactEmail

string

讓使用者可以就應用程式相關問題聯絡的聯絡電子郵件地址。
termsOfServiceUrl

string

應用程式的《服務條款》(服務條款) 網址。
privacyUrl

string

應用程式的隱私權政策網址。
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

可用來指稱這個項目的同義詞清單。