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 beberapa alasan.

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

  • postalAddress.postalCode tidak valid.
  • postalAddress.countryCode tidak memenuhi syarat 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 telah menyebabkan error ini:

  • Anda tidak dapat mengurangi jumlah slot untuk jenis paket tahunan. Pertimbangkan untuk mengubah setelan perpanjangan. agar langganan secara otomatis menetapkan (pada saat perpanjangan) kursi yang sama dengan jumlah pengguna aktif di akun.
  • Jumlah slot yang Anda minta kurang dari pengguna saat ini di akun. Kirim pesan kepada 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 jika Anda bukan pemilik pelanggan atau pelanggan 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 menyelesaikan masalah ini, terapkan penundaan backoff. Untuk informasi selengkapnya, lihat Batas dan kuota penggunaan.

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

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.

404:notFound

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

412:conditionNotMet

Error ini disebabkan oleh sejumlah masalah yang berbeda.

Jika Anda mengalami error ini saat menggunakan metode subscriptions.changeRenewalSettings, 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 dan coba lagi.

Jika Anda mengalami error ini saat menggunakan metode subscriptions.insert, artinya Anda tidak dapat menjual kembali SKU yang dipilih atau kepada pelanggan pasar yang sedang 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 menyelesaikan masalah ini, terapkan strategi percobaan ulang backoff atau hasil cache untuk membuat panggilan API lebih sedikit. Untuk informasi selengkapnya, lihat Batas dan kuota penggunaan.

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