Memecahkan masalah Directory API

Halaman ini menjelaskan beberapa masalah umum yang mungkin Anda alami 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 yang sebenarnya. Jangan gunakan
    customerId yang dibuat oleh Google.

403:domainCannotUseApis

Error ini terjadi saat pelanggan Anda 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, gunakan kolom licensedNumberOfSeats dari resource langganan, bukan memanggil metode users.list.

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 mengetahui 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 dalam salah satu hal berikut:

  • Akun Google Workspace saat ini yang Anda coba tambahkan.
  • Produk Google lainnya (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 Akun Google Workspace pelanggan. Anda tidak dapat menambahkan pengguna ini ke akun.

    Jika Anda mendapatkan respons 403 forbidden, berarti domain dalam parameter email utama bukan pelanggan yang dijual kembali atau email utama telah digunakan sebelumnya untuk produk Google yang berbeda 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 parameter owners[] isi permintaan untuk panggilan webResource.insert. Lakukan panggilan ini hingga Anda menerima respons 200.
    3. Setelah domain diverifikasi, ganti nama pengguna sementara menggunakan metode users.patch atau users.update.

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

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

412:limitExceeded

Error ini terjadi jika pelanggan Anda telah mencapai batas kursi maksimum. Untuk menyelesaikan masalah ini, Gunakan metode subscriptions.changeSeats dan bergantung pada paket langganannya, gunakan hal berikut:

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