REST Resource: members

資源：Member

Google 網路論壇成員可以是使用者或其他群組。這個成員可以是帳戶網域內或外的使用者。如要進一步瞭解常見的群組成員工作，請參閱《開發人員指南》。

JSON 表示法 
{
  "kind": string,
  "email": string,
  "role": string,
  "etag": string,
  "type": string,
  "status": string,
  "delivery_settings": string,
  "id": string
}
欄位
kind

string

API 資源的類型。如果是 Members 資源，這個值為 admin#directory#member。
email

string

成員的電子郵件地址。成員可以是使用者或其他群組。將成員加入群組時，必須使用這個屬性。email 不得重複，且不得是其他群組的別名。如果電子郵件地址有所變更，API 會自動反映電子郵件地址變更。
role

string

成員在群組中的角色。API 會針對群組成員資格中的循環傳回錯誤。舉例來說，如果 group1 是 group2 的元素，group2 就不能是 group1 的元素。如要進一步瞭解成員的角色，請參閱「為成員指派群組角色」。

可接受的值如下：

  • MANAGER：只有在使用管理控制台啟用 Google 網路論壇企業版時，才能使用這個角色。請參閱「開啟或關閉網路論壇企業版」。MANAGER 角色可執行 OWNER 角色的所有操作，但無法將成員設為 OWNER 或刪除群組。群組可包含多個 MANAGER 成員。
  • MEMBER：這個角色可以訂閱群組、查看討論封存資料，以及查看群組成員名單。如要進一步瞭解成員角色，請參閱「為成員指派群組角色」。
  • OWNER：這個角色可傳送訊息給群組、新增或移除成員、變更成員角色、變更群組設定，以及刪除群組。OWNER 必須是群組的成員。群組可以包含多個 OWNER。
etag

string

資源的 ETag。
type

string

群組成員的類型。

可接受的值如下：

  • CUSTOMER：成員代表網域中的所有使用者。系統不會傳回電子郵件地址，而是傳回客戶 ID。
  • EXTERNAL：成員是網域外的使用者或群組。(目前未使用)
  • GROUP：成員是其他群組。
  • USER：成員是使用者。
status

string

成員狀態 (不可變動)
delivery_settings

string

定義成員的郵件傳送偏好設定。這個欄位僅支援 insert、update 和 get 方法。

可接受的值如下：

  • ALL_MAIL：所有訊息，一收到就會傳送。
  • DAILY：每天最多只能傳送一則訊息。
  • DIGEST：系統最多會將 25 封郵件合併為一封郵件。
  • DISABLED：移除訂閱項目。
  • NONE：沒有訊息。
id

string

群組成員的專屬 ID。成員 id 可用於成員要求 URI 的 memberKey。

方法

delete

 從群組中移除成員。

get

 擷取群組成員的屬性。

hasMember

 檢查指定使用者是否為群組成員。

insert

 將使用者加入指定群組。

list

 擷取群組中所有成員的分頁清單。

patch

 更新指定群組中使用者的會員屬性。

update

 更新指定群組中使用者的成員資格。