大規模管理地點

隨著機構規模擴大，管理地點和權限可能會讓您不堪負荷。本指南將詳細說明管理多個地點的最佳做法，並介紹下列帳戶類型：

帳戶類型

每個帳戶類型在管理地點時都有各自的角色。個人帳戶可以管理機構帳戶，然後取得該機構的使用者群組和營業地點群組權限。個人帳戶就能透過相關聯的營業地點群組管理地點和商家資訊。

個人帳戶

建立 Google 帳戶時，系統會自動為您提供個人帳戶。個人帳戶可以是商家資訊的擁有者和管理員。

機構帳戶

機構帳戶是代表代理商的覆蓋帳戶。您的位置群組和使用者群組會儲存在其中，且機構中的所有成員都能存取這些群組。地點可屬於多個機構。

透過 Google 我的商家帳戶管理 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. 位置管理階層