โควต้าและขีดจำกัด

บัญชีผู้ขาย และการใช้ Merchant API ของคุณอยู่ภายใต้โควต้าและขีดจำกัด

อัปเดตนโยบาย

Merchant API บังคับใช้นโยบายต่อไปนี้เกี่ยวกับการอัปเดต

  • คุณอัปเดตผลิตภัณฑ์ได้ไม่เกินวันละ 2 ครั้ง คุณควรแบ่งการเรียกใช้รายวันให้กระจายไปตลอดทั้งวันเพื่อให้เป็นไปตามโควต้าต่อนาที
  • คุณอัปเดตบัญชีย่อยได้เพียงวันละ 1 ครั้ง

โควต้าการเรียกใช้เมธอด

Merchant API จะปรับโควต้าการเรียกใช้สำหรับ products และ accounts โดยอัตโนมัติตามการใช้งานของคุณ

วิธีที่เราติดตามการใช้งานโควต้ามีดังนี้

  • โควต้าเป็นแบบต่อเมธอด เช่น เมธอด get มีโควต้าแยกจากเมธอด update
  • ระบบจะนับคำขอแต่ละรายการ 1 ครั้ง ไม่ว่าคำขอนั้นจะเป็นประเภทใดก็ตาม เช่น เราจะนับคำขอ list ที่มี 250 รายการเป็น 1 ครั้ง ไม่ใช่คำขอ get 250 รายการ
  • ระบบจะเรียกเก็บเงินโควต้าตามผู้ใช้ที่ส่งคำขอ API หากผู้ใช้เป็นสมาชิกโดยตรงของบัญชีขั้นสูง ระบบจะเรียกเก็บเงินโควต้าในระดับบัญชีขั้นสูง
  • โควต้าจะมีผลกับกลุ่มบริการช็อปปิ้งแบบเปรียบเทียบสินค้า (CSS), CSS, บัญชี หรือ บัญชีย่อย ที่คุณใช้ตรวจสอบสิทธิ์เมื่อทำการเรียกใช้ เช่น หากคุณ ตรวจสอบสิทธิ์ในฐานะบัญชีขั้นสูง ระบบจะนับการเรียกใช้ตามโควต้าของบัญชีขั้นสูง แต่หากคุณ ตรวจสอบสิทธิ์ในฐานะบัญชีย่อยบัญชีใดบัญชีหนึ่ง ระบบจะนับการเรียกใช้ตามโควต้าของ บัญชีย่อย

แผนภาพแสดงลำดับชั้นของกลุ่ม CSS, CSS, บัญชี และบัญชีย่อย กลุ่ม CSS คือระดับการตรวจสอบสิทธิ์ที่ครอบคลุม
โดยมี CSS แต่ละรายการภายในกลุ่ม บัญชีภายใน CSS เหล่านั้น และ
บัญชีย่อยเป็นระดับที่แยกย่อยที่สุด

การเปลี่ยนแปลงโควต้าการเรียกใช้เมธอดจาก Content API for Shopping

หากคุณใช้ Content API for Shopping โปรดทราบการเปลี่ยนแปลงโควต้าการเรียกใช้เมธอดต่อไปนี้ใน Merchant API

  • การไม่มีการจัดกลุ่มแบบกำหนดเองจะไม่ส่งผลต่อการคำนวณโควต้า เช่น ระบบจะเรียกเก็บเงินคำขอแบบกลุ่มที่มีคำขอแทรก 500 รายการเป็นคำขอเมธอดแทรกแต่ละรายการ 500 รายการ
  • ระบบจะยังคงใช้การทำงานอัตโนมัติของโควต้าสำหรับบัญชีและผลิตภัณฑ์
  • หากต้องการดูการใช้งานและขีดจำกัดโควต้าปัจจุบัน รวมถึงการทำงานอัตโนมัติและการลบล้าง ให้ใช้เมธอด Quota.list

ตรวจสอบโควต้าการเรียกใช้

หากต้องการตรวจสอบโควต้าการเรียกใช้และการใช้งานปัจจุบันของบัญชี ให้เรียกใช้ quotas.list พร้อมกับ name ของบัญชี

โควต้าอัตโนมัติใช้ได้กับบริการ products และ accounts เท่านั้น หากคุณต้องการเพิ่มโควต้าสำหรับบริการอื่นๆ, ใช้งาน บริการ products หรือ accounts จนถึงโควต้ารายวัน หรือต้องการเพิ่ม โควต้าชั่วคราวสำหรับ accounts หรือ products services, ติดต่อ เราพร้อมข้อมูลต่อไปนี้

  • รหัส Merchant Center
  • เมธอดที่คุณใช้งานจนถึงขีดจำกัดโควต้า
  • จำนวนการเรียกใช้ต่อวันที่คุณต้องการสำหรับเมธอดเหล่านั้นโดยประมาณ
  • เหตุผลที่คุณต้องการเพิ่มโควต้า
  • การเพิ่มนี้เป็นการเพิ่มชั่วคราวหรือถาวร

เราขอแนะนำให้ตรวจสอบโควต้าเป็นระยะๆ เพื่อให้แน่ใจว่าคุณมีโควต้าเพียงพอสำหรับการใช้งาน หรือดูว่าระบบปรับโควต้าของคุณโดยอัตโนมัติอย่างไร

ข้อผิดพลาด

หากคุณใช้งานเกินโควต้า คุณจะได้รับข้อผิดพลาดต่อไปนี้

  • ต่อนาที: quota/request_rate_too_high
  • ต่อวัน: quota/daily_limit_exceeded

หากต้องการดูโควต้าและการใช้งาน รวมถึงขอเพิ่มโควต้าต่อวันหรือต่อนาที โปรดดูตรวจสอบโควต้าการเรียกใช้

ข้อผิดพลาดต่อไปนี้ไม่สามารถแก้ไขได้ด้วยการเพิ่มโควต้าอัตโนมัติ และคุณต้องขอโควต้าสินค้า ฟีด หรือ บัญชีย่อยเพิ่มเติม

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

ขีดจำกัดบัญชี

เมธอด accounts.limits.get และ accounts.limits.list ช่วยให้คุณตรวจสอบ ขีดจำกัดของเอนทิตีระดับบัญชีได้ คุณสามารถใช้เมธอดเหล่านี้เพื่อตรวจสอบขีดจำกัดของผลิตภัณฑ์ได้

หากต้องการดึงข้อมูลขีดจำกัดของผลิตภัณฑ์ที่เฉพาะเจาะจง เช่น หากต้องการดูโควต้าโฆษณาใน EEA ของบัญชี คุณต้องระบุรหัสบัญชีและรหัสขีดจำกัด ในการเรียกใช้ accounts.limits.get รหัสขีดจำกัดเป็นการรวมกันของประเภทขีดจำกัดและขอบเขต เช่น products~ADS_EEA สำหรับผลิตภัณฑ์ที่กำหนดเป้าหมายโฆษณาใน EEA และ products~ADS_NON_EEA สำหรับผลิตภัณฑ์ที่กำหนดเป้าหมายโฆษณานอก EEA

ตัวอย่างคำขอเพื่อดูขีดจำกัด products~ADS_EEA สำหรับบัญชีที่กำหนดมีดังนี้

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

หากต้องการดูรหัสขีดจำกัดที่ใช้ได้สำหรับบัญชี ให้ใช้ accounts.limits.list พร้อมตัวกรองสำหรับ type="products"

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับโควต้าผลิตภัณฑ์ได้ที่ ทำความเข้าใจโควต้าใน Google Merchant Center

ขีดจำกัดของการแสดงทรัพยากร

ขีดจำกัดต่อไปนี้อธิบายข้อจำกัดที่สำคัญสำหรับค่าสตริงและฟิลด์อาร์เรย์บางรายการภายในการแสดงทรัพยากรที่ใช้ใน Merchant API ขีดจำกัดเหล่านี้เหมือนกันสำหรับทั้ง Merchant API และฟีเจอร์ที่เกี่ยวข้องใน Merchant Center

โปรดทราบว่ารายการขีดจำกัดนี้อาจไม่สมบูรณ์ เราจะไม่ขยายขีดจำกัดเหล่านี้

ทรัพยากร ช่อง ขีดจำกัด
shippingsettings

บริการจัดส่งต่อประเทศ (services)

กลุ่มการจัดส่งต่อบริการจัดส่ง (rateGroups)

ป้ายกำกับต่อกลุ่มการจัดส่ง (applicableShippingLabels)

ตารางย่อยต่อกลุ่มการจัดส่ง (subtables)

จำนวนแถวหรือคอลัมน์ใน ตารางอัตรา เดียว

ความยาวของป้ายกำกับการจัดส่ง

20

20

30

100

150

100

จำนวนแถวหรือคอลัมน์ในตารางอัตราจะส่งผลต่อฟิลด์อาร์เรย์ต่อไปนี้

  • ฟิลด์อาร์เรย์ภายใน rowHeaders หรือ columnHeaders
    • prices[]
    • weights[]
    • numberOfItems[]
    • postalCodeGroupNames[]
    • locations[]
    • rows[]
    • cells[]