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

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

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

Display & Video 360 API ใช้ขีดจํากัด 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 คําค้นหาการเขียนต่อนาที

เมธอดต่อไปนี้ถือว่ามีการเขียนข้อมูลเป็นจำนวนมาก

• customBiddingAlgorithms.scripts.create
• customBiddingAlgorithms.uploadScript
• firstPartyAndPartnerAudiences.create
• firstPartyAndPartnerAudiences.editCustomerMatchMembers
• media.upload

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

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

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

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

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