Kuota dan batas

Akun Penjual dan penggunaan Merchant API oleh Anda tunduk pada kuota dan batas.

Kebijakan pembaruan

Merchant API menerapkan kebijakan berikut terkait pembaruan:

  • Anda hanya dapat memperbarui produk hingga dua kali per hari.
  • Anda hanya dapat memperbarui sub-akun satu kali 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 per metode. Misalnya, metode get memiliki kuota terpisah dari metode update.
  • Setiap permintaan dihitung satu kali, terlepas dari jenisnya. Misalnya, kami menghitung permintaan list yang berisi 250 item satu kali, bukan sebagai 250 permintaan get.
  • Kuota ditagih berdasarkan pengguna yang membuat permintaan API. Jika pengguna adalah anggota langsung akun lanjutan, kuota akan ditagih di tingkat akun lanjutan.
  • Kouta berlaku untuk grup, CSS, akun, atau sub-akun Layanan Perbandingan Belanja (CSS) yang Anda autentikasi saat melakukan panggilan. Misalnya, jika Anda melakukan autentikasi sebagai akun lanjutan, panggilan akan dihitung dalam kuota akun lanjutan Anda, tetapi jika Anda melakukan autentikasi sebagai salah satu sub-akun, panggilan akan dihitung dalam kuota sub-akun.

Diagram ini menunjukkan hierarki grup CSS, CSS, akun, dan sub-akun. Grup CSS adalah tingkat autentikasi menyeluruh, dengan kemungkinan CSS individual di dalamnya, akun di dalamnya, dan sub-akun sebagai tingkat paling individual.

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 pengelompokan kustom tidak memengaruhi penghitungan 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.

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

  • ID Merchant Center Anda
  • Metode yang telah mencapai batas kuota Anda
  • Estimasi jumlah panggilan per hari yang Anda butuhkan untuk metode tersebut
  • Alasan Anda memerlukan penambahan kuota
  • Apakah peningkatan ini 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 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, lihat Periksa kuota panggilan Anda.

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 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 Google Ads suatu akun, Anda harus menentukan ID akun dan ID batas dalam panggilan ke accounts.limits.get. ID batas adalah kombinasi dari jenis dan cakupan batas. 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 mengetahui 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.

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 pengiriman.

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[]