Memecahkan masalah Reseller API

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

400:badRequest

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

400:invalid

Error ini dapat terjadi karena berbagai 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 menyebabkan error ini:

  • Anda tidak dapat mengurangi slot untuk jenis paket tahunan. Pertimbangkan mengubah setelan perpanjangan. agar langganan dapat secara otomatis menetapkan slot (pada saat perpanjangan) 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 agar dapat mengurangi jumlah slot.
  • Anda menambah parameter slot 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 slot. Mulai layanan berbayar dari langganan uji coba gratis untuk segera mengakhiri periode uji coba, memulai penagihan, dan menghapus batas maksimum 10 slot.

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 mencapai kuota harian untuk panggilan ke API ini. Untuk mengatasi masalah ini, terapkan penundaan backoff. Untuk mengetahui 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 maksimum 100 langganan per panggilan. Gunakan parameter pageToken untuk terus mengambil semua langganan dalam 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 bahwa pelanggan atau domain tidak ada untuk akun Google Workspace apa pun dan domain tersebut tersedia.

412:conditionNotMet

Error ini disebabkan oleh sejumlah masalah yang berbeda.

Jika mendapatkan 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 mendapatkan error ini saat menggunakan metode subscriptions.insert, artinya Anda tidak dapat menjual kembali SKU yang dipilih atau ke pelanggan pasar negara 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, implementasikan strategi percobaan ulang backoff atau hasil cache untuk melakukan panggilan API lebih sedikit. Untuk mengetahui 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 maksimum 100 langganan per panggilan. Gunakan parameter pageToken untuk terus mengambil semua langganan dalam akun reseller.