REST Resource: accounts.admins

資源：管理員

帳戶或地點管理員。

JSON 表示法 
{
  "name": string,
  "admin": string,
  "account": string,
  "role": enum (AdminRole),
  "pendingInvitation": boolean
}
欄位
name

string

無法變更。資源名稱。如果是帳戶管理員，格式如下：accounts/{account_id}/admins/{admin_id}

如果是地點管理員，則格式為：locations/{locationId}/admins/{admin_id}

如果在管理員建立期間設定這個欄位，系統會忽略這個欄位。
admin

string

選用設定。管理員的名稱。初次邀請時，這是指邀請對象的電子郵件地址。在 GET 呼叫中，如果邀請仍處於待處理狀態，系統會傳回使用者的電子郵件地址。否則會顯示使用者的姓名。

只有在管理員建立期間才需要設定此欄位。
account

string

無法變更。「管理員」參照的「帳戶」資源名稱。用於呼叫 location.admins.create 以邀請 LocationGroup 成為管理員。

若在 CREATE 要求中同時設定這個欄位和 admin，系統會優先採用這個欄位，忽略 admin 中的電子郵件地址。

格式：accounts/{account}。
role

enum (AdminRole)

必要欄位。指定這位管理員搭配指定的「帳戶或位置」角色。
pendingInvitation

boolean

僅供輸出。表示這位管理員是否有指定資源的待處理邀請。

AdminRole

表示管理員擁有的存取層級。詳情請參閱說明中心文章。

列舉
ADMIN_ROLE_UNSPECIFIED 未指定。
PRIMARY_OWNER 管理員有擁有者層級存取權，同時也是主要擁有者。(在 UI 中顯示為「主要擁有者」)。
OWNER 管理員有擁有者層級存取權。(UI 中會顯示為「Owner」)。
MANAGER 管理員有管理員存取權。
SITE_MANAGER 可管理社交 (Google+) 專頁。(在使用者介面中顯示為「Site Manager」)。這個 API 不允許建立具有 SITE_MANAGER 角色的帳戶管理員。

方法

create

 邀請指定使用者成為指定帳戶的管理員。

delete

 從指定帳戶中移除指定的管理員。

list

 列出指定帳戶的管理員。

patch

 更新指定帳戶管理員。