批量管理营业地点

随着组织不断发展，营业地点和权限的管理工作可能会让您不堪重负。本指南详细介绍了管理多个营业地点的最佳做法，并介绍了以下帐号类型：

账号类型

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

个人账号

创建 Google 帐号时，系统会自动为您提供个人帐号。个人帐号可以是商家信息的所有者和管理员。

组织账号

组织帐号是代表您的代理机构的上层帐号。您的营业地点组和用户群组保存在其中，组织中的所有成员都有权访问这些组。营业地点可以属于多个组织。

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

营业地点组帐号

营业地点组可用于管理一组营业地点。您可以使用营业地点组对多个营业地点批量执行任务。将个人帐号和用户群组添加到某个营业地点组后，它们会继承该营业地点组的权限。

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

借助 My Business Account Management API，您可以使用 accounts.create 方法创建营业地点组，并将营业地点转移到营业地点组。您还可以使用 API 邀请个人帐号管理营业地点组。您可以通过网页界面直接将用户群组添加到营业地点组。

用户组帐号

如需大规模管理权限，请使用用户群组。您可以将个人帐号添加到用户群组。然后，您可以向该用户群组授予对组织中多个营业地点组的管理权限。现在，用户群组中的所有个人帐号都可以对营业地点组下的营业地点执行管理操作。

例如，当新成员加入运营团队时，您可以直接将其添加到用户群组，他们会立即有权访问其同事有权访问的所有营业地点。向用户授予对各个营业地点的访问权限会花费更长的时间，而且管理起来更困难。

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

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

如需列出您有权访问的所有帐号及其关联的帐号类型，请使用您的 OAuth 凭据调用 accounts.list 方法。响应中包含所有帐号的列表、对应的帐号 ID（显示在 name 字段中）以及帐号类型。

请求

以下是 accounts.list 请求示例：

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 请求的响应中。请查看帐号列表，确定有权访问您要管理的营业地点的特定帐号。然后，使用特定帐号的 name 字段调用 accounts.locations.list，以检索该帐号有权访问的营业地点列表。

例如，如果您想检索属于“John Doe 的营业地点组”的所有营业地点，请发出以下请求：

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. 营业地点管理层次结构