API Direktori: Anggota Grup

Menambahkan anggota ke grup

Untuk menambahkan anggota ke grup, gunakan permintaan POST berikut dan sertakan otorisasi yang dijelaskan dalam Otorisasi permintaan. Anggota grup dapat berupa pengguna atau grup lain. groupKey adalah alamat email grup anggota baru atau id unik grup. Untuk properti permintaan dan respons, lihat Referensi API: 

POST https://admin.googleapis.com/admin/directory/v1/groups/groupKey/members

Jika Anda menambahkan suatu grup sebagai anggota grup lain, mungkin akan terjadi penundaan hingga 10 menit sebelum anggota grup turunan muncul sebagai anggota grup induk. Selain itu, API menampilkan kesalahan untuk siklus dalam keanggotaan grup. Contohnya, jika group1 adalah anggota group2, group2 tidak bisa menjadi anggota group1.

Permintaan JSON

Permintaan JSON berikut menunjukkan contoh isi permintaan yang membuat anggota grup. Alamat email anggota adalah liz@example.com dan peran anggota di grup adalah sebagai MEMBER. Permintaan POST menggunakan NNNNN untuk groupKey: 

POST https://admin.googleapis.com/admin/directory/v1/groups/NNNNN/members

{
   "email": "liz@example.com",
    "role": "MEMBER"
}

role anggota grup dapat berupa:

  • OWNER – Peran ini dapat mengubah pesan ke grup, menambahkan atau menghapus anggota, mengubah peran anggota, mengubah setelan grup, dan menghapus grup. OWNER harus menjadi anggota grup.
  • MANAGER – Peran ini hanya tersedia jika Google Workspace diaktifkan menggunakan konsol Admin. Peran PENGELOLA dapat melakukan apa saja oleh peran PEMILIK, kecuali menjadikan anggota sebagai PEMILIK atau menghapus grup. Grup dapat memiliki beberapa anggota PEMILIK dan PENGELOLA.
  • MEMBER – Peran ini dapat berlangganan grup, melihat arsip diskusi, dan melihat daftar keanggotaan grup. Untuk informasi selengkapnya tentang peran anggota, lihat pusat bantuan administrasi.

Respons JSON

Respons yang berhasil akan menampilkan kode status HTTP 200 dan informasi keanggotaan anggota. id adalah ID keanggotaan unik anggota: 

{
   "kind": "directory#member",
   "id": "group member's unique ID",
   "email": "liz@example.com",
   "role": "MEMBER",
   "type": "GROUP"
  }

type anggota grup dapat berupa:

  • GROUP – Anggota ini merupakan grup lain.
  • MEMBER – Anggota adalah pengguna

Memperbarui keanggotaan grup

Untuk memperbarui keanggotaan grup, gunakan permintaan PUT berikut dan sertakan otorisasi yang dijelaskan dalam Otorisasi permintaan. groupKey adalah alamat email grup atau id unik grup, dan memberKey adalah alamat email utama pengguna atau grup, alamat email alias pengguna, atau id unik pengguna. Untuk properti permintaan dan respons, lihat Referensi API: 

PUT https://admin.googleapis.com/admin/directory/v1/groups/groupKey/members/memberKey

Permintaan JSON

Permintaan JSON berikut menunjukkan contoh isi permintaan yang memperbarui setelan keanggotaan grup. Alamat email anggota adalah liz@example.com dan peran anggota di grup diubah dari MEMBER menjadi MANAGER. groupKey permintaan PUT dalam contoh ini adalah NNNNN. Untuk mengetahui informasi tentang peran ANGGOTA, PEMILIK, dan PENGELOLA, lihat pusat bantuan administrasi: 

PUT https://admin.googleapis.com/admin/directory/v1/groups/NNNNN/members/liz@example.com
 
{
   "email": "liz@example.com",
    "role": "MANAGER"
}

Respons JSON

Respons yang berhasil akan menampilkan kode status HTTP 200 dan informasi keanggotaan yang diperbarui. id adalah ID keanggotaan unik anggota: 

{
   "kind": "directory#member",
   "id": "group member's unique ID",
   "email": "liz@example.com",
   "role": "MANAGER",
   "type": "GROUP"
  }

Mengambil anggota grup

Untuk mengambil keanggotaan grup, gunakan permintaan GET berikut dan sertakan otorisasi yang dijelaskan dalam Permintaan otorisasi. groupKey adalah alamat email grup atau id unik grup, dan memberKey adalah alamat email utama pengguna atau grup, alamat email alias pengguna, atau id unik pengguna. Untuk properti permintaan dan respons, lihat Referensi API: 

GET https://admin.googleapis.com/admin/directory/v1/groups/groupKey/members/memberKey

Respons JSON

Respons yang berhasil akan menampilkan kode status HTTP 200 dan informasi keanggotaan anggota. id adalah ID keanggotaan unik anggota: 

{
   "kind": "directory#member",
   "id": "group member's unique ID",
   "email": "liz@example.com",
   "role": "MANAGER",
   "type": "GROUP"
  }

Mengambil semua anggota grup

Untuk mengambil semua anggota grup, gunakan permintaan GET berikut dan sertakan otorisasi yang dijelaskan dalam Otorisasi permintaan. groupKey adalah alamat email grup atau id unik grup. String kueri roles opsional adalah filter yang memungkinkan Anda mengambil anggota grup berdasarkan peran dan kumpulan peran yang dihasilkan sesuai urutan yang diberikan dalam filter roles. Untuk properti permintaan dan respons, lihat Referensi API. Agar mudah dibaca, contoh ini menggunakan pengembalian baris: 

GET https://admin.googleapis.com/admin/directory/v1/groups/groupKey/members
?pageToken=pagination token
&roles=one or more of OWNER,MANAGER,MEMBER separated by a comma
&maxResults=maximum results per response page

Semua anggota ditampilkan dalam urutan abjad nama anggota alamat email Anda. Selain itu, gunakan string kueri pageToken untuk respons dengan anggota dalam jumlah besar. Dalam kasus penomoran halaman, respons akan menampilkan properti nextPageToken yang memiliki token untuk halaman hasil respons berikutnya. Permintaan Anda berikutnya menggunakan token ini sebagai nilai string kueri pageToken.

Respons JSON

Respons yang berhasil akan menampilkan kode status HTTP 200 dan daftar informasi anggota. id adalah ID keanggotaan unik anggota. Ada nextPageToken untuk daftar lanjutan anggota grup dalam respons ini: 

{
   "kind": "directory#members",
   "members": [
   {
    "kind": "directory#member",
    "id": "group member's unique ID",
    "email": "liz@example.com",
    "role": "MANAGER",
    "type": "USER"
   },
   {
    "kind": "directory#member",
    "id": "group member's unique ID",
    "email": "radhe@example.com",
    "role": "MANAGER",
    "type": "USER"
   }
  ],
   "nextPageToken": "NNNNN"
}

Menghapus keanggotaan dalam grup

Untuk menghapus keanggotaan anggota di grup, gunakan permintaan DELETE berikut dan sertakan otorisasi yang dijelaskan dalam Permintaan otorisasi. groupKey adalah id unik grup, dan memberKey adalah alamat email utama pengguna atau anggota grup yang dihapus atau id unik pengguna. Untuk properti permintaan dan respons, lihat Referensi API: 

DELETE https://admin.googleapis.com/admin/directory/v1/groups/groupKey/members/memberKey
 Misalnya, permintaan DELETE ini akan menghapus anggota yang groupKey-nya nnn dan yang memberKey-nya adalah alamat email utama pengguna, liz@example.com: 
DELETE https://admin.googleapis.com/admin/directory/v1/groups/nnnn/members/liz@example.com

Respons yang berhasil akan menampilkan kode status HTTP 200.

Saat anggota dihapus:

  • Anggota yang Anda hapus tidak akan lagi menerima email yang ditujukan ke grup.
  • Menghapus anggota dari grup tidak akan menghapus akun pengguna tersebut.
  • Jika Anda menghapus pemilik grup, grup akan tetap berjalan seperti biasa. Sebagai administrator, Anda dapat mengelola grup atau menetapkan kepemilikan kepada anggota grup lainnya