Method: fulfill

{
  "name": string
}

string

選用設定。處理常式的名稱。

{
  "name": string,
  "params": {
    string: {
      object (IntentParameterValue)
    },
    ...
  },
  "query": string
}

string

必要欄位。最後一個相符意圖的名稱。

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

必要欄位。代表做為意圖比對的一部分參數。此為已識別參數的名稱與透過使用者輸入內容識別的參數值對應。這裡會顯示相符意圖中定義的所有參數。

這個物件中包含 "key": value 組合的清單，範例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。

string

選用設定。針對符合這項意圖的使用者輸入或口說的輸入內容。比對意圖時，系統會根據使用者輸入內容填入這項資訊。

{
  "original": string,
  "resolved": value
}

string

必要欄位。從使用者話語內容中擷取的原始文字值。

value (Value format)

必要欄位。從使用者輸入內容中擷取的參數結構化值。只有在相符意圖中定義了該參數，且意圖比對期間可識別該參數值時，系統才會填入資料。

{
  "name": string,
  "slotFillingStatus": enum (SlotFillingStatus),
  "slots": {
    string: {
      object (Slot)
    },
    ...
  },
  "next": {
    object (NextScene)
  }
}

string

必要欄位。目前場景的名稱。

enum (SlotFillingStatus)

必要欄位。運算單元填充的目前狀態。這是唯讀欄位。

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

與目前場景相關聯的版位。處理常式回應無法傳回未在要求中傳送的運算單元。

這個物件中包含 "key": value 組合的清單，範例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。

object (NextScene)

選用設定。接下來要執行的場景資訊。

{
  "mode": enum (SlotMode),
  "status": enum (SlotStatus),
  "value": value,
  "updated": boolean,
  "prompt": {
    object (Prompt)
  }
}

enum (SlotMode)

版位的模式 (必填或選填)。可由開發人員設定。

enum (SlotStatus)

時段的狀態。

value (Value format)

版位的值。如果變更回應中的這個值，系統就會修改運算單元填充中的值。

boolean

說明是否在上一個轉彎處收集運算單元值。這是唯讀欄位。

object (Prompt)

選用設定。系統會在需要填入所需版位時，向使用者傳送這則提示。這個提示會覆寫控制台中定義的現有提示。Webhook 要求不包含這個欄位。

{
  "override": boolean,
  "firstSimple": {
    object (Simple)
  },
  "content": {
    object (Content)
  },
  "lastSimple": {
    object (Simple)
  },
  "suggestions": [
    {
      object (Suggestion)
    }
  ],
  "link": {
    object (Link)
  },
  "canvas": {
    object (Canvas)
  },
  "orderUpdate": {
    object (OrderUpdate)
  }
}

boolean

選用設定。此訊息如何與先前定義的訊息合併的模式。「true」清除先前定義的所有訊息 (第一個和最後一個簡單訊息、內容、建議連結和畫布)，並新增這個提示中定義的訊息。「false」會將這個提示中定義的訊息加入先前的回應中定義的訊息。將這個欄位保留「false」也能在簡易提示、建議提示和畫布提示 (位於內容提示部分) 中附加某些欄位。如在提示中定義了「內容和連結」訊息，一律會遭到覆寫。預設值為「false」。

object (Simple)

選用設定。第一個語音和純文字回應。

object (Content)

選用設定。要向使用者顯示的資訊卡、清單或媒體等內容。

object (Simple)

選用設定。上次語音和純文字回應。

object (Suggestion)

選用設定。向使用者顯示的建議，這些建議一律會出現在回應結尾。如果「覆寫」含有「false」欄位的子標題欄位，那麼系統就會將這個欄位中定義的標題新增至任何先前定義的建議提示中定義的標題，且重複值也會遭到移除。

object (Link)

選用設定。其他建議方塊，可連結至相關應用程式或網站。這個方塊會顯示標題為「開啟 (名稱)」。最多 20 個半形字元。

object (Canvas)

選用設定。代表要傳送給使用者的互動式畫布回應。

object (OrderUpdate)

在交易流程中，選擇性動作會在收到訂單後回應 OrderUpdate。Google 會在收到該筆訂單後，將這項更新記錄至訂單；如果交易成功，Google 會在顯示裝置上顯示收據卡和已傳送的 TTS。

{
  "speech": string,
  "text": string
}

string

選用設定。代表要向使用者讀出的語音。可以是 SSML 或文字轉語音。如果「覆寫」欄位的值為「true」，那麼這個欄位中定義的語音會取代先前簡單提示的語音。詳情請參閱 https://developers.google.com/assistant/conversational/ssml。

string

選填的文字，會顯示在即時通訊泡泡中。如未指定，將顯示上方語音欄位的顯示內容。上限為 640 個半形字元。如果「覆寫」並在包含提示的欄位中將欄位設為「true」，則這個欄位中定義的文字會取代先前簡易提示的文字。

{

  // Union field content can be only one of the following:
  "card": {
    object (Card)
  },
  "image": {
    object (Image)
  },
  "table": {
    object (Table)
  },
  "media": {
    object (Media)
  },
  "collection": {
    object (Collection)
  },
  "list": {
    object (List)
  },
  "collectionBrowse": {
    object (CollectionBrowse)
  }
  // End of list of possible types for union field content.
}

object (Card)

基本資訊卡。

object (Image)

圖片。

object (Table)

表格資訊卡。

object (Media)

用於表示要播放的一組媒體的回應。

object (Collection)

顯示一系列選項的資訊卡。

object (List)

顯示選項清單的資訊卡。

object (CollectionBrowse)

資訊卡，顯示要開啟的一系列網頁。

{
  "title": string,
  "subtitle": string,
  "text": string,
  "image": {
    object (Image)
  },
  "imageFill": enum (ImageFill),
  "button": {
    object (Link)
  }
}

string

資訊卡的整體標題。選填。

string

選填。

string

資訊卡的內文。支援一組 Markdown 語法，以便用於格式設定。除非有圖片，否則此為必要屬性。

object (Image)

資訊卡的主頁橫幅。高度固定為 192dp。選填。

enum (ImageFill)

圖片背景的填滿方式。選填。

object (Link)

包含外連連結的按鈕。選填。

{
  "url": string,
  "alt": string,
  "height": integer,
  "width": integer
}

string

圖片的來源網址。圖片可以是 JPG、PNG 和 GIF (動畫及非動畫)。例如：https://www.agentx.com/logo.png。必填。

string

用於無障礙的圖片文字說明，例如例如螢幕閱讀器和螢幕閱讀器等必填。

integer

圖片的高度 (以像素為單位)。選填。

integer

圖片寬度 (以像素為單位)。選填。

{
  "name": string,
  "open": {
    object (OpenUrl)
  }
}

string

連結的名稱。最多 20 個半形字元。

object (OpenUrl)

使用者開啟連結後會發生什麼情況

{
  "url": string,
  "hint": enum (UrlHint)
}

string

網址欄位，可能為下列任一值：- 用於開啟應用程式連結應用程式或網頁的 http/https 網址

enum (UrlHint)

用於表示網址類型的提示。

{
  "title": string,
  "subtitle": string,
  "image": {
    object (Image)
  },
  "columns": [
    {
      object (TableColumn)
    }
  ],
  "rows": [
    {
      object (TableRow)
    }
  ],
  "button": {
    object (Link)
  }
}

string

表格的整體標題。選用，但如有設定字幕，則必須設定。

string

資料表的副標題。選填。

object (Image)

與資料表相關聯的圖片。選填。

object (TableColumn)

資料欄的標頭和對齊方式。

object (TableRow)

表格的資料列資料。我們保證會顯示前 3 列，但部分資料列可能只適用於特定介面。請使用模擬工具進行測試，以查看特定介面會顯示哪些資料列。在支援 WEB_BROWSER 功能的介面上，您可以將使用者導向至含有更多資料的網頁。

object (Link)

按鈕。

{
  "header": string,
  "align": enum (HorizontalAlignment)
}

string

資料欄的標題文字。

enum (HorizontalAlignment)

內容欄的水平對齊。如未指定，內容將會與前端對齊。

{
  "cells": [
    {
      object (TableCell)
    }
  ],
  "divider": boolean
}

object (TableCell)

這一列的儲存格。我們保證會顯示前 3 個儲存格，但部分儲存格可能會遭到截斷。請使用模擬器進行測試，以瞭解特定表面會顯示哪些儲存格。

boolean

表示每列後方是否應有分隔線。

{
  "text": string
}

string

儲存格的文字內容。

{
  "mediaType": enum (MediaType),
  "startOffset": string,
  "optionalMediaControls": [
    enum (OptionalMediaControls)
  ],
  "mediaObjects": [
    {
      object (MediaObject)
    }
  ],
  "repeatMode": enum (RepeatMode),
  "firstMediaObjectIndex": integer
}

enum (MediaType)

string (Duration format)

第一個媒體物件的開始偏移。

期間以秒為單位，小數部分最多九位數，以「s」結尾。範例："3.5s"。

enum (OptionalMediaControls)

這個媒體回應工作階段支援的選用媒體控制項類型。如果設定此值，當特定媒體事件發生時，要求就會傳送到 3p。如未設定，則第三方代碼仍必須處理「FINISHED」和「失敗」這兩種預設控制項類型。

object (MediaObject)

媒體物件清單

enum (RepeatMode)

媒體物件清單的重複模式。

integer

要播放的 mediaObjects 中第一個媒體物件從 0 開始的索引。如果未指定、零或超出範圍，系統會從 mediaObjects 中的第一個媒體物件開始播放。

{
  "name": string,
  "description": string,
  "url": string,
  "image": {
    object (MediaImage)
  }
}

string

此媒體物件的名稱。

string

此媒體物件的說明。

string

指向媒體內容的網址。MP3 檔案必須託管於網路伺服器，並透過 HTTPS 網址公開存取。直播僅支援 MP3 格式。

object (MediaImage)

與媒體資訊卡一併顯示的圖片。

{

  // Union field image can be only one of the following:
  "large": {
    object (Image)
  },
  "icon": {
    object (Image)
  }
  // End of list of possible types for union field image.
}

object (Image)

大型圖片，例如相簿封面等。

object (Image)

顯示在標題右側的小型圖片圖示。已將大小調整為 36x36 dp。

{
  "title": string,
  "subtitle": string,
  "items": [
    {
      object (CollectionItem)
    }
  ],
  "imageFill": enum (ImageFill)
}

string

珍藏內容的名稱。選填。

string

產品素材資源集合的副標題。選填。

object (CollectionItem)

項目清單。最小值為 2，最大值為 10。

enum (ImageFill)

產品素材資源集合項目圖片背景的填滿方式。選填。

{
  "key": string
}

string

必要欄位。符合相關 Type 中項目索引鍵名稱的 NLU 金鑰。

{
  "title": string,
  "subtitle": string,
  "items": [
    {
      object (ListItem)
    }
  ]
}

string

清單的標題。選填。

string

清單的副標題。選填。

object (ListItem)

項目清單。最小值為 2，最大值為 30。

{
  "key": string
}

string

必要欄位。符合相關 Type 中項目索引鍵名稱的 NLU 金鑰。

{
  "items": [
    {
      object (Item)
    }
  ],
  "imageFill": enum (ImageFill)
}

object (Item)

項目清單。最小值為 2，最大值為 10。

enum (ImageFill)

圖片顯示選項的類型。

{
  "title": string,
  "description": string,
  "footer": string,
  "image": {
    object (Image)
  },
  "openUriAction": {
    object (OpenUrl)
  }
}

string

必要欄位。系列作品項目的名稱。

string

系列商品的說明。

string

珍藏內容項目的頁尾文字，顯示在說明下方。單行文字，以刪節號截斷。

object (Image)

珍藏內容項目的圖片。

object (OpenUrl)

必要欄位。選取項目時要開啟的 URI。

{
  "title": string
}

string

必要欄位。建議方塊中顯示的文字。使用者輕觸這段文字後，系統就會逐字張貼回對話，就像使用者已輸入訊息一樣。所有建議方塊的標題都不得重複。最多 25 個半形字元

{
  "url": string,
  "data": [
    value
  ],
  "suppressMic": boolean,
  "continuousMatchConfig": {
    object (ContinuousMatchConfig)
  }
}

string

要載入的互動式畫布網頁應用程式的網址。如果不設定這項政策，系統會重複使用目前使用中的畫布網址。

value (Value format)

選用設定。要以事件的形式傳遞至沉浸式體驗網頁的 JSON 資料。如果「覆寫」包含提示中的欄位為「false」系統會先按照先前的 Canvas 提示中定義的資料值，新增這個畫布提示中定義的資料值。

boolean

選用設定。預設值為 false。

object (ContinuousMatchConfig)

用於啟動連續比對模式的設定。

{
  "expectedPhrases": [
    {
      object (ExpectedPhrase)
    }
  ],
  "durationSeconds": integer
}

object (ExpectedPhrase)

在此持續比對模式工作階段中，所有可能預期的詞組。

integer

維持連續比對模式的持續時間。如有指定，麥克風就會在使用時間結束時關閉。允許的最大值為 180。

{
  "phrase": string,
  "alternativePhrases": [
    string
  ]
}

string

在持續比對模式工作階段中，要比對的詞組。

string

即使在語音自訂調整功能的情況下，語音模型可能仍無法辨識某些詞組。這可讓開發人員指定同行式的替代觸發條件。

{
  "type": enum (Type),
  "order": {
    object (Order)
  },
  "updateMask": string,
  "userNotification": {
    object (UserNotification)
  },
  "reason": string
}

enum (Type)

已淘汰：請改用 OrderUpdate.update_mask。如果 type = SNAPSHOT，OrderUpdate.order 就應為整筆訂單。如果 type = ORDER_STATUS，這是指訂單層級的狀態變更。系統只會接收 order.last_update_time 和這個產業的狀態。注意：type.ORDER_STATUS 僅支援 PurcahaseOrderExtension 狀態更新，且目前沒有延長這項支援服務的計畫。建議使用 updateMask，因為這是更通用、可擴充且適用於所有產業。

object (Order)

string (FieldMask format)

注意：以下是有關下列特殊欄位的考量/建議：1. order.last_update_time 會一律在更新要求中更新。2. order.create_time、order.google_order_id 和 order.merchant_order_id，如果 updateMask 的一部分，則會被略過。

這是以半形逗號分隔的完整欄位名稱清單。範例："user.displayName,photo"。

object (UserNotification)

如果有指定，系統會向使用者顯示含有指定標題和文字的通知。指定通知是通知系統的推薦做法，而且不保證一定會收到通知。

string

變更/更新的原因。

{
  "googleOrderId": string,
  "merchantOrderId": string,
  "userVisibleOrderId": string,
  "userVisibleStateLabel": string,
  "buyerInfo": {
    object (UserInfo)
  },
  "image": {
    object (Image)
  },
  "createTime": string,
  "lastUpdateTime": string,
  "transactionMerchant": {
    object (Merchant)
  },
  "contents": {
    object (Contents)
  },
  "priceAttributes": [
    {
      object (PriceAttribute)
    }
  ],
  "followUpActions": [
    {
      object (Action)
    }
  ],
  "paymentData": {
    object (PaymentData)
  },
  "termsOfServiceUrl": string,
  "note": string,
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "disclosures": [
    {
      object (Disclosure)
    }
  ],
  "vertical": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field verticals can be only one of the following:
  "purchase": {
    object (PurchaseOrderExtension)
  },
  "ticket": {
    object (TicketOrderExtension)
  }
  // End of list of possible types for union field verticals.
}

string

Google 指派的訂單 ID。

string

必填：商家指定的內部訂單 ID。此 ID 不得重複，而且是後續訂單更新作業的必要項目。這個 ID 可設為提供的 googleOrderId 或任何其他不重複的值。請注意，向使用者顯示的 ID 是 userVisibleOrderId，可能會是另一個更易用的值。長度上限為 128 個字元。

string

參照目前訂單的使用者 ID。這個 ID 應與這個訂單在其他內容 (包括網站、應用程式和電子郵件) 中顯示的 ID 一致。

string

已淘汰：請改用 OrderExtensions 狀態。此訂單狀態的使用者可見標籤。

object (UserInfo)

買方資訊。

object (Image)

與訂單相關的圖片。

string (Timestamp format)

必填：訂單建立日期和時間。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度不超過奈秒，最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

string (Timestamp format)

訂單上次更新日期和時間。對 OrderUpdate 來說為必填。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度不超過奈秒，最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

object (Merchant)

進行結帳的商家。這可能與委刊項層級供應商不同。範例：包含 ANA 委刊項的 Expedia 訂單。

object (Contents)

必要：訂單內容，也就是委刊項群組。

object (PriceAttribute)

價格、折扣、稅金等。

object (Action)

訂單層級的後續操作。

object (PaymentData)

訂單的付款相關資料。

string

適用於訂單/提議訂單的服務條款連結。

string

附加至訂單的附註。

object (Promotion)

與這筆訂單相關聯的所有促銷活動。

object (Disclosure)

與這筆訂單相關的揭露資訊。

object

已淘汰：請改用產業別。除非某些委刊項遭到覆寫，否則這些屬性會套用至所有委刊項。這個產業必須與委刊項層級的產業類型相符。可能的值：google.actions.orders.v3.verticals.purchase.PurchaseOrderExtension google.actions.orders.v3.verticals.ticket.TicketOrderExtension

含有任意類型欄位的物件。額外的 "@type" 欄位則包含能辨識類型的 URI。範例：{ "id": 1234, "@type": "types.example.com/standard/id" }。

object (PurchaseOrderExtension)

採購單

object (TicketOrderExtension)

票券訂單

{
  "email": string,
  "firstName": string,
  "lastName": string,
  "displayName": string,
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ]
}

string

使用者電子郵件地址，例如：janedoe@gmail.com。

string

使用者的名字。

string

使用者的姓氏。

string

使用者的顯示名稱可能與名字或姓氏不同。

object (PhoneNumber)

使用者的電話號碼。

{
  "e164PhoneNumber": string,
  "extension": string,
  "preferredDomesticCarrierCode": string
}

string

E.164 格式的電話號碼，如國際電信聯盟 (ITU) 建議 E.164 所定義。維基連結：https://en.wikipedia.org/wiki/E.164

string

ITU 建議並未標準化副檔名，但可定義為一系列長度上限為 40 位數的數字。定義為字串，以在延伸中使用開頭的零 (組織完全自由，因為並未定義標準)。除數字外，其他某些撥號字元，例如「,」(表示等待) 可能會儲存在這裡。例如「xxx-xxx-xxxx ext」。123、"123"是副檔名

string

在美國撥打這組電話號碼時優先使用的電信業者選取代碼。這也包括從市話撥打手機時，必須於部分國家/地區撥打的代碼，反之亦然。舉例來說，如果是在哥倫比亞，則輸入「3」以手機撥電話到國內電話時，必須先撥打電話號碼，反之亦然。https://en.wikipedia.org/wiki/Telephone_numbers_in_Colombia https://en.wikipedia.org/wiki/Brazilian_Carrier_Selection_Code

請注意，這是「首選」也就是說，其他程式碼或許也能

{
  "url": string,
  "accessibilityText": string,
  "height": integer,
  "width": integer
}

string

圖片的來源網址。圖片可以是 JPG、PNG 和 GIF (動畫及非動畫)。例如：https://www.agentx.com/logo.png。必填。

string

用於無障礙的圖片文字說明，例如例如螢幕閱讀器和螢幕閱讀器等必填。

integer

圖片的高度 (以像素為單位)。選填。

integer

圖片寬度 (以像素為單位)。選填。

{
  "id": string,
  "name": string,
  "image": {
    object (Image)
  },
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ],
  "address": {
    object (Location)
  }
}

string

指派給商家的選用 ID (如有)。

string

商家名稱，例如「Panera Bread」。

object (Image)

與商家相關聯的圖片。

object (PhoneNumber)

商家的電話號碼。

object (Location)

商家地址。

{
  "coordinates": {
    object (LatLng)
  },
  "formattedAddress": string,
  "zipCode": string,
  "city": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "name": string,
  "phoneNumber": string,
  "notes": string,
  "placeId": string
}

object (LatLng)

地理座標。需要 [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] 權限。

string

顯示地址，例如「110 臺北市信義區信義路五段 7 號」。需要 [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] 權限。

string

郵遞區號。需要 [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] 或 [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION] 權限。

string

市區鄉鎮。需要 [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] 或 [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION] 權限。

object (PostalAddress)

郵政地址。需要 [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] 或 [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION] 權限。

string

地點名稱。

string

地點的電話號碼，例如商家所在地點的聯絡電話或電話號碼 (送貨地點)。

string

地點附註。

string

placeId 搭配 Places API 使用，以擷取地點的詳細資料。詳情請參閱 https://developers.google.com/places/web-service/place-id

{
  "latitude": number,
  "longitude": number
}

number

緯度度數，必須介於 [-90.0, +90.0] 的範圍之間。

number

經度度數，必須介於 [-180.0, +180.0] 的範圍之間。

{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}

integer

PostalAddress 的結構定義修訂版本。這個欄位的值必須設為 0，即代表最新的修訂版本。

所有新的修訂版本都必須能夠與舊的修訂版本回溯相容。

string

必要欄位。地址所在國家/地區的 CLDR 地區代碼。這個代碼絕非透過推測而得出，並且是由使用者自行確保該值正確無誤。詳情請參閱 http://cldr.unicode.org/ 和 http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html。例如：瑞士的地區代碼為「CH」。

string

選填。這個地址內容的 BCP-47 語言代碼 (如果已知)。通常是輸入表單的 UI 語言，或是符合地址的國家/地區所用的其中一個語言，或是使用音譯的對應項目。這個欄位可能會影響某些國家/地區的格式設定，但是不會影響資料的正確性，也絕不會影響任何驗證或其他非格式的相關作業。

如果不知道這個值為何，則應省略該值 (而非指定可能不正確的預設值)。

例如：「zh-Hant」、「ja」、「ja-Latn」、「en」。

string

選用設定。地址的郵遞區號。並非所有國家/地區都使用郵遞區號或要求必須填寫郵遞區號，不過在使用郵遞區號時，可能會對地址其他部分觸發額外的驗證作業 (例如美國對州/郵遞區號的驗證)。

string

選用設定。國家/地區專屬的其他分類代碼。大多數國家/地區並不使用這個代碼。在使用分類代碼的國家/地區中，這個值為與「CEDEX」相似的字串，後面選擇性加上一個數字 (例如「CEDEX 7」)，或是只有單一數字，並用來表示「區段代碼」(牙買加)、「寄送區域指示碼」(馬拉威) 或「郵局指示碼」(如象牙海岸)。

string

選用設定。最高行政區，用於國家/地區的郵遞地址。例如，此值可以是州、省或縣。以西班牙為例來具體說明，此欄位的值為省，而非自治區 (例如「巴塞隆納」省，而不是「加泰隆尼亞」自治區)。許多國家/地區的郵寄地址並沒有使用行政區。例如，就瑞士而言，該欄位應該留空不填。

string

選用設定。一般是指地址的縣市/鄉鎮部分。例如：美國城市、義大利市鎮、英國郵鎮。如為未明確定義縣市或其縣市不適用此結構的地區，請將 locality 留白，改用 addressLines。

string

選用設定。地址的縣市以下行政區，例如社區、自治市鎮和區等。

string

非結構化的地址行，說明地址的低層級項目。

由於 addressLines 中的值不會有類型資訊，而且有時在單一欄位中可能會包含多個值 (例如「Austin, TX」)，因此地址行的順序務必要明確。地址行的順序應為該地址所在國家/地區的「信封書寫順序」。在信封書寫順序可能不盡相同的地區 (如日本)，可使用 address_language 讓地址更明確 (例如「ja」表示由大到小的排序，而「ja-Latn」或「en」則表示由小到大)。如此一來，您便可以根據語言來選取明確度最高的地址行。

地址允許的最小結構表示法是包含一個 regionCode，並將其餘所有資訊放置在 addressLines 中。您可以在幾乎不使用地理定位的情况下，設定這類地址的格式，但至少在地址局部解析完畢之前，您無法對地址的任何組成部分進行語意推論。

如要處理完全非結構化的地址，我們建議您只建立包含 regionCode 和 addressLines 的地址，並使用地理定位來進行 (而非猜測地址的哪些部分應該是縣市還是行政區)。

string

選用設定。地址的收件人。在某些情況下，這個欄位可能會包含多行資訊。舉例來說，此欄位可能包含「代收者」資訊。

string

選用設定。地址中的機構名稱。

{
  "lineItems": [
    {
      object (LineItem)
    }
  ]
}

object (LineItem)

訂單委刊項清單。至少必須有 1 個委刊項，且最多允許 50 個。所有委刊項必須屬於相同的產業。

{
  "id": string,
  "name": string,
  "userVisibleStateLabel": string,
  "provider": {
    object (Merchant)
  },
  "priceAttributes": [
    {
      object (PriceAttribute)
    }
  ],
  "followUpActions": [
    {
      object (Action)
    }
  ],
  "recipients": [
    {
      object (UserInfo)
    }
  ],
  "image": {
    object (Image)
  },
  "description": string,
  "notes": [
    string
  ],
  "disclosures": [
    {
      object (Disclosure)
    }
  ],
  "vertical": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field verticals can be only one of the following:
  "purchase": {
    object (PurchaseItemExtension)
  },
  "reservation": {
    object (ReservationItemExtension)
  }
  // End of list of possible types for union field verticals.
}

string

必填：商家指定的委刊項 ID。用於在套用部分更新時識別現有委刊項。長度上限為 64 個半形字元。

string

收據上顯示的明細項目名稱。長度上限為 100 個半形字元。

string

已淘汰，請改用產業層級狀態。舉例來說，如果是購物活動，請使用 PurchaseOrderExtension.status。這個委刊項狀態的使用者可見標籤。

object (Merchant)

特定委刊項的供應商 (如果與整體訂單不同的話)。例如：包含委刊項供應商 ANA 的 Expedia 訂單。

object (PriceAttribute)

委刊項層級的價格和調整項。

object (Action)

委刊項的後續操作。

object (UserInfo)

委刊項層級的客戶，可能與訂單層級買方不同。範例：使用者 X 使用使用者名稱 Y 向餐廳訂位。

object (Image)

與此項目相關的小型圖片 (如果有的話)。

string

委刊項說明。

string

適用於這個特定委刊項的其他注意事項，例如取消政策。

object (Disclosure)

與這個委刊項相關的揭露資訊。

object

已淘汰：請改用產業別。必要：根據委刊項類型/產業的語意內容。每個產業都應該包含專屬的執行要求詳細資料。必須是下列其中一個值：google.actions.orders.v3.verticals.purchase.PurchaseItemExtension google.actions.orders.v3.verticals.reservation.ReservationItemExtension google.actions.orders.v3.verticals.ticket.TicketItemExtension

含有任意類型欄位的物件。額外的 "@type" 欄位則包含能辨識類型的 URI。範例：{ "id": 1234, "@type": "types.example.com/standard/id" }。

object (PurchaseItemExtension)

下單，例如貨品、食物等

object (ReservationItemExtension)

預訂訂單，例如餐廳、剪髮等

{
  "type": enum (Type),
  "name": string,
  "id": string,
  "state": enum (State),
  "taxIncluded": boolean,

  // Union field spec can be only one of the following:
  "amount": {
    object (Money)
  },
  "amountMillipercentage": integer
  // End of list of possible types for union field spec.
}

enum (Type)

必填：金額屬性類型。

string

必填：使用者顯示的價格屬性字串。由商家傳送並本地化。

string

選填：這個價格對應的委刊項 ID。

enum (State)

必填：價格狀態：預估值與實際費用。

boolean

是否含稅。

object (Money)

金額。

integer

百分比規格到百分比的 1/1000。例如：8.750% 以 8750 表示，負百分比代表折扣百分比。淘汰這個欄位。如果需要具體的用途，可以考慮重新加入計畫。

{
  "currencyCode": string,
  "amountInMicros": string
}

string

ISO 4217 定義的貨幣代碼 (由 3 個英文字母組成)。

string (int64 format)

金額，以微量為單位。舉例來說，這個欄位應設為 1990000 的價格為 $1.99。

{
  "type": enum (Type),
  "title": string,
  "openUrlAction": {
    object (OpenUrlAction)
  },
  "actionMetadata": {
    object (ActionMetadata)
  }
}

enum (Type)

必要：動作類型。

string

動作要向使用者顯示的標題或標籤。長度上限為 100 個半形字元。

object (OpenUrlAction)

要採取的行動。

object (ActionMetadata)

與動作相關聯的中繼資料。

{
  "url": string,
  "androidApp": {
    object (AndroidApp)
  },
  "urlTypeHint": enum (UrlTypeHint)
}

string

網址欄位，可能為下列任一值：- 用於開啟應用程式連結應用程式或網頁的 http/https 網址

object (AndroidApp)

Android 應用程式相關資訊，指出網址是否應由 Android 應用程式執行。

enum (UrlTypeHint)

用於表示網址類型的提示。

{
  "packageName": string,
  "versions": [
    {
      object (VersionFilter)
    }
  ]
}

string

指定 Android 執行要求時，必須指定套件名稱套件名稱。

object (VersionFilter)

指定多個篩選器時，只要有相符的篩選器，就會觸發應用程式。

{
  "minVersion": integer,
  "maxVersion": integer
}

integer

最低版本代碼為 0 或 0 (含首尾)。

integer

最高版本代碼 (含頭尾)。這個評估範圍是 [minVersion:maxVersion]。空值的範圍代表任何版本。範例：如要指定單一版本，請使用：[target_version:target_version]。如要指定任何版本，請保留 minVersion 和 maxVersion。如要指定 maxVersion 之前的所有版本，請不要指定 minVersion。如要從 minVersion 指定所有版本，請不要指定 maxVersion。

{
  "expireTime": string
}

string (Timestamp format)

這個動作將於何時到期。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度不超過奈秒，最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

{
  "title": string,
  "disclosureText": {
    object (DisclosureText)
  },
  "presentationOptions": {
    object (DisclosurePresentationOptions)
  }
}

string

揭露聲明的標題。例如：「安全性資訊」。

object (DisclosureText)

揭露事項的內容。允許網頁連結。

object (DisclosurePresentationOptions)

揭露聲明的顯示選項。

{
  "template": string,
  "textLinks": [
    {
      object (TextLink)
    }
  ]
}

string

要顯示的文字，包含「{0}」等預留位置和「{1}」。例如：「警告：此產品可能會使您接觸到加州都會已知致癌的化學物質。如需詳細資訊，請前往 {0}。」這段揭露文字不得包含任何宣傳或類似廣告的內容。

object (TextLink)

應在範本中替換的文字連結。第一組將會取代「{0}」第二個為「{1}」，以此類推

{
  "displayText": string,
  "url": string
}

string

應向使用者顯示的文字。

string

連結啟用後，使用者應導向的網址。

{
  "presentationRequirement": enum (PresentationRequirement),
  "initiallyExpanded": boolean
}

enum (PresentationRequirement)

揭露聲明的顯示規定。

boolean

揭露聲明內容是否應一開始就展開。根據預設，這個元件一開始是收合狀態。

{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "productId": string,
  "quantity": integer,
  "unitMeasure": {
    object (MerchantUnitMeasure)
  },
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "itemOptions": [
    {
      object (ItemOption)
    }
  ],
  "productDetails": {
    object (ProductDetails)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  }
}

enum (PurchaseStatus)

必要：委刊項層級狀態。

string

必要：使用者可見的狀態標籤/字串。長度上限為 50 個半形字元。

enum (PurchaseType)

必填：購買類型。

string

與這個委刊項相關聯的產品或優惠 ID。

integer

商品數量。

object (MerchantUnitMeasure)

測量單位。以所選單位指定項目大小。尺寸和有效價格會用來決定單位價格。

object (PurchaseReturnsInfo)

傳回這個委刊項的資訊。如未設定，這個委刊項會沿用訂單層級傳回資訊。

object (PurchaseFulfillmentInfo)

這個委刊項的執行要求資訊。如未設定，這個委刊項會沿用訂單層級的出貨資訊。

object (ItemOption)

其他外掛程式或子項目。

object (ProductDetails)

產品詳細資料。

object

商家與 Google 之間交換的任何額外欄位。注意：強烈建議不要使用這個擴充功能。根據用途/情況，請考慮以下其中一項：1.如果 PurchaseItemExtension 中的欄位可用於其他用途 (亦即一般功能/功能)，請定義該欄位。2. 如果是專為自訂的非一般用途/功能而設計，請使用 vertical_extension。

含有任意類型欄位的物件。額外的 "@type" 欄位則包含能辨識類型的 URI。範例：{ "id": 1234, "@type": "types.example.com/standard/id" }。

{
  "measure": number,
  "unit": enum (Unit)
}

number

值：範例 1.2。

enum (Unit)

Unit：範例 POUND，GRAM。

{
  "isReturnable": boolean,
  "daysToReturn": integer,
  "policyUrl": string
}

boolean

如果為 true，則允許傳回。

integer

退貨期限為這段時間內。

string

退貨政策的連結。

{
  "id": string,
  "fulfillmentType": enum (Type),
  "expectedFulfillmentTime": {
    object (Time)
  },
  "expectedPreparationTime": {
    object (Time)
  },
  "location": {
    object (Location)
  },
  "expireTime": string,
  "price": {
    object (PriceAttribute)
  },
  "fulfillmentContact": {
    object (UserInfo)
  },
  "shippingMethodName": string,
  "storeCode": string,
  "pickupInfo": {
    object (PickupInfo)
  }
}

string

這個服務選項的專屬 ID。

enum (Type)

必填：執行要求類型。

object (Time)

指定時間範圍時會顯示時間範圍；如果指定單一時間，則為預計到達時間。預計送達或取貨時間。

object (Time)

指定時間範圍時會顯示時間範圍；如果指定單一時間，則為預計到達時間。預計的準備時間。建議設為單次使用，

object (Location)

提供取貨或送貨地點。

string (Timestamp format)

這個執行要求選項的效期。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度不超過奈秒，最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

object (PriceAttribute)

此選項的費用。

object (UserInfo)

此執行要求的使用者聯絡資訊。

string

使用者所選運送方式的名稱。

string

地點的 StoreCode。範例：Walmart 是商家，storeCode 是執行出貨的 Walmart 商店。https://support.google.com/business/answer/3370250?ref_topic=4596653.

object (PickupInfo)

關於挑選訂單的其他資訊。只有在執行要求類型為 PICKUP 時，才能使用這個欄位。

{
  "timeIso8601": string
}

string

代表訂單活動時間，例如預訂時間、運送時間等。可以是時間長度 (開始和結束時間)、只有日期、日期等。如需所有支援的格式，請參閱 https://en.wikipedia.org/wiki/ISO_8601。

{
  "pickupType": enum (PickupType),
  "curbsideInfo": {
    object (CurbsideInfo)
  },
  "checkInInfo": [
    {
      object (CheckInInfo)
    }
  ]
}

enum (PickupType)

取貨方式，例如 INSTORE、CURBSIDE 等

object (CurbsideInfo)

店外資訊的特定詳細資料。如果 pickupType 並非「CURBSIDE」，系統會忽略這個欄位。

object (CheckInInfo)

合作夥伴支援各種支援簽到方式的清單。

{
  "curbsideFulfillmentType": enum (CurbsideFulfillmentType),
  "userVehicle": {
    object (Vehicle)
  }
}

enum (CurbsideFulfillmentType)

合作夥伴需要額外資訊，才能協助店外取貨。視選取的執行要求類型而定，系統會向使用者收集相應的詳細資料。

object (Vehicle)

下單使用者的車輛詳細資料。

{
  "make": string,
  "model": string,
  "licensePlate": string,
  "colorName": string,
  "image": {
    object (Image)
  }
}

string

車輛廠牌 (例如「Honda」)。這會向使用者顯示，而且必須本地化。必填。

string

車輛型號 (例如「Grom」)。這會向使用者顯示，而且必須本地化。必填。

string

車牌號碼 (例如「1ABC234」)。必填。

string

交通工具顏色名稱，例如黑色選用。

object (Image)

車輛相片的網址。相片顯示大小約為 256 x 256 像素。必須是 jpg 或 png。選填。

{
  "checkInType": enum (CheckInType)
}

enum (CheckInType)

寄送簽到指示的方法。

{
  "id": string,
  "name": string,
  "prices": [
    {
      object (PriceAttribute)
    }
  ],
  "note": string,
  "quantity": integer,
  "productId": string,
  "subOptions": [
    {
      object (ItemOption)
    }
  ]
}

string

至於屬於項目的選項，請使用專屬項目 ID。

string

選項名稱。

object (PriceAttribute)

選項總價。

string

與選項相關的附註。

integer

「item_quantity」選項。

string

與這個選項相關聯的產品或優惠 ID。

object (ItemOption)

定義其他巢狀子選項。

{
  "productId": string,
  "gtin": string,
  "plu": string,
  "productType": string,
  "productAttributes": {
    string: string,
    ...
  }
}

string

與這個委刊項相關聯的產品或優惠 ID。

string

產品的全球交易品項識別碼。在 Merchant Center 中沒有 OfferId 時相當實用。選填。

string

價格查詢代碼通常稱為 PLU 代碼、PLU 號碼、PLU、產生代碼或農產品標籤，是一組專屬編號系統，可用於識別雜貨店和超市販售的大量農產品。

string

商家定義的產品類別。例如：「首頁 >雜貨 >乳製品能量蛋 >牛奶 >全牛奶」

map (key: string, value: string)

商家提供的產品詳細資料，例如{ "allergen": "peanut"}。在 Merchant Center 中沒有 OfferId 時相當實用。選填。

這個物件中包含 "key": value 組合的清單，範例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。

{
  "status": enum (ReservationStatus),
  "userVisibleStatusLabel": string,
  "type": enum (ReservationType),
  "reservationTime": {
    object (Time)
  },
  "userAcceptableTimeRange": {
    object (Time)
  },
  "confirmationCode": string,
  "partySize": integer,
  "staffFacilitators": [
    {
      object (StaffFacilitator)
    }
  ],
  "location": {
    object (Location)
  }
}

enum (ReservationStatus)

必填：預訂狀態。

string

必要：使用者可見的狀態標籤/字串。長度上限為 50 個半形字元。

enum (ReservationType)

預留項目類型。如果所有類型選項都不適用，則可未設定。

object (Time)

排定服務/事件的執行時間。可以是時間範圍、日期或確切的日期時間。

object (Time)

使用者可接受的時間範圍。

string

此預訂的確認碼。

integer

人數。

object (StaffFacilitator)

將提供預訂服務的員工協助人員。例如：髮型師。

object (Location)

服務/事件的地點。

{
  "name": string,
  "image": {
    object (Image)
  }
}

string

教職員講師姓名。例如：「王大明」

object (Image)

表演者的圖片。

{
  "paymentResult": {
    object (PaymentResult)
  },
  "paymentInfo": {
    object (PaymentInfo)
  }
}

object (PaymentResult)

整合商完成交易時使用的付款結果。如果結帳服務是由 Actions-on-Google 管理，則 Actions on Google 會填入這個欄位。

object (PaymentInfo)

有助於使用者互動的訂單付款資訊。

{

  // Union field result can be only one of the following:
  "googlePaymentData": string,
  "merchantPaymentMethodId": string
  // End of list of possible types for union field result.
}

string

Google 提供的付款方式資料。如果您的付款處理方是 Google 支援的付款處理方，請參閱 https://developers.google.com/pay/api/，透過連結前往付款處理方頁面瞭解詳情。否則，請參閱下列說明文件，瞭解酬載詳細資料。https://developers.google.com/pay/api/payment-data-cryptography

string

使用者選擇的商家/動作提供的付款方式。

{
  "paymentMethodDisplayInfo": {
    object (PaymentMethodDisplayInfo)
  },
  "paymentMethodProvenance": enum (PaymentMethodProvenance)
}

object (PaymentMethodDisplayInfo)

顯示交易所用付款方式的資訊。

enum (PaymentMethodProvenance)

交易所用付款方式的證明。使用者可能在 Google 和商家中註冊了相同的付款方式。

{
  "paymentType": enum (PaymentType),
  "paymentMethodDisplayName": string,
  "paymentMethodVoiceName": string
}

enum (PaymentType)

付款類型。

string

使用者看到的付款方式名稱。例如 VISA **** 1234 支票帳戶 **** 5678

string

要在使用語音功能的助理裝置上，向使用者讀出的付款方式名稱。例如：「末碼為一二三四的簽證」或「支票帳戶結尾為五六七八次」。注意：這是語音最佳化字串，如果是語音專用助理裝置，則會使用這個字串，而非 paymentsMethodDisplayName。如未設定這個字串，系統會將 paymentsMethodDisplayName 朗讀給使用者。

{
  "coupon": string
}

string

必填：套用至這項優惠的優待券代碼。

{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "purchaseLocationType": enum (PurchaseLocationType),
  "errors": [
    {
      object (PurchaseError)
    }
  ],
  "extension": {
    "@type": string,
    field1: ...,
    ...
  }
}

enum (PurchaseStatus)

必填：訂單的整體狀態。

string

使用者看到的狀態標籤/字串。長度上限為 50 個半形字元。

enum (PurchaseType)

必填：購買類型。

object (PurchaseReturnsInfo)

傳回訂單資訊。

object (PurchaseFulfillmentInfo)

訂單的出貨資訊。

enum (PurchaseLocationType)

購買地點 (店內 / 線上)

object (PurchaseError)

選用：訂單遭拒而發生錯誤。

object

商家與 Google 之間交換的任何額外欄位。注意：強烈建議不要使用這個擴充功能。根據用途/情況，請考慮以下其中一項：1.如果 PurchaseOrderExtension 的欄位可用於其他用途 (亦即一般功能/功能)，請在 PurchaseOrderExtension 中定義欄位。2. 如果是專為自訂的非一般用途/功能而設計，請使用 vertical_extension。

含有任意類型欄位的物件。額外的 "@type" 欄位則包含能辨識類型的 URI。範例：{ "id": 1234, "@type": "types.example.com/standard/id" }。

{
  "type": enum (ErrorType),
  "description": string,
  "entityId": string,
  "updatedPrice": {
    object (PriceAttribute)
  },
  "availableQuantity": integer
}

enum (ErrorType)

必填：這是商家拒絕訂單的詳細原因。

string

其他錯誤說明。

string

與錯誤對應的實體 ID。此範例可對應至 LineItemId / ItemOptionId。

object (PriceAttribute)

發生 PRICE_CHANGED / INCORRECT_PRICE 錯誤類型時的相關。

integer

現貨數量。適用於 AVAILABILITY_CHANGED。

{
  "ticketEvent": {
    object (TicketEvent)
  }
}

object (TicketEvent)

套用至所有委刊項票券的事件。

{
  "type": enum (Type),
  "name": string,
  "description": string,
  "url": string,
  "location": {
    object (Location)
  },
  "eventCharacters": [
    {
      object (EventCharacter)
    }
  ],
  "startDate": {
    object (Time)
  },
  "endDate": {
    object (Time)
  },
  "doorTime": {
    object (Time)
  }
}

enum (Type)

必填：票券活動類型，例如電影、演唱會。

string

必填：事件名稱。舉例來說，如果事件是電影，請填入電影名稱。

string

活動說明。

string

活動資訊的網址。

object (Location)

活動舉辦地點或機構所在位置。

object (EventCharacter)

與這個事件相關的角色。可能是電影活動的導演或演員，或是音樂會的表演者等。

object (Time)

開始時間。

object (Time)

結束時間。

object (Time)

進入時間，可能與活動開始時間不同。例如：活動是從上午 9 點開始，但報名時間為上午 8:30

{
  "type": enum (Type),
  "name": string,
  "image": {
    object (Image)
  }
}

enum (Type)

事件字元的類型，例如：或導演

string

字元名稱。

object (Image)

人物的圖片。

{
  "title": string,
  "text": string
}

string

使用者通知的標題。長度上限為 30 個半形字元。

string

通知的內容。長度上限為 100 個半形字元。

{
  "name": string
}

string

接下來要執行的場景名稱。

{
  "id": string,
  "params": {
    string: value,
    ...
  },
  "typeOverrides": [
    {
      object (TypeOverride)
    }
  ],
  "languageCode": string
}

string

必要欄位。目前對話工作階段的全域專屬 ID。這是唯讀欄位。

map (key: string, value: value (Value format))

必要欄位。在工作階段期間，從表單和意圖收集的所有參數的清單。鍵是參數名稱。這裡定義的參數會與工作階段中定義的參數合併。系統會將值為空值的參數從工作階段中移除。參閱工作階段儲存空間說明文件：https://developers.google.com/assistant/conversational/storage-session。

這個物件中包含 "key": value 組合的清單，範例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。

object (TypeOverride)

選用設定。範圍限定於工作階段的類型。工作階段類型定義可以補充或取代現有類型。類型名稱不得重複。

string

目前對話工作階段的語言。遵循 IETF BCP-47 語言代碼 http://www.rfc-editor.org/rfc/bcp/bcp47.txt。如果動作使用多語言功能，則可能與使用者語言代碼有所不同。舉例來說，在設定 handler_response.expected.language_code 後，它會變更所有後續回合的對話語言，且這個欄位會反映這項變更。

{
  "name": string,
  "mode": enum (TypeOverrideMode),
  "synonym": {
    object (SynonymType)
  }
}

string

必要欄位。要補充或覆寫的類型名稱。

enum (TypeOverrideMode)

必要欄位。此類型如何與其他類型值合併。

object (SynonymType)

{
  "entries": [
    {
      object (Entry)
    }
  ]
}

object (Entry)

必要欄位。同義詞類型的項目清單。

{
  "name": string,
  "synonyms": [
    string
  ],
  "display": {
    object (EntryDisplay)
  }
}