权限

您可以在 Action 中使用权限向用户请求个人数据 从而完成请求例如，一个送餐操作 可以使用设备位置信息权限来请求获取 位置。

向 Action 添加权限后，Google 助理会显示 提供一致的界面，以便向用户请求权限， 向你的 Action 添加信息。

可用权限

您的 Action 可以请求以下权限：

  • DEVICE_PRECISE_LOCATION：请求用户的确切设备位置信息 （坐标和街道地址）。
  • DEVICE_COARSE_LOCATION：请求用户的粗略设备位置信息 （邮政编码和城市）。

设置权限

要为你的 Action 设置权限，你需要在 场景。然后，为要请求的数据权限配置槽。

添加权限槽类型

您可以使用 actions.type.Permission 广告位类型。

要配置此槽类型，请按以下步骤操作：

  1. 前往 Actions 控制台，然后选择或创建 项目。
  2. 点击顶部菜单中的 开发。
  3. 在 Scenes（场景）下，点击要为其添加权限流程的场景。
  4. 在场景的槽位填充部分下，点击 + 以添加新槽位。

  5. 在选择类型下拉列表中，选择 actions.type.Permission 槽类型。

  6. 在输入广告位名称字段中，为广告位命名。

  7. 启用自定义槽值回写以将结果写入会话 参数。

配置槽

您现在可以提供上下文字符串和要授予的权限列表 配置槽上下文字符串是您为何要 请求用户提供信息，并且会在用户 请求向您的 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。

如需查看权限槽的状态，请按以下步骤操作：

  1. 转到 Actions 控制台，然后点击 开发。
  2. 在 Scenes 下，点击包含权限槽的场景。
  3. 在场景的 Condition 部分下，点击 + 以添加新的 条件。

  4. 输入以下条件以检查权限状态（其中 &lt;slot_name&gt; 是您在自己的界面中配置的会话参数的名称 广告位）：

    scene.slots.status == "FINAL" && (session.params.<slot_name>.permissionStatus == "PERMISSION_GRANTED" || session.params.<slot_name>.permissionStatus == "ALREADY_GRANTED")

  5. 在场景的 Condition 部分下，点击 + 以添加新的 条件。

  6. 输入以下条件可处理用户没有 同意共享其信息：

    scene.slots.status == "FINAL"

  7. 在场景的 Condition 部分下，点击 + 以添加新的 条件。

  8. 输入以下条件，以处理用户已经 无需再次询问：

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