Memecahkan masalah Directory API

Laman ini menjelaskan beberapa masalah umum yang mungkin Anda temui yang melibatkan Directory API sebagai reseller.

400:badRequest

Error ini terjadi jika parameter value yang salah diteruskan ke metode.

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

Jika menggunakan metode users.list, verifikasi parameter berikut:

• Parameter customer: Hanya gunakan customerId yang dihasilkan oleh Google. Jangan gunakan domain pelanggan yang sebenarnya. Sebaiknya gunakan karena jika pelanggan memiliki domain sekunder, menggunakan domain hanya mengembalikan pengguna dengan alamat email pada domain tertentu tersebut.
• Parameter domain: Hanya menggunakan domain pelanggan yang sebenarnya. Jangan gunakan
  customerId yang dibuat oleh Google.

403:domainCannotUseApis

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

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

403:forbidden

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

Untuk mengatasi masalah ini, panggil Metode customers.get sebelum melakukan panggilan telepon untuk memverifikasi kepemilikan reseller untuk mengaktifkan kembali akses reseller ke konsol Admin mereka. Untuk selengkapnya informasi, 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 selengkapnya informasi, lihat Aktifkan Google Workspace API.

409:duplicate

Kesalahan ini terjadi saat Anda mencoba menambahkan pengguna baru, tetapi email utama sudah ada dalam salah satu alamat berikut:

• Akun Google Workspace saat ini yang Anda coba tambahkan ke dalamnya.
• Produk Google lain (bukan Google Workspace).

Untuk menyelesaikan masalah ini, lakukan tindakan berikut:

1. Panggil metode users.get.

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

   Jika Anda mendapatkan respons 403 forbidden, berarti domain di konfigurasi utama parameter email bukan pelanggan reseller atau email utama telah digunakan sebelumnya untuk produk Google lain dan domain pelanggan harus diverifikasi terlebih dahulu sebelum pengguna ini 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 owners[] isi permintaan untuk Panggilan webResource.insert. Lakukan panggilan ini sampai Anda menerima respons 200.
   3. Setelah domain diverifikasi, ganti nama nama pengguna sementara menggunakan baik users.patch atau users.update metode.

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

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

412:limitExceeded

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

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