您可以在 Action 中使用权限向用户请求个人数据 从而完成请求例如，一个送餐操作 可以使用设备位置信息权限来请求获取 位置。
向 Action 添加权限后，Google 助理会显示 提供一致的界面，以便向用户请求权限， 向你的 Action 添加信息。
可用权限
您的 Action 可以请求以下权限：
DEVICE_PRECISE_LOCATION：请求用户的确切设备位置信息 （坐标和街道地址）。DEVICE_COARSE_LOCATION：请求用户的粗略设备位置信息 （邮政编码和城市）。
设置权限
要为你的 Action 设置权限，你需要在 场景。然后，为要请求的数据权限配置槽。
添加权限槽类型
您可以使用
actions.type.Permission 广告位类型。
要配置此槽类型，请按以下步骤操作：
- 前往 Actions 控制台，然后选择或创建 项目。
- 点击顶部菜单中的 开发。
- 在 Scenes（场景）下，点击要为其添加权限流程的场景。
- 在场景的槽位填充部分下，点击 + 以添加新槽位。
在选择类型下拉列表中，选择
actions.type.Permission槽类型。
在输入广告位名称字段中，为广告位命名。
启用自定义槽值回写以将结果写入会话 参数。
配置槽
您现在可以提供上下文字符串和要授予的权限列表 配置槽上下文字符串是您为何要 请求用户提供信息，并且会在用户 请求向您的 Action 授予权限。
您可以在配置槽中配置上下文字符串和权限 部分，如以下屏幕截图所示：
以下代码段展示了一个槽配置示例：
{
"@type": "type.googleapis.com/google.actions.conversation.v3.PermissionValueSpec",
"context": "Context string",
"permissions": ["DEVICE_PRECISE_LOCATION"]
}
向用户显示的提示将采用"$context_string, I'll 只需从 Google 获取您的当前位置。这样可以吗？”
您可以使用权限代码获取以下用户信息：
| 权限 | 说明 |
|---|---|
DEVICE_PRECISE_LOCATION |
设备的确切位置（坐标和街道地址） |
DEVICE_COARSE_LOCATION |
设备的粗略位置信息（邮政编码和城市） |
获取权限结果
以下部分介绍了如何查看权限状态以及如何读取 用户的信息（如果他们授予权限）。
查看权限状态
当用户授予权限后，系统会将生成的状态写入会话 参数。
您可以通过查看
session.params.<slot_name>.permissionStatus。
如需查看权限槽的状态，请按以下步骤操作：
- 转到 Actions 控制台，然后点击 开发。
- 在 Scenes 下，点击包含权限槽的场景。
- 在场景的 Condition 部分下，点击 + 以添加新的 条件。
输入以下条件以检查权限状态（其中 <slot_name> 是您在自己的界面中配置的会话参数的名称 广告位）：
scene.slots.status == "FINAL" && (session.params.<slot_name>.permissionStatus == "PERMISSION_GRANTED" || session.params.<slot_name>.permissionStatus == "ALREADY_GRANTED")
在场景的 Condition 部分下，点击 + 以添加新的 条件。
输入以下条件可处理用户没有 同意共享其信息：
scene.slots.status == "FINAL"
在场景的 Condition 部分下，点击 + 以添加新的 条件。
输入以下条件，以处理用户已经 无需再次询问：
"DEVICE_PRECISE_LOCATION" in user.permissions
读取用户信息
如果用户授予权限，则会在以下位置提供用户信息： 后续请求。
在以下代码段中，您可以看到设备位置信息
包含在对 device.currentLocation 下的 webhook 的请求内：
| 请求 JSON |
|---|
{ "handler": { "name": "handler" }, "intent": { "name": "", "params": { "deviceLoc": { "original": "", "resolved": { "@type": "type.googleapis.com/google.actions.conversation.v3.PermissionValue", "permissionStatus": "PERMISSION_GRANTED", "grantedPermissions": [ "DEVICE_PRECISE_LOCATION" ] } } }, "query": "Yes" }, "scene": { "name": "Scene", "slotFillingStatus": "FINAL", "slots": { "deviceLoc": { "mode": "REQUIRED", "status": "SLOT_UNSPECIFIED", "value": { "grantedPermissions": [ "DEVICE_PRECISE_LOCATION" ], "@type": "type.googleapis.com/google.actions.conversation.v3.PermissionValue", "permissionStatus": "PERMISSION_GRANTED" }, "updated": true } }, "next": { "name": "actions.scene.END_CONVERSATION" } }, "session": { "id": "session_id", "params": { "deviceLoc": { "grantedPermissions": [ "DEVICE_PRECISE_LOCATION" ], "permissionStatus": "PERMISSION_GRANTED", "@type": "type.googleapis.com/google.actions.conversation.v3.PermissionValue" } }, "typeOverrides": [], "languageCode": "" }, "user": { "locale": "en-US", "params": {}, "accountLinkingStatus": "ACCOUNT_LINKING_STATUS_UNSPECIFIED", "verificationStatus": "VERIFIED", "packageEntitlements": [], "permissions": [ "DEVICE_PRECISE_LOCATION" ], "lastSeenTime": "2021-02-08T20:43:47Z" }, "home": { "params": {} }, "device": { "capabilities": [ "SPEECH", "RICH_RESPONSE", "LONG_FORM_AUDIO" ], "currentLocation": { "coordinates": { "latitude": 37.422, "longitude": -122.084 }, "postalAddress": { "revision": 0, "regionCode": "US", "languageCode": "en", "postalCode": "94043", "sortingCode": "", "administrativeArea": "California", "locality": "Mountain View", "sublocality": "", "addressLines": ["1600 Amphitheatre Parkway"], "recipients": [], "organization": "" } } } } |
如需详细了解位置类型的架构，请参阅
Location 参考文档。
您可以通过 webhook 访问请求中包含的信息，如下所示： 在以下代码段中：
| 网络钩子 |
|---|
app.handle('handler', (conv) => { let location = conv.device.currentLocation; conv.add(`Your postal code is ${location.postalCode}`); }); |
在提示中使用权限
您还可以在静态提示中引用该权限。例如，对于设备位置信息，
您可以使用 $device.currentLocation.coordinates.* 和 $device.currentLocation.postalAddress.*。
以下代码段展示了如何在提示中引用用户所在的城市：
candidates:
- first_simple:
variants:
- speech: >-
There are no events scheduled tomorrow in the city of $device.currentLocation.postalAddress.locality.