管理成員資格效期

本頁說明如何更新及擷取群組會員資格到期設定，以及群組擁有者收到的到期通知。

注意： 這項功能僅適用於 Google Workspace Enterprise Standard、Enterprise Plus、Enterprise for Education 和 Cloud Identity 進階版帳戶。

成員資格到期後，群組擁有者、群組管理員、Google Workspace 超級管理員或具備群組管理員權限的 Workspace 委派管理員，就能管理群組和群組對資源的存取權。您可以根據成員資格建立時間或暫時需求限制存取權，而無須手動移除成員。Groups API 可讓會員資格過期，適用於下列用途：

• 資源的限時存取權 (例如，允許某人協助排除正式環境的問題)
• 在通訊群組中暫時加入成員 (例如，在長期專案中暫時將某人納入團隊群組)

只要群組成員具有 MEMBER 角色，就可以套用到所有類型的群組成員 (包括使用者、群組和服務帳戶)。當您為群組成員設定到期日時，該到期日會成為該群組所有子群組成員的預設到期日，除非子群組成員在上層群組中具有直接成員資格，且已套用個別到期日。日後加入的所有子項群組成員，也都會受到這項到期日的影響。

事前準備

設定驗證機制並安裝用戶端程式庫。如要瞭解如何設定 Cloud Identity Groups API，請參閱這篇文章。

新增會員資格期限

如要瞭解如何操作，請參閱「管理 Google 網路論壇的 Google 網路論壇成員資格」或「管理識別資訊對應群組的成員資格」。

更新會員資格到期時間

如要更新會員資格的到期日，請使用父群組的 ID、會員資格的 ID 和 UpdateMembershipRolesParams 資源，呼叫 groups.memberships.modifyMembershipRoles()。由於成員在群組中可以擁有多個 MembershipRole，因此您必須指定哪個角色會設有到期日。目前只有 MEMBER 角色可套用到到期日。

注意： 如要取得會員資格的 ID，請使用父群組的 ID 和成員的 memberKey 呼叫 groups.memberships.lookup()。

要求主體範例

{
  "updateRolesParams": [
    {
      "fieldMask": "expiry_detail.expire_time",
      "membershipRole": {
        "expiryDetail": {
          "expireTime": "2021-10-02T15:01:23Z"
        },
        "name": "MEMBER"
      }
    }
  ]
}

擷取會員資格到期時間

如要擷取會員資格的到期日，請使用父群組 ID 和會員資格 ID 呼叫 groups.memberships.get()。

注意： 如要取得會員 ID，請使用父群組的 ID 和成員的 memberKey 呼叫 groups.memberships.lookup()。

電子郵件通知

當會員即將到期時，系統會自動傳送電子郵件通知給所有群組擁有者。系統會在到期日的 72 小時前傳送通知，如果會員方案會在設定的 72 小時前到期，則會立即傳送通知。系統會以各個群組擁有者偏好的語言傳送通知，這由網域管理員在 Google 管理控制台中定義，或由群組擁有者個別定義。