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:一天不超過 1 封郵件。
  • DIGEST:單一訊息中最多可包含 25 封郵件。
  • DISABLED:移除訂閱項目。
  • NONE:沒有訊息。
id

string

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

方法

delete

從群組中移除成員。

get

擷取群組成員的屬性。

hasMember

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

insert

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

list

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

patch

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

update

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