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

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

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

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

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

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

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

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

  • โควต้าเป็นแบบต่อเมธอด เช่น getเมธอดมีโควต้าแยกต่างหากจากupdateเมธอด
  • ระบบจะนับคำขอแต่ละรายการ 1 ครั้ง ไม่ว่าจะเป็นคำขอประเภทใดก็ตาม เช่น เราจะนับlistคำขอที่มีสินค้า 250 รายการ 1 ครั้ง ไม่ใช่ 250 getคำขอ
  • ระบบจะเรียกเก็บเงินโควต้าตามผู้ใช้ที่ส่งคำขอ API หากผู้ใช้เป็นสมาชิกโดยตรงของบัญชีขั้นสูง ระบบจะเรียกเก็บโควต้า ในระดับบัญชีขั้นสูง
  • โควต้าจะมีผลกับกลุ่ม Comparison Shopping Services (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 หรือผลิตภัณฑ์ 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[]