批量管理营业地点

随着组织的发展,对营业地点和权限的管理 会让您感到无所适从本指南详细介绍了管理多个 位置,并描述了以下账号类型:

账号类型

每种账号类型在营业地点管理方面都有自己的作用。个人账号 可以管理组织账号,然后获取用户群组的权限 和营业地点组。然后,该个人账号便可管理 通过关联的营业地点组宣传营业地点和商家信息。

个人账号

当您创建 Google 账号。个人账号 可以是 商家信息的所有者和管理员

组织账号

一个 组织账号 代表您的 代理机构。 您的营业地点组和用户群组保存在其中,且某个 可以访问这些文件营业地点可以属于多个 组织。

借助 My Business Account Management API,您可以使用 accounts.admins.create 邀请个人账号管理或拥有组织账号的方法。

营业地点组账号

营业地点组 用于管理一组单独的营业地点。您可以使用营业地点组 对多个营业地点批量执行任务。添加个人账号和 定位到某个营业地点组后,这些用户会继承该营业地点组的权限。

您还可以创建营业地点组来对营业地点进行分类,例如按连锁店、 区域或类别营业地点可以同时存在于多个营业地点组中。

借助 My Business Account Management API,您可以使用 accounts.create 方法 创建营业地点组 将营业地点转让给某个营业地点 。您也可以邀请个人账号加入 管理营业地点组。用户 可以直接通过网页界面将营业地点组添加到营业地点组。

用户组账号

如需批量管理权限,请使用 用户群组。 您可以将个人账号添加到用户群组。然后,您可以向该用户 拥有对组织中多个营业地点组的群组管理权限。现在,全部 该用户组中的个人账号可对 。

例如,当新成员加入运营团队时,您可以添加 这样他们就可以立即访问 所有资源向用户授予对各个应用的访问权限需要更长的时间 而且较难管理。

借助 My Business Account Management API,您可以使用 accounts.create 方法 创建用户组。您还可以使用 API 邀请个人账号 管理账号和营业地点的管理员

使用 API 调用所有账号的列表

要列出您有权访问的所有账号及其关联的账号类型,请执行以下操作: 调用 accounts.list 方法 输入您的 OAuth 凭据。通过 一个响应包含了所有账号及其账号 ID name 字段中显示的名称以及账号类型。

请求

以下是 accounts.list 请求示例:

<ph type="x-smartling-placeholder">
</ph> <ph type="x-smartling-placeholder">
</ph>
HTTP
GET
https://mybusinessaccountmanagement.googleapis.com/v1/accounts
Authorization: Bearer <access_token>

响应

以下是 accounts.list 响应示例:

{
    "accounts": [
        {
            "name": "accounts/{accountId}",
            "accountName": "John Doe",
            "type": "PERSONAL",
            "state": {
                "status": "UNVERIFIED"
            },
            "profilePhotoUrl": "//lh5.googleusercontent.com/REDACTED"
        },
        {
            "name": "accounts/{accountId}",
            "accountName": "John Doe’s Location Group",
            "type": "LOCATION_GROUP",
            "role": "OWNER",
            "state": {
                "status": "UNVERIFIED"
            },
            "accountNumber": "{accountNumber}",
            "permissionLevel": "OWNER_LEVEL"
        }
    ]
}

响应中可能会包含本指南中详述的所有账号类型 至您的 accounts.list 请求。评价 账号列表,并确定有权访问 您想要管理的营业地点。然后,调用 accounts.locations.list 替换为特定账号的 name 字段,以便检索 该账号有权访问的营业地点信息

例如,如果您想检索属于“John Doe's”的所有位置, 营业地点组”请提出以下请求:

<ph type="x-smartling-placeholder">
</ph> <ph type="x-smartling-placeholder">
</ph>
HTTP
GET
https://mybusinessbusinessinformation.googleapis.com/v1/{accountId}/locations
Authorization: Bearer <access_token>

响应会返回用户有权访问的营业地点列表,如 如下:

{
    "locations": [
        {
            "name": "locations/{locationId}",
            "locationName": "Test Business",
            ...
        },
        {
            "name": "locations/{locationId}",
            "locationName": "2nd Test Business",
            ...
         }
     ]
}

营业地点管理示意图

下图说明了以下内容:

  • 组织可以包含多个用户群组。
  • 用户群组可以管理多个营业地点组。
  • 营业地点组可以包含多个营业地点。
  • 营业地点可以跨越组织的多个营业地点组。
营业地点管理层次结构
图 1. 营业地点管理层次结构