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

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

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

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

  • คุณอัปเดตผลิตภัณฑ์ได้สูงสุด 2 ครั้งต่อวัน
  • คุณอัปเดตบัญชีย่อยได้วันละครั้งเท่านั้น

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

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

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

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