Mengelola masa berlaku keanggotaan

Halaman ini menjelaskan cara memperbarui dan mengambil setelan habis masa berlaku untuk keanggotaan grup, serta notifikasi habis masa berlaku yang diterima pemilik grup.

Masa berlaku keanggotaan memungkinkan pemilik grup, pengelola grup, Admin Super Google Workspace, atau Admin Delegasi Workspace dengan hak istimewa admin grup untuk mengelola grup dan akses berbasis grup ke resource. Akses dapat dibatasi berdasarkan penghentian keanggotaan atau kebutuhan sementara tanpa menghapus anggota secara manual. Groups API memungkinkan akhir masa berlaku keanggotaan untuk kasus penggunaan berikut:

Akses berbatas waktu ke resource (misalnya, untuk memungkinkan seseorang membantu memecahkan masalah dalam produksi)
Keanggotaan sementara dalam grup komunikasi (misalnya, untuk secara singkat menyertakan seseorang ke dalam grup tim pada project jangka panjang)

Waktu habis dapat diterapkan ke semua jenis anggota grup (termasuk pengguna, grup, dan akun layanan) jika mereka memiliki peran MEMBER. Jika Anda menetapkan masa berlaku untuk anggota yang merupakan sebuah grup, masa berlaku tersebut akan menjadi masa berlaku default untuk semua anggota turunan grup tersebut, kecuali jika anggota turunan tersebut memiliki keanggotaan langsung di grup induk dengan masa berlaku individual yang sudah diterapkan. Akhir masa berlaku juga berlaku untuk semua anggota baru grup turunan ke depannya.

Sebelum memulai

Menyiapkan autentikasi dan menginstal library klien. Lihat Menyiapkan Cloud Identity Groups API untuk mempelajari caranya.

Menambahkan keanggotaan yang masa berlakunya telah berakhir

Lihat artikel Mengelola keanggotaan Google Grup untuk Google Grup atau Mengelola keanggotaan grup yang dipetakan identitasnya untuk mempelajari caranya.

Memperbarui akhir masa berlaku langganan

Untuk memperbarui masa berlaku keanggotaan, panggil groups.memberships.modifyMembershipRoles() dengan ID grup induk, ID keanggotaan, dan resource UpdateMembershipRolesParams. Karena anggota dapat memiliki lebih dari satu MembershipRole dalam sebuah grup, Anda harus menentukan peran yang akan memiliki akhir masa berlaku. Saat ini, hanya peran MEMBER yang mungkin memiliki masa berlaku yang berlaku.

Contoh isi permintaan

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

Mengambil masa berlaku keanggotaan

Untuk mengambil masa berlaku keanggotaan, panggil groups.memberships.get() dengan ID grup induk dan ID keanggotaan tersebut.

Notifikasi email

Notifikasi email akan otomatis dikirim kepada semua pemilik grup saat keanggotaan akan berakhir. Notifikasi dikirim 72 jam sebelum masa berlaku habis atau segera jika langganan akan berakhir sebelum 72 jam saat disetel. Notifikasi dikirim dalam bahasa pilihan setiap pemilik grup, seperti yang ditentukan oleh administrator domain di konsol Google Admin atau oleh pemilik grup satu per satu.