大規模管理營業地點

隨著機構規模成長,管理位置和權限可能會造成負擔。本指南詳細說明管理多個地點的最佳做法,並描述下列帳戶類型:

帳戶類型

每種帳戶類型都具有管理營業地點的角色。個人帳戶可以管理機構帳戶,然後取得該機構中使用者群組和地區群組的權限。接著,個人帳戶即可透過相關聯的地區群組管理地點和商家資訊。

個人帳戶

建立 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,即可擷取該帳戶有權存取的地點清單。

舉例來說,假設您要擷取屬於「陳大明的地區群組」的所有地點,請提出下列要求:

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. 地點管理階層結構