REST Resource: members

資源：成員

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

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

string

API 資源的類型。「成員」資源的值為 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 為客戶 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

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