Mengelola delegasi kontak

Panduan ini membahas cara membuat, mencantumkan, dan menghapus delegasi kontak untuk pengguna Google Workspace.

Pengguna Google Workspace dapat memberikan izin kepada pengguna lain di domain mereka untuk mengakses dan mengelola kontak mereka. Penerima delegasi ini dapat menambahkan dan memperbarui kontak dengan informasi seperti nama, nomor telepon, dan alamat.

Panduan ini ditujukan untuk mendelegasikan akses ke kontak. Untuk mendelegasikan akses ke Gmail, lihat Mendelegasikan dan berkolaborasi di email.

Prasyarat

Sebelum menggunakan Contact Delegation API, pastikan Anda memenuhi persyaratan berikut:

  • Mengaktifkan berbagi kontak: Administrator Direktori harus mengaktifkan berbagi kontak di konsol Admin. Untuk mengetahui informasi selengkapnya, lihat Mengaktifkan atau menonaktifkan berbagi kontak.
  • Hak istimewa administrator: Anda harus memiliki hak istimewa administrator "Kontak" untuk mengelola penerima delegasi bagi pengguna lain.
  • Pembatasan domain: Anda hanya dapat mendelegasikan kontak antar-pengguna dalam organisasi Google Workspace yang sama.
  • Cakupan OAuth: Aplikasi Anda harus menggunakan cakupan OAuth berikut: https://www.googleapis.com/auth/admin.contact.delegation.

Membuat delegasi

Untuk membuat penerima delegasi bagi pengguna, kirim permintaan POST dengan alamat email pendelegasi:

POST https://admin.googleapis.com/admin/contacts/v1/users/USER_EMAIL/delegates

Ganti USER_EMAIL dengan alamat email delegator.

Dalam isi permintaan, berikan alamat email untuk penerima delegasi:

{
  "email": "DELEGATE_EMAIL"
}

Ganti DELEGATE_EMAIL dengan alamat email penerima delegasi.

Respons yang berhasil akan menampilkan kode status HTTP 200 dan email delegasi baru:

{
  "email": "DELEGATE_EMAIL"
}

Mencantumkan penerima delegasi

Untuk mencantumkan penerima delegasi untuk kontak pengguna, kirim permintaan GET dengan alamat email pengguna tersebut:

GET https://admin.googleapis.com/admin/contacts/v1/users/USER_EMAIL/delegates

Ganti USER_EMAIL dengan alamat email pengguna.

Respons yang berhasil akan menampilkan kode status HTTP 200 dan daftar email delegasi:

{
  "delegates": [
    {
      "email": "DELEGATE_EMAIL_1"
    },
    {
      "email": "DELEGATE_EMAIL_2"
    }
  ]
}

Menghapus delegasi

Untuk menghapus penerima delegasi kontak pengguna, selesaikan langkah-langkah berikut:

  1. Identifikasi penerima tugas yang akan dihapus. Gunakan metode List delegates untuk menemukan alamat email penerima delegasi tertentu.

  2. Kirim permintaan DELETE dengan alamat email pendelegasi dan penerima delegasi:

    DELETE https://admin.googleapis.com/admin/contacts/v1/users/USER_EMAIL/delegates/DELEGATE_EMAIL

Ganti USER_EMAIL dengan alamat email pendelegasi, dan DELEGATE_EMAIL dengan alamat email penerima delegasi.

Respons yang berhasil akan menampilkan kode status HTTP 200.