Memecahkan masalah Reseller API

Halaman ini menjelaskan beberapa masalah umum yang mungkin Anda alami terkait Reseller API.

400:badRequest

Error ini terjadi saat langganan ditangguhkan atau dibatalkan. Untuk mengetahui informasi selengkapnya, lihat Mengaktifkan langganan.

400:invalid

Error ini dapat terjadi karena sejumlah alasan yang berbeda.

Jika Anda menggunakan metode customers.insert, salah satu parameter objek pelanggan berikut tidak valid:

  • postalAddress.postalCode tidak valid.
  • Tidak memenuhi syarat postalAddress.countryCode untuk menjual kembali Google Workspace.
  • alternateEmail tidak boleh berada di domain yang sama dengan customerDomain

Untuk mengatasi masalah ini, pastikan parameter yang diperlukan ada dan valid untuk pelanggan.

Jika Anda menggunakan metode subscriptions.changeSeats, salah satu masalah berikut mungkin menyebabkan error ini:

  • Anda tidak dapat mengurangi jumlah kursi untuk jenis paket tahunan. Pertimbangkan untuk mengubah setelan perpanjangan. agar langganan otomatis menetapkan (pada saat perpanjangan) jumlah kursi yang sama dengan jumlah pengguna aktif di akun.
  • Jumlah kursi yang Anda minta kurang dari jumlah pengguna saat ini di akun. Memberi tahu pelanggan bahwa mereka harus menghapus pengguna sebelum dapat mengurangi jumlah kursi.
  • Anda meningkatkan parameter kursi yang salah. Untuk paket FLEX, tingkatkan parameter maximumNumberOfSeats dan untuk paket ANNUAL, tingkatkan parameter numberOfSeats.
  • Anda mencoba mengubah parameter licensedNumberOfSeats, yang merupakan parameter hanya baca.
  • Selama periode uji coba, pelanggan memiliki batas slot maksimum 10. Mulai layanan berbayar dari langganan uji coba gratis untuk segera mengakhiri periode uji coba, memulai penagihan, dan menghapus batas maksimum 10 kursi.

403:forbidden

Error ini terjadi saat Anda tidak memiliki pelanggan atau pelanggan Anda telah menonaktifkan akses reseller ke konsol Admin mereka.

403:usageLimits.dailyLimitExceeded

Error ini terjadi saat Anda telah mencapai kuota harian untuk panggilan ke API ini. Untuk mengatasi masalah ini, terapkan penundaan mundur. Untuk mengetahui informasi selengkapnya, lihat Batas penggunaan dan kuota.

Jika Anda mencoba mengambil banyak langganan, pertimbangkan untuk menggunakan metode subscriptions.list tanpa menentukan parameter customerId atau subscriptionId. Anda dapat menampilkan maksimum 100 langganan per panggilan. Gunakan parameter pageToken untuk terus mengambil semua langganan di akun reseller.

403:usageLimits.accessNotConfigured

Error ini terjadi saat 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.

404:notFound

Saat menggunakan metode customers.get, error ini berarti pelanggan atau domain tidak ada untuk akun Google Workspace mana pun dan domain tersedia.

412:conditionNotMet

Error ini disebabkan oleh sejumlah masalah yang berbeda.

Jika Anda mengalami error ini saat menggunakan metode subscriptions.changeRenewalSettings ini, pastikan Anda hanya memanggil metode ini pada paket pembayaran komitmen berikut:

  • ANNUAL_MONTHLY_PAY
  • ANNUAL_YEARLY_PAY

Jika Anda mengalami error ini saat menggunakan metode subscriptions.delete, berarti tidak ada pengguna admin di akun Google Workspace. Untuk mengatasi masalah ini, tambahkan pengguna admin sementara, lalu coba lagi.

Jika Anda mengalami error ini saat menggunakan metode subscriptions.insert, artinya Anda tidak dapat menjual kembali SKU yang dipilih atau kepada pelanggan di pasar berkembang. Untuk mengatasi masalah ini, setujui persyaratan layanan yang berlaku.

429:usageLimits.quotaExceeded

Error ini terjadi jika Anda telah melampaui batas kueri per detik. Untuk mengatasi masalah ini, terapkan strategi percobaan ulang dengan penundaan atau simpan hasil dalam cache untuk melakukan lebih sedikit panggilan API. Untuk mengetahui informasi selengkapnya, lihat Batas penggunaan dan kuota.

Jika Anda mencoba mengambil banyak langganan, pertimbangkan untuk menggunakan metode subscriptions.list tanpa menentukan parameter customerId atau subscriptionId. Anda dapat menampilkan maksimum 100 langganan per panggilan. Gunakan parameter pageToken untuk terus mengambil semua langganan di akun reseller.