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

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