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)

可选。系统会在需要时向用户发送此提示，以填充所需的槽位。此提示会替换控制台中定义的现有提示。网络钩子请求中不包含此字段。

{
  "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)

可选。可链接到关联的应用或网站的其他建议内容信息卡。该条状标签将以“Open (name)”（打开（名称））的标题呈现。最多 20 个字符。

object (Canvas)

可选。表示要发送给用户的 Interactive Canvas 响应。

object (OrderUpdate)

在交易流中收到订单后，可选 Action 会返回 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 行保证会显示，但其他行可能会被在某些平台上剪切。请使用模拟器进行测试，看看将针对给定 Surface 显示哪些行。在支持 WEB_BROWSER 功能的平台上，您可以将用户引导至包含更多数据的网页。

object (Link)

按钮。

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

string

列的标题文本。

enum (HorizontalAlignment)

内容与列的水平对齐方式。如果未指定，内容将与前缘对齐。

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

object (TableCell)

此行中的单元格。前 3 个单元格一定会显示，但其他单元格可能会被在某些表面上剪切。请使用模拟器进行测试，看看将针对给定 Surface 显示哪些单元格。

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 和 FAILED。

object (MediaObject)

媒体对象列表

enum (RepeatMode)

针对媒体对象列表重复运行模式。

integer

mediaObject 中要播放的第一个媒体对象的索引（从 0 开始）。如果未指定、零或超出边界，则从 mediaObject 中的第一个媒体对象开始播放。

{
  "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

要加载的交互式画布 Web 应用的网址。如果您未设置此政策，系统会重复使用当前有效画布中的网址。

value (Value format)

可选。要作为事件传递到沉浸式体验网页的 JSON 数据。如果“替换”字段的值为“false”此 Canvas 提示中定义的数据值将添加到之前的 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。此 ID 可设置为提供的 googleOrderId 或任何其他唯一值。请注意，向用户显示的 ID 是 userVisibleOrderId，它可能是一个不同的值，更方便用户使用。允许的长度上限为 128 个字符。

string

引用当前订单的面向用户的 ID。此 ID 应与该订单在其他情境（包括网站、应用和电子邮件）中显示的 ID 一致。

string

已弃用：请改用 OrderExtensions 状态。此订单状态的用户可见标签。

object (UserInfo)

买方的相关信息。

object (Image)

与订单相关联的图片。

string (Timestamp format)

必填：订单的创建日期和时间。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

string (Timestamp format)

上次更新订单的日期和时间。OrderUpdate 是必需的。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："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

根据国际电信联盟 (ITU) 建议 E.164 中规定的 E.164 格式电话号码。Wiki 链接：https://en.wikipedia.org/wiki/E.164

string

扩展不是在 ITU 建议中标准化的，除非是定义为长度不超过 40 位的一串数字。此处将其定义为字符串，以配合在扩展名中使用前导零的情况（组织可以完全自由地这样做，因为未定义标准）。除数字外，一些其他拨号字符，例如“,”（表示等待）可能会存储在此处。例如，xxx-xxx-xxxx 分机号：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

商家的名称，例如“帕纳拉面包”。

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”。需要 [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 语言代码（如果已知）。这通常是输入表单的界面语言，或者与地址的“国家/地区”中使用的某种语言或其转换后的其他语言相匹配。这可能会影响某些国家/地区的格式，但对数据的正确性并不重要，也不会影响任何验证或其他与格式无关的操作。

如果此值未知，则应省略（而不是指定可能不正确的默认值）。

示例：“zh-Hant”、“ja”、“ja-Latn”、“en”。

string

可选。地址的邮政编码。并非所有国家/地区都使用或要求使用邮政编码，但在使用邮政编码时，它们可能会触发地址其他部分的额外验证（例如美国的州/邮政编码验证）。

string

可选。特定于国家/地区的额外排序代码。大多数区域都未使用此功能。在使用它的地方，此值可以是一个类似“CEDEX”的字符串，后面可能会跟一个数字（例如“CEDEX 7”），或者只有一个数字，代表“管制区代码”（牙买加），“投递区域指标”（马拉维）或“邮局指标”（例如科特迪瓦）。

string

可选。最高行政区划，用于国家或地区的邮政地址。例如，此值可以是州、省、州（俄罗斯）或县。具体来说，对于西班牙，此值为省而非自治区（例如此值为“巴塞罗那”而非“加泰罗尼亚”）。许多国家在邮政地址中不使用行政区划。例如对于瑞士，此字段应留空。

string

可选。一般是指地址的城市/城镇部分。示例：美国的城市、意大利的市镇、英国的邮镇。对于没有明确定义 locality 或者其无法很好地对应这个结构的区域，应将 locality 留空并使用 address_lines。

string

可选。地址的子级市行政区。例如，此值可以是社区、自治市/镇/区、行政区。

string

描述详细地址的非结构化地址行。

由于 addressLines 中的值没有类型信息，并且有时可能在单个字段中包含多个值（例如“Austin, TX”），因此清楚的行顺序很重要。地址行的顺序应该是地址的国家/地区的“信封顺序”。在某些地方，此顺序有可能不同（例如日本），address_language 有助于使其明确（例如，“ja”表示从大到小排序，“ja-Latn”或“en”表示从小到大排序）。这样就可以根据语言选择地址的具体行。

地址的最小结构化表示形式由 regionCode 和 addressLines 组成，其中所有其他信息都放在 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

必需：商家为订单项分配的标识符。用于在应用部分更新时识别现有订单项。允许的长度上限为 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，此字段应设置为 1990000。

{
  "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]。null 范围表示任何版本。示例：要指定单个版本，请使用：[target_version:target_version]。要指定任何版本，请勿指定 minVersion 和 maxVersion。如需指定 maxVersion 之前的所有版本，请勿指定 minVersion。如需指定 minVersion 中的所有版本，请勿指定 maxVersion。

{
  "expireTime": string
}

string (Timestamp format)

此操作的到期时间。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："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 中的字段可用于其他用例（即通用功能），请在 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

此服务选项的唯一标识符。

enum (Type)

必需：履单的类型。

object (Time)

如果指定了时间范围，则为窗口；如果指定了单个时间，则为 ETA。预计送货或自提时间。

object (Time)

如果指定了时间范围，则为窗口；如果指定了单个时间，则为 ETA。准备食物的预计时间。一次性首选。

object (Location)

自提或送货地点。

string (Timestamp format)

此履单选项的过期时间。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

object (PriceAttribute)

此选项的费用。

object (UserInfo)

此执行方式的用户联系人。

string

用户选择的配送方式名称。

string

营业地点的商店代码。示例：沃尔玛是商家，storeCode 是履单的沃尔玛商店。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、CUBSIDE 等

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

车辆品牌（例如“本田”）。此信息会向用户显示，并且必须本地化。必填。

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

对于作为商品的选项，则指定数量。

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

对于仅支持语音助手的设备，将向用户显示的付款方式名称。例如，“尾号为一二三四的签证”或“尾号为五六七八的支票账户”。注意：这是语音优化字符串，用于替代纯语音助理设备的 paymentMethodDisplayName。如果未设置此字符串，系统会改为向用户读出 paymentMethodDisplayName。

{
  "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 / INORRECT_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))

必需。会话期间从表单和意图收集的所有参数的列表。key 为参数名称。此处定义的参数将与会话中定义的参数合并。值为 null 的参数将从会话中移除。请参阅会话存储文档：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)
  }
}