Memecahkan masalah Directory API

Halaman ini menjelaskan beberapa masalah umum yang mungkin Anda temui terkait Directory API sebagai reseller.

400:badRequest

Error ini terjadi saat nilai parameter yang salah diteruskan ke metode.

Jika menggunakan metode users.get, pastikan nilai yang diteruskan ke parameter userKey adalah alamat email utama, alamat email alias, atau ID pengguna unik milik pengguna.

Jika menggunakan metode users.list, verifikasi parameter berikut:

  • Parameter customer: Hanya gunakan customerId yang dibuat oleh Google. Jangan gunakan domain pelanggan yang sebenarnya. Sebaiknya gunakan parameter ini karena jika pelanggan memiliki domain sekunder, penggunaan parameter domain hanya akan menampilkan pengguna dengan alamat email di domain tertentu tersebut.
  • Parameter domain: Hanya gunakan domain pelanggan sebenarnya. Jangan gunakan
    customerId yang dibuat oleh Google.

403:domainCannotUseApis

Error ini terjadi jika pelanggan telah menonaktifkan akses reseller ke Admin SDK API. Untuk mengatasi masalah ini, minta pelanggan Anda untuk mengaktifkan kembali akses ke Admin SDK API. Untuk mengetahui informasi selengkapnya, lihat Mengontrol akses API.

Jika Anda mencoba mendapatkan jumlah pengguna berlisensi saat ini dan mendapatkan error ini, daripada memanggil metode users.list, gunakan kolom licensedNumberOfSeats dari resource langganan.

403:forbidden

Error ini terjadi jika Anda bukan pemilik pelanggan atau pelanggan telah menonaktifkan akses reseller ke konsol Admin mereka.

Untuk mengatasi masalah ini, panggil metode customers.get sebelum melakukan panggilan untuk memverifikasi kepemilikan reseller pelanggan atau minta pelanggan Anda untuk mengaktifkan kembali akses reseller ke konsol Admin mereka. Untuk informasi selengkapnya, lihat Mengakses konsol Admin pelanggan.

403:usageLimits.accessNotConfigured

Error ini terjadi jika API tidak diaktifkan di project Google Cloud. Untuk mengatasi masalah ini, buka Konsol Google Cloud, lalu aktifkan API. Untuk mengetahui informasi selengkapnya, lihat Mengaktifkan Google Workspace API.

409:duplicate

Error ini terjadi saat Anda mencoba menambahkan pengguna baru, tetapi email utama pelanggan sudah ada di salah satu folder berikut:

  • Akun Google Workspace saat ini yang ingin Anda tambahi akun tersebut.
  • Produk Google lainnya (bukan Google Workspace).

Untuk mengatasi masalah ini, lakukan langkah berikut:

  1. Panggil metode users.get.

    Jika Anda mendapatkan respons 200, berarti pengguna tersebut sudah ada di Akun Google Workspace pelanggan. Anda tidak dapat menambahkan pengguna ini ke akun.

    Jika Anda mendapatkan respons 403 forbidden, berarti domain di parameter email utama bukan pelanggan reseller atau email utama telah digunakan sebelumnya untuk produk Google yang berbeda dan domain pelanggan harus diverifikasi terlebih dahulu sebelum pengguna ini dapat berhasil ditambahkan.

  2. Jika Anda dapat memverifikasi domain pelanggan, lakukan hal berikut:

    1. Buat pengguna admin sementara menggunakan metode users.insert dan lanjutkan penyediaan ke langkah verifikasi domain akhir.
    2. Saat memverifikasi domain, tambahkan pengguna sementara ke parameter owners[] dari isi permintaan untuk panggilan webResource.insert. Lakukan panggilan ini hingga Anda menerima respons 200.
    3. Setelah domain diverifikasi, ganti nama nama pengguna sementara dengan menggunakan metode users.patch atau users.update.
  3. Jika Anda tidak dapat memverifikasi domain pelanggan, lakukan tindakan berikut:

    1. Buat pengguna admin sementara menggunakan metode users.insert.
    2. Minta pelanggan Anda login sebagai pengguna sementara dan verifikasi domainnya melalui konsol Admin.
    3. Setelah domain diverifikasi, Anda dapat mengganti nama nama pengguna sementara atau pelanggan. Anda dapat menggunakan metode users.patch atau users.update.

412:limitExceeded

Error ini terjadi saat pelanggan Anda telah mencapai batas slot maksimum. Untuk mengatasi masalah ini, gunakan metode subscriptions.changeSeats dan bergantung pada paket langganan mereka, gunakan metode berikut:

  • Untuk FLEXIBLE, tingkatkan parameter maximumNumberOfSeats.
  • Untuk ANNUAL, tingkatkan parameter numberOfSeats.