Kuota dan batas

Akun Merchant dan penggunaan Merchant API tunduk pada kuota dan batas.

Perbarui kebijakan

Merchant API menerapkan kebijakan berikut terkait pembaruan:

• Anda hanya dapat memperbarui produk maksimal dua kali per hari. Anda harus mendistribusikan panggilan harian secara merata sepanjang hari agar mematuhi kuota per menit.
• Anda hanya dapat memperbarui sub-akun sekali per hari.

Kuota panggilan metode

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

Berikut cara kami melacak penggunaan kuota Anda:

• Kuota per metode. Misalnya, metode get memiliki kuota terpisah dari metode update.
• Setiap permintaan dihitung sekali, terlepas dari jenisnya. Misalnya, kami menghitung permintaan list dari 250 item sekali, bukan sebagai 250 permintaan metode get.
• Kuota ditagih berdasarkan pengguna yang membuat permintaan API. Jika pengguna adalah anggota langsung akun lanjutan, kuota akan ditagih di tingkat akun lanjutan.
• Kuota berlaku untuk grup Layanan Perbandingan Belanja (CSS), CSS, akun, atau sub-akun yang Anda gunakan untuk autentikasi saat melakukan panggilan. Misalnya, jika Anda melakukan autentikasi sebagai akun lanjutan, panggilan akan dihitung terhadap kuota akun lanjutan Anda, tetapi jika Anda melakukan autentikasi sebagai salah satu sub-akun, panggilan akan dihitung terhadap kuota sub-akun.

Diagram ini menunjukkan hierarki grup CSS, CSS, akun, dan sub-akun.

Perubahan kuota panggilan metode dari Content API for Shopping

Jika Anda menggunakan Content API for Shopping, perhatikan perubahan kuota panggilan metode berikut di Merchant API:

• Tidak adanya batching kustom tidak memengaruhi perhitungan kuota. Misalnya, permintaan batch yang berisi 500 permintaan penyisipan akan ditagih sebagai 500 permintaan metode penyisipan individual.
• Otomatisasi kuota untuk akun dan produk tetap berlaku.
• Untuk menentukan penggunaan dan batas kuota saat ini, termasuk otomatisasi dan penggantian, gunakan metode Quota.list.

Memeriksa kuota panggilan

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

Kuota otomatis hanya berlaku untuk layanan products dan accounts. Jika Anda memerlukan kuota yang lebih tinggi 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 informasi berikut:

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

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

Error

Jika Anda 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 Anda, serta meminta peningkatan kuota per hari atau per menit kuota, lihat Memeriksa kuota panggilan.

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

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

Batas akun

Metode accounts.limits.get dan accounts.limits.list memungkinkan Anda memeriksa batas pada entity tingkat akun. Anda dapat menggunakan metode ini untuk memeriksa batas produk.

Untuk mengambil batas produk tertentu, misalnya, untuk mendapatkan kuota EEA Iklan akun, Anda harus menentukan ID akun dan ID batas dalam panggilan ke accounts.limits.get. ID batas adalah kombinasi dari jenis batas dan cakupan. Misalnya, products~ADS_EEA untuk produk yang menargetkan iklan di EEA, dan products~ADS_NON_EEA untuk produk yang menargetkan iklan di luar EEA.

Berikut adalah contoh permintaan untuk mendapatkan batas products~ADS_EEA untuk akun tertentu:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/limits/products~ADS_EEA

Untuk mempelajari ID batas yang tersedia untuk akun Anda, gunakan accounts.limits.list dengan filter untuk type="products":

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/limits?filter=type%3D%22products%22

Untuk informasi selengkapnya tentang kuota produk, lihat Memahami kuota di Google Merchant Center.

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.

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

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