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

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

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

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

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

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

Merchant API จะปรับโควต้าการเรียกใช้สำหรับรายการต่อไปนี้โดยอัตโนมัติ

• products และ accounts ตามการใช้งานของคุณ
• datasources สำหรับบัญชีขั้นสูงตามจำนวนบัญชีย่อย

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

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

• สำหรับทรัพยากรที่มีโควต้าอัตโนมัติ (products, accounts และ datasources สำหรับบัญชีขั้นสูง): คุณขอเพิ่มโควต้าชั่วคราว ได้เท่านั้นสำหรับสถานการณ์พิเศษ เช่น การเปิดตัวในตลาดใหม่หรือในช่วงฤดูช็อปปิ้งที่มีการเข้าชมสูง เราไม่รับคำขอเพิ่มโควต้าถาวรสำหรับทรัพยากรประเภทนี้
• สำหรับทรัพยากรอื่นๆ ทั้งหมดที่ไม่มีโควต้าอัตโนมัติ: คุณขอเพิ่มโควต้าได้ตามต้องการ

ใช้ปัญหา Quota increase request จากแบบฟอร์ม ติดต่อขอรับความช่วยเหลือ และกรอกข้อมูลต่อไปนี้

• รหัส 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[]