注意:此 API 的 v4.7 版本已发布!请参阅更新日志。仍暂时允许在链中提供与新冠肺炎 (COVID-19) 相关的帖子。

批量管理营业地点

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

帐号类型

每个帐号类型都会在管理营业地点的过程中扮演一个角色。个人帐号可以管理组织帐号,还可以获取该组织中的用户群组和营业地点组的权限。然后,该个人帐号就可以通过关联的营业地点组管理营业地点和商家信息。

个人帐号

创建 Google 帐号时,系统会自动为您生成个人帐号。个人帐号的角色可以是商家信息的所有者和管理员

组织帐号

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

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

营业地点组帐号

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

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

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

用户群组帐号

如需批量管理权限,请使用用户群组。您可以将个人帐号添加到用户群组。然后授予该用户群组对组织内多个营业地点组的管理权限。该用户群组中的所有个人帐号便可对营业地点组下的营业地点执行管理操作。

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

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

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

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

请求

以下是 accounts.list 请求示例:

HTTP
GET
https://mybusiness.googleapis.com/v4/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,以检索该帐号有权访问的营业地点列表。

例如,如果您想检索属于“张三的营业地点组”的所有营业地点,请发出以下请求:

HTTP
GET
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations
Authorization: Bearer <access_token>

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

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

营业地点管理示意图

下图说明了以下内容:

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