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

บัญชีผู้ขายและการใช้ 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, บัญชี และบัญชีย่อย

การเปลี่ยนแปลงโควต้าการเรียกใช้เมธอดจาก 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

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

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

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