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」會將此提示中定義的訊息新增至先前回應中定義的訊息。如果將這個欄位設為「否」，就能在「提示」提示、「提示」提示和 Canvas 提示 (「內容」提示) 內附加部分欄位。如果收到提示，一律會覆寫內容與連結訊息。預設值為「false」。

object (Simple)

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

object (Content)

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

object (Simple)

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

object (Suggestion)

選用設定。向使用者顯示的建議訊息，一律會顯示在回應結尾。如果包含提示的「覆寫」欄位為「false」，系統會將這個欄位中定義的標題加進先前定義建議提示的標題，並移除重複值。

object (Link)

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

object (Canvas)

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

object (OrderUpdate)

選擇性動作會在交易流程收到訂單後收到 OrderUpdate 的回應。收到收據後，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)

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

時間長度以秒為單位，最多可有 9 個小數位數，並應以「s」結尾，例如："3.5s"。

enum (OptionalMediaControls)

這個媒體回應工作階段支援的媒體控制類型 (選用)。如已設定，系統會在特定媒體事件發生時向第三方發出要求。如果未設定，第三方仍必須處理兩種預設控制項類型：FINISHED 和 FAILED。

object (MediaObject)

媒體物件清單

enum (RepeatMode)

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

integer

要播放的 MediaObject 第一個媒體物件為 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

必要欄位。這個 NLU 鍵與相關類型中的項目鍵名稱相符。

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

string

清單標題。選用。

string

清單副標題。選用。

object (ListItem)

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

{
  "key": string
}

string

必要欄位。這個 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 資料傳遞至沈浸式網頁。如果其中包含的 Canvas 提示內定義的「覆寫」欄位為「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 應為整筆訂單。如果類型 = 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

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

object (UserInfo)

買方的相關資訊。

object (Image)

與訂單相關聯的圖片。

string (Timestamp format)

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

以 RFC3339 世界標準時間「Zulu」格式表示的時間戳記，單位為奈及解析度，最多為九位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

string (Timestamp format)

訂單上次更新的日期和時間。OrderUpdate 為必要項目。

以 RFC3339 世界標準時間「Zulu」格式表示的時間戳記，單位為奈及解析度，最多為九位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

object (Merchant)

協助結帳的商家。這可以與委刊項層級供應商不同。範例：Expedia 訂單搭配 ANA 的委刊項。

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

使用者電子郵件，例如：janjanoe@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 位數的一系列數字。定義為字串字串，有助於在延伸階段使用前置字元 0 (機構沒有詳細定義，可自由指定)。除了數字以外，其他一些撥號字元 (例如「,」(表示等待)) 也可以儲存在這裡。以 xxx-xxx-xxxx-ext.123 為例，「123」代表副檔名。

string

撥打國內電話時，偏好的電信業者選取代碼。從部分國家/地區撥打市內電話時，這也包含部分國家/地區的電話號碼，反之亦然。例如，哥倫比亞目前，撥打手機時，使用者必須先撥打「3」，才能撥打至市話號碼，反之亦然。https://en.wikipedia.org/wiki/Telephone_numbers_in_Colombia https://zh.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

顯示地址，例如：「1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA」。必須具備 [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/regional_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)

金額 (以百萬分之一為單位)。舉例來說，這個欄位應設為 $1.99 美元/ $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 (含)。

integer

版本代碼上限 (含)。系統建議範圍為 [minVersion:maxVersion]。空值範圍表示任何版本。例如：如要指定單一版本，請使用：[target_version:target_version]。如要指定任何版本，請將 minVersion 和 maxVersion 未指定。如要指定所有版本，直到 maxVersion 為止，請不要指定 minVersion。如要指定 minVersion 的版本，請將 maxVersion 設為未指定。

{
  "expireTime": string
}

string (Timestamp format)

這項動作的到期時間。

以 RFC3339 世界標準時間「Zulu」格式表示的時間戳記，單位為奈及解析度，最多為九位數。範例："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)

單位：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)

指定時間範圍時，以及單一時間的 ETA (如有指定)。預計送達或取貨時間。

object (Time)

指定時間範圍時，以及單一時間的 ETA (如有指定)。準備餐點的預計時間。(建議只能提供一次)。

object (Location)

自取或外送地點。

string (Timestamp format)

此執行選項的到期時間。

以 RFC3339 世界標準時間「Zulu」格式表示的時間戳記，單位為奈及解析度，最多為九位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

object (PriceAttribute)

此選項的費用。

object (UserInfo)

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

string

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

string

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

object (PickupInfo)

關於訂單選擇方式的其他資訊。只有在出貨類型為 PICKUP 時，才能使用這個欄位。

{
  "timeIso8601": string
}

string

代表訂單事件時間，例如預訂時間、運送時間等。可以是時間長度 (開始和結束時間)、僅限日期、日期等格式。如需所有支援的格式，請參閱 https://zh.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

車輛顏色名稱，例如 Black 選填。

object (Image)

車輛相片的網址。相片大約是 256x256 像素。必須為 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

選項：商品。

string

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

object (ItemOption)

定義其他巢狀子選項。

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

string

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

string

產品的全球交易品項識別碼。如果 Merchant Center 中沒有優惠 ID，則適合使用這個選項。選用。

string

價格查詢代碼 (通常稱為 PLU 代碼、PLU 號碼、PLU、產生代碼或生產標籤) 是唯一用來識別雜貨店和超市 (而非大量銷售) 的大量號碼系統。

string

商家定義的產品類別。例如：「居家 > 雜貨店 > 乳製品與雞蛋 > 牛奶 > 全奶」

map (key: string, value: string)

商家提供的產品詳細資料，例如 { "allergen": "peanut" }。如果 Merchant Center 中沒有優惠 ID，就很適合使用此選項。選用。

這個物件中包含 "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

系統向使用者傳送的付款方式 (僅限語音助理裝置)。例如「最後以三分之二結尾」或「檢查帳戶末四碼為六秒七」。注意：此僅用於聲控字串，而非純助理助理裝置的 paymentMethodDisplayName。如未設定此字串，系統會改為向使用者顯示 payMethodDisplayName。

{
  "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 中定義其他用途 (例如一般功能/功能)。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。如果動作使用多種語言，這項操作可能與使用者所在地區不同。例如，設定處理常式_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)
  }
}