Method: projects.sendInteraction

string

必需。被测项目，由项目 ID 表示。格式：projects/{project}

string

用户发送的输入的内容。

enum (InputType)

输入的类型。

enum (Surface)

用于与 Action 互动的 Surface。

object (Location)

设备位置信息，例如纬度、经度和格式化的地址。

string

设备上设置的语言区域。格式应遵循 BCP 47 要求：https://tools.ietf.org/html/bcp47。示例：en、en-US、es-419（如需更多示例，请访问 https://tools.ietf.org/html/bcp47#appendix-A)。

string

设备上设置的时区。格式应遵循 IANA 时区数据库格式，例如“America/New_York”：https://www.iana.org/time-zones

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] 权限。

number

纬度（以度为单位）。它必须在 [-90.0, +90.0] 范围内。

number

经度（以度为单位）。它必须在 [-180.0, +180.0] 范围内。

string

以纯字符串形式发送给用户的语音回复。

string

相应 Action 生成的语音内容。这可能包括 SSML 等标记元素。

object (Canvas)

Interactive Canvas

object (Prompt)

对话结束时的提示状态。如需详细了解该提示，请访问：https://developers.google.com/assistant/conversational/prompts

string

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

value (Value format)

可选。要作为事件传递到沉浸式体验网页的 JSON 数据。如果“替换”字段的值为“false”此 Canvas 提示中定义的数据值将添加到之前的 Canvas 提示中定义的数据值之后。

boolean

可选。默认值：false。

boolean

如果为 true，则画布应用会占据整个屏幕，且顶部不会有标题。加载屏幕上还会显示消息框消息，其中包含操作的显示名称、开发者名称以及退出操作的说明。默认值：false。

boolean

可选。指定如何将此消息与之前定义的消息合并的模式。“false”会清除所有以前定义的消息（第一个和最后一个简单消息、内容、建议链接和画布），然后添加此提示中定义的消息。“true”会将此提示中定义的消息添加到之前回复中定义的消息。将此字段设置为“true”还会启用附加至简单提示、建议提示和画布提示（内容提示的一部分）中的某些字段。如果提示中指定了“内容”和“链接”消息，这些消息将始终会被覆盖。默认值为“false”。

boolean

可选。指定如何将此消息与之前定义的消息合并的模式。“true”清除以前定义的所有消息（第一个和最后一个简单消息、内容、建议链接和画布），并添加此提示中定义的消息。“false”将此提示中定义的消息添加到之前响应中定义的消息。将此字段保留为“false”还支持向“简单提示”“建议”提示和“画布”提示（属于“内容”提示的一部分）内的部分字段附加内容。如果提示中指定了“内容”和“链接”消息，它们始终会被覆盖。默认值为“false”。

object (Simple)

可选。第一条语音回复和纯文字回复。

object (Content)

可选。向用户显示的卡片、列表或媒体等内容。

object (Simple)

可选。最后一次语音和纯文字回复。

object (Suggestion)

可选。要向用户显示的建议，这些建议将始终显示在响应末尾。如果“替换”字段的值为“false”，此字段中定义的标题将添加到之前定义的任何建议提示中定义的标题，并移除重复值。

object (Link)

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

object (Canvas)

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

string

可选。表示向用户说出的语音。可以是 SSML 或文字转语音。如果“替换”字段的值为“true”，则此字段中定义的语音将替换上一个简单提示的语音。

string

要在聊天气泡中显示的可选文本。如果未指定，系统将使用呈现方式呈现上述语音字段。不得超过 640 个字符。如果“替换”字段的值为“true”，则此字段中定义的文本将替换成上一个简单提示的文本。

object (Card)

基本卡片。

object (Image)

图片。

object (Table)

表格卡片。

object (Media)

指示要播放的一组媒体的响应。

object (Canvas)

用于互动式画布体验的响应。

object (Collection)

显示一系列可供选择的选项的卡片。

object (List)

显示可供选择的选项列表的卡片。

string

卡片的总体标题。可选。

string

可选。

string

卡片的正文。支持一组数量有限的 Markdown 语法。必填，除非显示图片。

object (Image)

卡片的主打图片。高度固定为 192dp。可选。

enum (ImageFill)

图片背景的填充方式。可选。

object (Link)

按钮。可选。

string

图片的来源网址。图片可以是 JPG、PNG 和 GIF（动画和非动画）。例如：https://www.agentx.com/logo.png。必填。

string

将用于无障碍功能的图片的文字说明，例如屏幕阅读器。必填。

integer

图片的高度（以像素为单位）。可选。

integer

图片的宽度（以像素为单位）。可选。

string

链接名称

object (OpenUrl)

用户打开链接后会怎么样

string

网址字段，可以是以下任一项：- 用于打开与应用关联的应用或网页的 http/https 网址

enum (UrlHint)

表示网址类型的提示。

string

表格的总体标题。可选，但如果设置了字幕，则必须设置该字段。

string

表格的副标题。可选。

object (Image)

与表关联的图片。可选。

object (TableColumn)

标题和列的对齐方式。

object (TableRow)

表中的行数据。前 3 行保证会显示，但其他行可能会被在某些平台上剪切。请使用模拟器进行测试，看看将针对给定 Surface 显示哪些行。在支持 WEB_BROWSER 功能的平台上，您可以将用户引导至包含更多数据的网页。

object (Link)

按钮。

string

列的标题文本。

enum (HorizontalAlignment)

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

object (TableCell)

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

boolean

指示每行后是否应有分隔线。

string

单元格的文本内容。

enum (MediaType)

媒体类型。

string (Duration format)

第一个媒体对象的起始偏移量。

该持续时间以秒为单位，最多包含九个小数位，以“s”结尾。示例："3.5s"。

enum (OptionalMediaControls)

此媒体响应会话可以支持的可选媒体控件类型。如果设置，当发生特定媒体事件时，系统会向第三方发送请求。如果此政策未设置，3p 仍必须处理两种默认控件类型：FINISHED 和 FAILED。

object (MediaObject)

媒体对象列表

string

此媒体对象的名称。

string

此媒体对象的说明。

string

指向媒体内容的网址。

object (MediaImage)

与媒体卡片一起显示的图片。

object (Image)

大图片，例如影集的封面等。

object (Image)

标题右侧会显示一个小图片图标。其大小已调整为 36x36 dp。

string

合集的标题。可选。

string

合集的副标题。可选。

object (CollectionItem)

最小值：2 最大值：10

enum (ImageFill)

集合项的图片背景的填充方式。可选。

string

必需。与关联类型中的条目键名匹配的 NLU 键。

string

列表的标题。可选。

string

列表的副标题。可选。

object (ListItem)

最小值：2 最大值：30

string

必需。与关联类型中的条目键名匹配的 NLU 键。

string

必需。建议内容信息卡中显示的文本。用户点按后，这些文字会一字不差地重新发布到对话中，就如同用户已经输入了一样。每个标题在一组建议内容信息卡中必须是唯一的。最多 25 个字符

object (ExecutionEvent)

事件列表，其中详细说明了在 Actions Builder 互动模型的各个阶段中，该轮对话的处理情况。为 Actions Builder 和仅限 Actions SDK 应用。

string (Timestamp format)

事件发生时的时间戳。

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

object (ExecutionState)

此事件期间的执行状态。

object (Status)

特定执行步骤的结果状态。

string

此事件执行期间生成的警告列表。警告是在对话请求过程中为开发者发现的提示。这些通常是非关键的，不会中断请求的执行。例如，当网络钩子尝试替换不存在的自定义类型时，可能会生成警告。错误会报告为失败的状态代码，但即使状态为正常，也可能会显示警告。

object (UserConversationInput)

用户输入处理事件。

object (IntentMatch)

intent 匹配事件。

object (ConditionsEvaluated)

条件评估事件。

object (OnSceneEnter)

OnSceneEnter 执行事件。

object (WebhookRequest)

网络钩子请求调度事件。

object (WebhookResponse)

网络钩子响应接收事件。

object (WebhookInitiatedTransition)

网络钩子发起的转换事件。

object (SlotMatch)

广告位匹配事件。

object (SlotRequested)

广告位请求事件。

object (SlotValidated)

槽验证事件。

object (FormFilled)

表单填写事件。

object (WaitingForUserInput)

Waiting-for-user-input 事件。

object (EndConversation)

会话结束事件。

string

当前处于活动状态的场景的 ID。

object (Struct format)

会话存储的状态：https://developers.google.com/assistant/conversational/storage-session

object (Slots)

槽的填充状态（如果适用）：https://developers.google.com/assistant/conversational/scenes#slot_filling

object (Prompt)

提示队列：https://developers.google.com/assistant/conversational/prompts

object (Struct format)

用户存储空间的状态：https://developers.google.com/assistant/conversational/storage-user

object (Struct format)

家庭存储空间的状态：https://developers.google.com/assistant/conversational/storage-home

enum (SlotFillingStatus)

槽填充的当前状态。

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

与当前场景关联的槽。

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。

enum (SlotMode)

槽的模式（必需或可选）。可由开发者设置。

enum (SlotStatus)

广告位的状态。

value (Value format)

广告位的值。在响应中更改此值，会修改槽填充中的值。

boolean

指明槽值是否在上次回合时收集。此字段为只读字段。

object (Prompt)

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

integer

状态代码，应为 google.rpc.Code 的枚举值。

string

面向开发者的错误消息（应采用英语）。任何向用户显示的错误消息都应进行本地化并通过 google.rpc.Status.details 字段发送，或者由客户端进行本地化。

object

包含错误详细信息的消息列表。有一组通用的消息类型可供 API 使用。

可以包含任意类型字段的对象。附加字段 "@type" 包含用于标示相应类型的 URI。示例：{ "id": 1234, "@type": "types.example.com/standard/id" }。

string

用户输入的类型。例如：键盘、语音、触摸等

string

用户输入的原始文本。

string

触发此互动的 intent ID。

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

触发此互动的意图参数。

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。

string

附加到此互动的处理程序的名称。

string

此互动所导致的场景。

object (Condition)

评估结果为“false”的条件列表。

object (Condition)

计算结果为“true”的第一个条件（如果有）。

string

在此条件中指定的表达式。

string

在评估条件中指定的处理程序名称。

string

在评估条件中指定的目标场景。

string

在 onSceneEnter 事件中指定的处理程序名称。

string

webhook 请求的载荷。

string

webhook 响应的载荷。

string

过渡效果转到的场景的 ID。

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

由 NLU 从用户输入中提取的参数。

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。

string

所请求广告位的名称。

object (Prompt)

槽提示。