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 傳回錯誤。舉例來說,如果 group1group2 的成員,則 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

定義成員的郵件傳送偏好設定。這個欄位只有 insertupdateget 方法支援。

可接受的值為:

  • ALL_MAIL:所有訊息都會在抵達後立即傳送。
  • DAILY:每天不超過一則訊息。
  • DIGEST:最多可將 25 封郵件合併為單一郵件。
  • DISABLED:移除訂閱項目。
  • NONE:沒有訊息。
id

string

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

方法

delete

移除群組成員。

get

擷取群組成員的屬性。

hasMember

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

insert

將使用者新增至指定群組。

list

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

patch

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

update

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