Files

object (ConfigFile)

多个配置文件。

string

SDK 文件结构中项目根目录下的配置文件的相对路径。以下每种文件类型都有允许的文件路径。例如：settings/settings.yaml

object (Manifest)

单个清单文件。允许的文件路径：manifest.yaml

object (Actions)

定义了所有操作的单个操作文件。允许的文件路径：actions/{language}?/actions.yaml

object (Settings)

单个设置配置，其中包含不可本地化的设置以及项目默认语言区域（如果已指定）的设置。对于语言区域替换文件，系统只会填充 localizedSettings 字段。允许的文件路径：settings/{language}?/settings.yaml。请注意，非本地化设置文件 settings/settings.yaml 必须存在于写入流请求中。

object (Webhook)

单个 webhook 定义。允许的文件路径：webhooks/{WebhookName}.yaml

object (Intent)

单一 intent 定义。允许的文件路径：custom/intents/{language}?/{IntentName}.yaml

object (Type)

单一类型定义。允许的文件路径：custom/types/{language}?/{TypeName}.yaml

object (EntitySet)

单个实体集定义。允许的文件路径：custom/entitySets/{language}?/{EntitySetName}.yaml

object (GlobalIntentEvent)

单个全局 intent 事件定义。允许的文件路径：custom/global/{GlobalIntentEventName}.yaml。文件名 (GlobalIntentEventName) 应该是此全局 intent 事件对应的 intent 的名称。

object (Scene)

单场景定义。允许的文件路径：custom/scenes/{SceneName}.yaml

object (StaticPrompt)

单个静态提示定义。允许的文件路径：custom/prompts/{language}?/{StaticPromptName}.yaml

object (AccountLinkingSecret)

与账号关联中使用的客户端密钥对应的元数据。允许的文件路径：settings/accountLinkingSecret.yaml

object (Struct format)

单个资源包，即从字符串到字符串或字符串列表的映射。资源包可用于将静态提示中的字符串本地化。允许的文件路径：resources/strings/{language}?/{multiple directories}?/{BundleName}.yaml

string

文件格式的版本。当前文件格式版本为 1.0。示例：“1.0”

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

从 intent 映射到自定义 Action，以便为项目配置调用。调用 intent 可以是“custom/intents/”中定义的系统 intent 或自定义 intent。软件包。此处定义的所有 intent（系统 intent 和自定义 intent）在“custom/global/”中都必须有对应的 intent 文件。软件包。

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

object (Engagement)

与操作相关的互动机制，用于帮助最终用户订阅推送通知和每日动态。请注意，每日更新/推送通知槽配置中指定的 intent 名称需要与此操作对应的 intent 一致，最终用户才能订阅这些更新。

string

互动的标题，将发送给最终用户，请求他们同意接收更新。向最终用户发送每日动态的提示类似于“您希望我何时发送每日{title}”推送通知将类似于“Is it ok if I send push notifications for {title}”。此字段可本地化。

object (PushNotification)

此互动支持的推送通知设置。

object (ActionLink)

操作的链接配置，用于确定是否为此操作启用共享链接；如果启用了共享链接，则包含链接的用户友好显示名称。ActionLink 已弃用。请改用 AssistantLink。

object (AssistantLink)

操作的链接配置，用于确定是否为此操作启用共享链接；如果启用了共享链接，则包含链接的用户友好显示名称。

object (DailyUpdate)

此互动支持的每日更新设置。

string

方便用户使用的链接显示标题。

string

方便用户使用的链接显示标题。

string

Actions 项目 ID。

string

项目默认设置的语言区域。对于除 resources/ 下且路径中不包含语言区域的所有文件，本地化数据将归因于此 defaultLocale。对于 resources/ 下的文件，没有语言区域意味着资源适用于所有语言区域。

string

表示用户可以在哪些区域调用您的 Action，这取决于用户所在的位置。如果设置了 disabledRegions，则无法设置。如果未指定 enabledRegions 和 disabledRegions，则用户可以在所有区域调用您的 Action。每个区域使用 AdWords 地理位置定位的规范名称表示。请参阅 https://developers.google.com/adwords/api/docs/appendix/geotargeting 示例包括：-“德国”-“加纳”-“希腊”- “格林纳达”-“英国”-“美国”-“美国本土外小岛屿”- “乌拉圭”

string

表示根据用户所在位置确定您的 Action 被禁止的区域。如果设置了 enabledRegions，则无法设置。每个区域使用 AdWords 地理位置定位的规范名称表示。请参阅 https://developers.google.com/adwords/api/docs/appendix/geotargeting 示例包括：-“德国”-“加纳”-“希腊”- “格林纳达”-“英国”-“美国”-“美国本土外小岛屿”- “乌拉圭”

enum (Category)

此 Actions 项目的类别。

boolean

Action 是否可以使用交易（例如，预订、接受订单等）。如果为 false，则尝试使用 Transaction API 将失败。

boolean

Action 能否执行数字商品交易。

boolean

Action 是否使用 Interactive Canvas。

boolean

Action 是否使用家庭存储功能。

boolean

Action 内容是否专为家庭设计 (DFF)。

boolean

Action 是否包含与酒精饮料或烟草相关的内容。

boolean

操作是否可以在对话期间让麦克风保持打开状态，而不显示明确提示。

object (SurfaceRequirements)

客户端 Surface 在调用此项目中的 Action 时必须支持的 Surface 要求。

string

面向 Action 审核者提供的自由形式的测试说明（例如账号关联说明）。

object (LocalizedSettings)

项目默认语言区域的本地化设置。每个额外的语言区域都应该在其各自的目录中拥有自己的设置文件。

object (AccountLinking)

允许用户通过 Google 登录功能和/或您自己的 OAuth 服务创建或关联账号。

string

已选择通过 Google Play 进行购买交易的 Android 应用。这是从关联到 Action 项目的 Android 应用中选择，用于验证品牌所有权和启用其他功能。如需了解详情，请参阅 https://developers.google.com/assistant/console/brand-verification。

object (CapabilityRequirement)

在项目中调用 Action 所需的最小功能集。如果 surface 缺少其中任何一项，都不会触发 Action。

enum (SurfaceCapability)

功能的类型。

string

必需。此 Actions 项目的默认显示名称（如果没有可用的翻译）

string

必需。显示名称的发音，以便在语音（讲话）上下文中调用。

string

必需。Actions 项目的默认简短说明（如果没有翻译版本）。上限为 80 个字符。

string

必需。Actions 项目的默认详细说明（如果没有翻译版本）。上限为 4,000 个字符。

string

必需。小方形图片，192 x 192 像素。应将其指定为对 resources/images/ 目录中相应图片的引用。例如，对 resources/images/foo.jpg 中的映像使用 $resources.images.foo（不带扩展名）处理从控制台拉取的项目时，可以使用拉取的由 Google 管理的网址。不允许使用来自外部来源的网址。

string

可选。大型横向图片，1920 x 1080 像素。应将其指定为对 resources/images/ 目录中相应图片的引用。例如，对 resources/images/foo.jpg 中的映像使用 $resources.images.foo（不带扩展名）处理从控制台拉取的项目时，可以使用拉取的由 Google 管理的网址。不允许使用来自外部来源的网址。

string

必需。要向用户显示的开发者名称。

string

必需。开发者的联系电子邮件地址。

string

可选。服务条款网址。

string

必需。用户与您的 Action 互动时听到的 Google 助理语音类型。支持的值包括“male_1”、“male_2”、“female_1”和“female_2”。

string

可选。指定语音的语言区域。如果未指定，则解析为用户的 Google 助理语言区域。如果指定，则语音语言区域的根语言必须与 LocalizedSettings 中指定的语言区域相同。

string

必需。隐私权政策网址。

string

可选。示例调用短语，作为您的 Actions 项目说明的一部分显示在 Google 助理目录中。这将帮助用户了解如何使用它。

object (ThemeCustomization)

可选。针对 Action 的视觉组件的主题自定义。

string

卡片的背景颜色。如果开发者未提供 background_image 或 background_image 不适用于某些 surface，则充当后备选项。用法示例：#FAFAFA

string

操作的主要主题颜色将用于为 Actions on Google 卡片设置标题的文字颜色和操作项的背景颜色。用法示例：#FAFAFA

string

卡片标题将会使用的字体系列。支持的字体： - Sans Serif - Sans Serif Medium - Sans Serif Bold - Sans Serif Black - Sans Serif Condensed - Sans Serif Condensed Medium - Serif - Serif Bold - Mons Serif Bold - Sans Serif Black - Sans Serif Condensed Medium - Serif - Serif Bold - 小号字体

enum (ImageCornerStyle)

卡片前景图片的边框样式。例如，可应用于基本卡片或轮播卡片的前景图片。

string

横屏模式（最小 1920x1200 像素）。应将其指定为对 resources/images/ 目录中相应图片的引用。例如：对 resources/images/foo.jpg 中的映像使用 $resources.images.foo（无扩展名）在处理从控制台拉取的项目时，可以使用拉取的 Google 管理的网址。

string

竖屏模式（最小 1200x1920 像素）。应将其指定为对 resources/images/ 目录中相应图片的引用。例如：对于 resources/images/foo.jpg 中的映像，使用 $resources.images.foo（不带扩展名）在处理从控制台拉取的项目时，可以使用拉取的由 Google 管理的网址。

boolean

必需。如果设为 true，用户就可以通过语音注册新账号。如果设为 false，则仅允许在您的网站上创建账号。如果您想在注册期间显示您的服务条款或征求用户同意，请选择此选项。当此类型为 false 时，linkingType 不能为 GOOGLE_SIGN_IN。如果关联类型为 true，则关联类型不能为 OAUTH。

enum (LinkingType)

必需。要使用的关联类型。如需详细了解关联类型，请参阅 https://developers.google.com/assistant/identity。

enum (AuthGrantType)

可选。表示 OAUTH linksType 的身份验证类型。

string

可选。您的应用发送给 Google 的客户端 ID。这是用于向您的服务标识 Google 的 OAuth2 客户端 ID。仅在使用 OAuth 时设置。

string

可选。支持 OAuth2 代码或隐式流程的登录网页的端点。网址必须使用 HTTPS。仅在使用 OAuth 时设置。

string

可选。用于交换令牌的 OAuth2 端点。网址必须使用 HTTPS。仅当将 OAuth 与 IMPLICIT 授权用作关联类型时，才未设置此关联类型。仅在使用 OAuth 时设置。

string

可选。用户必须同意才能使用您的服务的权限列表。仅在使用 OAuth 时设置。如果指定此字段，请务必在 LocalizedSettings.terms_of_service_url 部分中的目录信息中提供服务条款。

string

可选。这是您服务中的网页，其中描述了用户向 Google 授予的权限。仅在使用 OAuth 和 Google 登录时才设置。如果指定此字段，请务必在 LocalizedSettings.terms_of_service_url 部分中的目录信息中提供服务条款。

boolean

可选。如果为 true，则允许 Google 通过 HTTP 基本身份验证标头传输客户端 ID 和密钥。否则，Google 会在 post 正文中使用客户端 ID 和密钥。仅在使用 OAuth 时设置。如果指定此字段，请务必在 LocalizedSettings.terms_of_service_url 部分中的目录信息中提供服务条款。

object (Handler)

此网络钩子的处理程序列表。

object (HttpsEndpoint)

自定义 webhook HTTPS 端点。

object (InlineCloudFunction)

从 webhook 文件夹中的代码部署的 Cloud Functions 函数的元数据。

string

必需。处理程序的名称。在 Actions 项目的所有处理程序中必须是唯一的。您可以查看此处理程序的名称，以便在您的执行方式源代码中调用正确的函数。

string

执行方式端点的 HTTPS 基准网址（不支持 HTTP）。处理程序名称会附加到基准网址路径中的冒号后（遵循 https://cloud.google.com/apis/design/custom_methods) 中的样式指南）。例如，基准网址“https://gactions.service.com/api”会收到带有网址“https://gactions.service.com/api:{method}”的请求。

map (key: string, value: string)

要包含在 POST 请求中的 HTTP 参数的映射。

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

integer

端点使用的协议的版本。这是所有执行方式类型所共用的协议，并非特定于 Google 执行方式类型。

string

Cloud Functions 函数入口点的名称。此字段的值应与从源代码导出的方法的名称一致。

object (IntentParameter)

训练短语中的参数列表。必须在此处定义所有参数，才能在训练短语中使用。

string

通过训练短语，Google 的 NLU 会自动将意图与用户输入进行匹配。提供的唯一短语越多，此意图匹配的可能性就越大。以下是带注释的训练短语部分的格式。请注意，auto 字段为可选字段，如果未指定 auto，则默认行为等同于 auto=false。($<paramName> '<sample text>' auto=<true or false>) auto = true 表示相应部分由 NLU 自动注释。auto = false 表示用户已对该部分添加注解。如果未指定 auto，则这是默认值。例如：“预订从 ($source 'San Francisco' auto=false) 飞往（$dest '温哥华'）的航班”

string

必需。intent 参数的唯一名称。可在条件和响应中使用，以引用由 NLU 通过 $intent.params.[name].resolved 提取的 intent 参数

object (ClassReference)

可选。声明此参数的数据类型。不应为内置 intent 设置此字段。

object (EntitySetReferences)

可选。对此 intent 参数允许的实体集的引用。仅对内置 intent 的参数有效。这些引用指向“custom/entitySets”中的实体集目录。

string

必需。参数的内置类型或自定义类型的名称。示例：PizzaToppings、actions.type.Number

boolean

可选。指示数据类型是否表示值列表。

object (EntitySetReference)

必需。intent 参数的实体集引用。

string

必需。确定要用于给定参数的特定实体集合。相应的实体集定义应该存在于 custom/entitySets/ 目录中。

string

一组不应按类型匹配的异常字词/短语。注意：如果字词/短语与类型匹配，但被列为排除项，则不会在参数提取结果中返回。此字段可本地化。

object (SynonymType)

同义词类型，本质上是一个枚举。

object (RegularExpressionType)

正则表达式类型，允许正则表达式匹配。

object (FreeTextType)

FreeText 类型。

enum (MatchType)

可选。同义词的匹配类型。

boolean

可选。如果设置为 true，系统将根据周围的输入和意图训练数据（例如可能添加到购物清单中的商品）匹配未知的字词或词组。

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

必需。同义词实体的命名映射。

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

object (EntityDisplay)

可选。实体显示详细信息。

string

可选。实体的同义词列表。此字段可本地化。

string

可选。图标的标题。

string

必需。图标的网址。

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

必需。实体的命名映射，每个实体都包含正则表达式字符串。

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

object (EntityDisplay)

可选。从查询中提取实体后将在画布上显示的元素。仅适用于支持画布的应用。

string

必需。使用 RE2 正则表达式语法（请参阅 https://github.com/google/re2/wiki/Syntax 了解详情）

object (EntityDisplay)

可选。从查询中提取实体后将在画布上显示的元素。仅适用于支持画布的应用。

object (Entity)

必需。此实体集支持的实体列表。

string

必需。实体的 ID。如需查看内置 intent 参数及其支持的实体的列表，请参阅 https://developers.google.com/assistant/conversational/build/built-in-intents

string

可选。对话应跳转到的目标场景。当前场景的状态会在转场时被销毁。

object (EventHandler)

可选。匹配 intent 时触发的事件处理脚本。应在过渡到目标场景之前执行。可用于生成提示以响应事件。

string

要调用的 webhook 处理程序的名称。

object (StaticPrompt)

内嵌静态提示。可以包含对软件包中字符串资源的引用。

string

要调用的静态提示的名称。

object (StaticPromptCandidate)

要发送给客户的候选提示列表。每个提示都有一个选择器，用于确定何时可以使用该提示。系统会发送与请求匹配的第一个选择器，并忽略其余选择器。

object (Selector)

可选。判断此提示是否与请求匹配的条件。如果选择器为空，则始终会触发此提示。

object (StaticPromptResponse)

与选择器关联的提示响应。

object (SurfaceCapabilities)

所需的 Surface 功能集。

enum (Capability)

必需。向 Action 发出请求的界面的功能。

object (StaticSimplePrompt)

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

object (StaticContentPrompt)

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

object (StaticSimplePrompt)

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

object (Suggestion)

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

object (StaticLinkPrompt)

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

boolean

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

object (StaticCanvasPrompt)

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

object (Variant)

可能的变体列表。

string

可选。表示向用户说出的语音。可以是 SSML 或文字转语音。默认情况下，语音将附加到上一个简单提示的语音。如果包含提示中的 override 字段为 true，则此字段中定义的语音将替换上一个简单提示的语音。

string

可选。要在聊天气泡中显示的文本。如果未指定，系统将使用呈现方式呈现上面的语音字段。不得超过 640 个字符。默认情况下，文本将附加到上一个简单提示的文本。如果包含提示中的 override 字段为 true，则此字段中定义的文本将替换上一个简单提示的文本。

object (StaticCardPrompt)

基本卡片。

object (StaticImagePrompt)

图片。

object (StaticTablePrompt)

表格卡片。

object (StaticMediaPrompt)

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

object (StaticListPrompt)

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

object (StaticCollectionPrompt)

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

object (StaticCollectionBrowsePrompt)

一张卡片，显示了一系列可打开的网页。

string

可选。卡片的总体标题。

string

可选。卡片的副标题。

string

必需。所需的卡片正文（除非显示图片）。支持一组数量有限的 Markdown 语法。

object (StaticImagePrompt)

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

enum (ImageFill)

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

object (StaticLinkPrompt)

可选。要在卡片中显示的可点击按钮。

string

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

string

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

integer

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

integer

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

string

链接名称

object (OpenUrl)

定义用户打开链接时的行为。

string

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

enum (UrlHint)

表示网址类型的提示。

string

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

string

可选。表格的副标题。

object (StaticImagePrompt)

可选。与表关联的图片。

object (TableColumn)

可选。标题和列的对齐方式。

object (TableRow)

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

object (StaticLinkPrompt)

可选。按钮。

string

列的标题文本。

enum (HorizontalAlignment)

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

object (TableCell)

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

boolean

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

string

单元格的文本内容。

enum (MediaType)

此响应的媒体类型。

string (Duration format)

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

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

enum (OptionalMediaControls)

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

object (MediaObject)

媒体对象的列表。

enum (RepeatMode)

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

string

此媒体对象的名称。

string

此媒体对象的说明。

string

指向媒体内容的网址。

object (MediaImage)

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

object (StaticImagePrompt)

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

object (StaticImagePrompt)

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

string

可选。列表的标题。

string

可选。列表的副标题。

object (ListItem)

必需。列出项。

string

必需。与关联类型中的条目键名称匹配的 NLU 键。点按项后，此键将作为选择选项参数发回。

string

必需。商品的标题。用户点按后，这些文字会一字不差地重新发布到对话中，就如同用户已经输入了一样。每个标题在一组项中必须是唯一的。

string

可选。商品的正文。

object (StaticImagePrompt)

可选。商品图片。

string

可选。合集的标题。

string

可选。合集的副标题。

object (CollectionItem)

必需。合集项。

enum (ImageFill)

可选。图片显示选项的类型。

string

必需。与关联类型中的条目键名匹配的 NLU 键。点按项后，此键将作为选择选项参数发回。

string

必需。商品的标题。用户点按后，这些文字会一字不差地重新发布到对话中，就如同用户已经输入了一样。每个标题在一组项中必须是唯一的。

string

可选。商品的正文。

object (StaticImagePrompt)

可选。商品图片。

object (CollectionBrowseItem)

浏览集合中的项。名单规模应在 [2, 10] 范围内。

enum (ImageFill)

集合中的图片的图片显示选项。

string

必需。集合项的标题。

string

集合项的说明。

string

集合项的页脚文本，显示在说明下方。一行文本，用省略号截断。

object (StaticImagePrompt)

合集项的图片。

object (OpenUrl)

必需。在项被选中后打开的 URI。

string

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

string

必需。要加载的网页视图的网址。

value (Value format)

可选。要作为事件传递到沉浸式体验网页的 JSON 数据。如果所包含的提示中的 override 字段是此 Canvas 提示中定义的 false 数据值，则将在之前的 Canvas 提示中定义的数据值之后添加。

boolean

可选。如果值为 true，则在向用户呈现此沉浸式响应后，系统不会打开麦克风来捕获输入。

boolean

可选。如果为 true，则包含与对话相关的元数据并发送回画布应用。

boolean

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

object (EventHandler)

过渡到此场景时要调用的处理程序。

object (IntentEvent)

基于意图触发的事件列表。这些事件可在调用 on_load 处理程序后随时触发。重要提示 - 这些事件定义了范围限定为此场景的一组 intent，其优先级将高于具有相同 intent 或其触发短语的任何全局定义的事件。intent 名称在场景中必须是唯一的。

object (ConditionalEvent)

根据条件语句触发的事件列表。这些是在表单填充后评估的；如果场景没有表单，则会立即在 on_load 之后进行评估（评估仅执行一次）。系统只会触发第一个匹配事件。

object (Slot)

有序的槽列表。每个槽位均定义其将解析的数据类型，并对其进行配置以自定义此解决方案的体验（例如提示）。

object (EventHandler)

当槽的状态更改不是由另一个处理程序中的更新引起的时调用的处理程序。这会使槽失效、场景失效或对场景状态进行其他更改。

string

必需。触发事件的 intent。

string

可选。对话应跳转到的目标场景。当前场景的状态会在转场时被销毁。

object (EventHandler)

可选。匹配 intent 时触发的事件处理脚本。应在过渡到目标场景之前执行。可用于生成提示以响应事件。

string

必需。此事件要触发的过滤条件。如果条件评估结果为 true，则会触发关联的 handler。支持以下变量引用：$session - 用于引用会话存储空间中的数据。$user - 用于引用用户存储空间中的数据。支持以下布尔值运算符（带示例）：&& - session.params.counter > 0 && session.params.counter < 100 || - session.params.foo == "John" || session.params.counter == "Adam" ! - !(session.params.counter == 5) 支持以下比较运算符：==、!=、<、>、<=、>= 支持以下列表和字符串运算符（示例）：in -“西瓜”session.params.fruitList size - size(session.params.fruitList) > 2 substring - session.params.fullName.contains("John")

string

可选。当关联条件评估为 true 时，对话应跳转到的目标场景。当前场景的状态会在转场时被销毁。

object (EventHandler)

可选。在关联条件的评估结果为 true 时触发的事件处理脚本。应在过渡到目标场景之前执行。可用于生成提示以响应事件。

string

必需。广告位的名称。

object (ClassReference)

必需。声明此槽的数据类型。

boolean

可选。指明是否需要在推进前填充广告位。未填充的必需槽会触发向用户发送可自定义的提示。

object (PromptSettings)

可选。为槽位填充的不同阶段注册提示。

object (CommitBehavior)

可选。与槽相关的提交行为。

value (Value format)

可选。与用于填充槽的槽相关联的其他配置。配置的格式取决于槽类型。您可以将对用户或会话参数的资源引用添加到此配置中。需要此配置才能填充与交易和用户互动相关的槽。

示例：对于 actions.type.CompletePurchaseValue 类型的广告位，以下配置引用了客户端定义的会话参数 userSelectedSkuId，提出了一个数字商品订单：

{ "@type": "type.googleapis.com/ google.actions.transactions.v3.CompletePurchaseValueSpec", "skuId": { "skuType": "SKU_TYPE_IN_APP", "id": "$session.params.userSelectedSkuId", "packageName": "com.example.company"} }

object (DefaultValue)

可选。用于为此广告位填充默认值的配置。

object (EventHandler)

提示槽值本身。示例：“您想要多大的尺寸？”

object (EventHandler)

当用户首次输入与槽的预期值类型不匹配时给出的提示。例如：“抱歉，我没听明白。”

object (EventHandler)

当用户第二次输入与空档的预期值类型不符时给出的提示。例如：“抱歉，我没听明白。”

object (EventHandler)

当用户上次输入的内容与槽的预期值类型不匹配时给出的提示。例如：“抱歉，我没听明白。”

object (EventHandler)

用户首次未提供输入内容时给出的提示。例如：“抱歉，我没听明白。”

object (EventHandler)

当用户第二次未提供输入内容时提示。例如：“抱歉，我没听明白。”

object (EventHandler)

用户上次未提供输入内容时给出的提示。例如：“抱歉，我没听明白。”

string

用于在填充广告位后写入广告位值的会话参数。请注意，目前不支持嵌套路径。“$$”用于将槽值写入与槽名称相同的会话参数。例如：writeSessionParam = "fruit"对应于“$session.params.fruit”。writeSessionParam = “ticket”对应于“$session.params.ticket”。

string

可选。用于初始化槽值的会话参数（如果它具有非空值）。该值的类型必须与广告位的类型一致。请注意，目前不支持嵌套路径。例如：sessionParam = "fruit" 对应于 $session.params.fruit。sessionParam = "ticket" 对应于 $session.params.ticket。

value (Value format)

可选。槽的常量默认值。仅当未通过 sessionParam 填充此广告位的值时，才会用到此字段。此值的类型必须与广告位的类型一致。

object (DataFile)

多个数据文件。

string

SDK 文件结构中项目根目录下的数据文件的相对路径。允许使用的文件路径：- 图片：resources/images/{multiple directories}?/{ImageName}.{extension} - 音频：resources/audio/{multiple directories}?/{AudioFileName}.{extension} - 内嵌 Cloud Functions 函数代码：webhooks/{WebhookName}.zip 允许的扩展名：- 图片：png、jpg、jpeg - 音频：mp3、mpeg - 内嵌 Cloud Functions 函数：zip

string

必需。此资产的内容类型。示例：text/html。内容类型必须符合规范 (http://www.w3.org/Protocols/rfc1341/4_Content-Type.html)。Cloud Functions 函数必须采用 ZIP 格式，并且内容类型应为 application/zip;zip_type=cloud_function。zip_type 参数表示 ZIP 用于 Cloud Functions 函数。

string (bytes format)

数据文件的内容。示例包括图片、音频文件或 Cloud Functions 函数 ZIP 格式的原始字节。载荷大小有 10 MB 严格限制。

使用 base64 编码的字符串。