Kuota dan batas

Fitur Merchant API memiliki kuota dan batas yang ketat.

Memperbarui kebijakan

Merchant API menerapkan kebijakan berikut dalam hal pembaruan:

  • Anda hanya dapat memperbarui produk hingga dua kali per hari.
  • Anda hanya dapat memperbarui sub-akun sekali per hari.

Kuota panggilan metode

Merchant API secara otomatis menyesuaikan kuota panggilan untuk products dan accounts berdasarkan penggunaan Anda.

Berikut cara kami melacak penggunaan kuota Anda:

  • Kuota ditetapkan per metode. Misalnya, metode get memiliki kuota terpisah dari metode update.
  • Setiap permintaan dihitung satu kali, terlepas dari jenisnya. Misalnya, kita menghitung permintaan list sebanyak 250 item sekali, bukan sebagai 250 permintaan get.
  • Kuota berlaku untuk grup Layanan Perbandingan Belanja (CSS), CSS, akun, atau sub-akun yang Anda autentikasi saat melakukan panggilan. Misalnya, jika Anda mengautentikasi sebagai akun lanjutan, panggilan akan mengurangi kuota akun lanjutan, tetapi jika Anda mengautentikasi sebagai salah satu sub-akun, panggilan akan mengurangi kuota sub-akun.

Diagram ini menunjukkan hierarki grup CSS, CSS, akun, dan sub-akun. Gambar menunjukkan bahwa grup CSS adalah tingkat autentikasi menyeluruh, dengan kemungkinan CSS individual di dalamnya, akun dalam akun tersebut, dan sub-akun sebagai tingkat yang paling individual.

Memeriksa kuota Anda

Untuk memeriksa kuota dan penggunaan saat ini untuk akun, panggil quotas.list dengan name akun.

Kuota otomatis hanya berlaku untuk layanan products dan accounts. Jika Anda memerlukan peningkatan kuota untuk layanan lain, Anda mencapai kuota harian untuk layanan products atau accounts, atau Anda memerlukan peningkatan sementara untuk accounts atau produk services, hubungi kami dengan menyertakan informasi berikut:

  • ID Merchant Center Anda
  • Metode yang telah mencapai batas kuota
  • Estimasi jumlah panggilan per hari yang Anda perlukan untuk metode tersebut
  • Alasan Anda memerlukan penambahan kuota
  • Apakah peningkatan tersebut bersifat sementara atau permanen

Sebaiknya periksa kuota secara berkala untuk memastikan Anda memiliki kuota yang memadai untuk penerapan, atau cara kuota disesuaikan secara otomatis.

Error

Jika melebihi kuota, Anda akan menerima error berikut:

  • Per menit: quota/request_rate_too_high
  • Per hari: quota/daily_limit_exceeded

Untuk melihat kuota dan penggunaan, serta meminta peningkatan kuota per hari atau per menit, lihat Memeriksa kuota.

Error berikut tidak dapat diselesaikan dengan penambahan kuota otomatis, dan mengharuskan Anda meminta kuota tambahan item, feed, atau sub-akun:

  • too_many_items: Merchant quota exceeded
  • too_many_subaccounts: Maximum number of sub-accounts reached

Batas representasi resource

Batas berikut menjelaskan batasan penting untuk nilai string dan kolom array tertentu dalam representasi resource yang digunakan di Merchant API. Batas ini sama untuk Merchant API dan fitur terkait di Merchant Center.

Perhatikan bahwa daftar batas ini mungkin tidak lengkap. Kami tidak akan memperpanjang batas ini.

Resource Kolom Batas
shippingsettings

Layanan pengiriman per negara (services).

Grup pengiriman per layanan pengiriman (rateGroups).

Label per grup pengiriman (applicableShippingLabels).

Subtabel per grup pengiriman (subtables).

Jumlah baris atau kolom dalam satu tabel tarif.

Panjang label paket.

20

20

30

100

150

100

Jumlah baris atau kolom dalam tabel tarif memengaruhi kolom array berikut:

  • Kolom array dalam rowHeaders atau columnHeaders:
    • prices[]
    • weights[]
    • numberOfItems[]
    • postalCodeGroupNames[]
    • locations[]
    • rows[]
    • cells[]