ขีดจํากัดการใช้งาน

ขีดจำกัดการใช้งานจะปกป้องโครงสร้างพื้นฐานของ Google จากกระบวนการอัตโนมัติที่ใช้ API ของ Display & Video 360 ในลักษณะที่ไม่เหมาะสม ทำให้มั่นใจได้ว่าการดำเนินการของนักพัฒนาซอฟต์แวร์ คนหนึ่งๆ จะไม่ส่งผลเชิงลบต่อชุมชนขนาดใหญ่

ขีดจำกัดโควต้าคำขอ API

API ของ Display & Video 360 ใช้ขีดจำกัด 2 ประเภท ดังนี้

  • ขีดจำกัดโควต้าทั้งหมด ซึ่งคำขอที่เกี่ยวข้องทั้งหมดนับรวมด้วย
  • ขีดจำกัดโควต้าการเขียน ซึ่งคำขอที่เกี่ยวข้องทั้งหมดที่สร้างขึ้นสำหรับวิธีการเขียนจะนับด้วย วิธีการเขียนหมายถึงวิธีการต่างๆ เช่น create, patch, delete หรือ bulkEdit ที่ใช้แก้ไขทรัพยากร โปรดทราบว่าบางวิธีการใช้โควต้าการเขียนมากกว่าวิธีอื่นๆ

หากโปรเจ็กต์เกินขีดจํากัดเหล่านี้ อาจมีการควบคุม

ขีดจำกัดโควต้าของทั้งโปรเจ็กต์

ทรัพยากรและเมธอดทั้งหมดของ Display & Video 360 API จะใช้ขีดจำกัดโควต้าเริ่มต้นต่อไปนี้

  • คำขอทั้งหมดต่อนาทีต่อโปรเจ็กต์: 1500
  • เขียนคำขอต่อนาทีต่อโปรเจ็กต์: 700

ขีดจำกัดโควต้าคำขอเฉพาะผู้ลงโฆษณา

วิธีการที่ระบุรหัสผู้ลงโฆษณาใน URL คำขอจะนับรวมในขีดจำกัดโควต้า "ต่อผู้ลงโฆษณาต่อโปรเจ็กต์" เพิ่มเติม

คำขอทั้งหมดที่มีรหัสผู้ลงโฆษณาระบุไว้ในเส้นทาง URL เช่น คำขอที่ส่งไปยังบริการ advertisers.lineItems, advertisers.creatives หรือ advertisers.channels จะนับรวมในขีดจำกัดโควต้าต่อไปนี้

  • คำขอทั้งหมดต่อนาทีต่อผู้ลงโฆษณาต่อโปรเจ็กต์: 300
  • เขียนคำขอต่อนาทีต่อผู้ลงโฆษณาต่อโปรเจ็กต์: 150

วิธีการเขียนที่ใช้ความมาก

เมธอด API ต่อไปนี้จะมีการเขียนจำนวนมาก ซึ่งหมายความว่าจะใช้ทรัพยากรของผลิตภัณฑ์ในปริมาณมาก และส่งผลให้ใช้โควต้าคำขอเขียนมากกว่าคำขอการเขียนอื่นๆ

คำขอที่ส่งไปยังเมธอดที่มีการเขียนจำนวนมากจะนับเป็นคำขอเขียน 5 รายการเมื่อใช้โควต้าคำขอเขียนในการประมวลผล ตัวอย่างเช่น คำขอเขียนมาตรฐาน 100 คำขอและคำขอเขียนที่ใช้เวลาเขียนมาก 21 คำขอ (ไม่ระบุผู้ลงโฆษณา) ที่สร้างขึ้นภายใน 1 นาทีจะนับเป็นคำค้นหาการเขียน 205 คำขอ (100 + (21 * 5) = 205) และจะทำให้เกินขีดจำกัดโควต้าคำขอทั่วไปที่มีอยู่ 200 คำค้นหาต่อนาที

วิธีการต่อไปนี้ถือเป็นวิธีการเขียนที่ใช้ทรัพยากรมาก

เกินขีดจำกัดโควต้า

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

รายการต่อไปนี้แสดงข้อผิดพลาดที่เป็นไปได้และการดำเนินการที่แนะนำสำหรับความล้มเหลวในการขอที่เกิดจากการเกินขีดจำกัดของคำขอ API

รหัส RPC ข้อความ การดำเนินการที่แนะนำ
429 RESOURCE_EXHAUSTED ทรัพยากรหมดแล้ว (เช่น ตรวจสอบโควต้า) ตรวจสอบการใช้งานของคุณจากคอนโซล Google API และแก้ไขเวิร์กโฟลว์ให้ส่งคำขอที่ส่งมาจากผู้ลงโฆษณารายต่างๆ พร้อมกันได้ดียิ่งขึ้น หรือชะลอการส่งคำขอโดยทั่วไป

ไม่สามารถขอเพิ่มขีดจำกัดโควต้า API ของ Display & Video 360