Mengelola akhir masa berlaku keanggotaan

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

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

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

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

Sebelum memulai

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

Menambahkan keanggotaan dengan masa berlaku

Lihat Mengelola keanggotaan Google Grup untuk Google Grup atau Mengelola keanggotaan grup dengan pemetaan identitas untuk mempelajari caranya.

Memperbarui akhir masa berlaku keanggotaan

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

Contoh isi permintaan

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

Mengambil akhir masa berlaku keanggotaan

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

Notifikasi email

Notifikasi email otomatis dikirim ke semua pemilik grup saat langganan akan segera berakhir. Notifikasi dikirim 72 jam sebelum masa berlaku berakhir atau segera jika masa berlaku keanggotaan akan berakhir sebelum 72 jam saat ditetapkan. Notifikasi dikirim dalam bahasa pilihan setiap pemilik grup, seperti yang ditentukan oleh admin domain di konsol Google Admin atau oleh pemilik grup secara terpisah.