ตั้งแต่วันที่
8 กันยายน 2025 เป็นต้นไป รายการโฆษณาใหม่ทุกรายการจะต้องประกาศว่าจะแสดงโฆษณาทางการเมืองในสหภาพยุโรป (EU) หรือไม่ การอัปโหลด API ของ Display & Video 360 และ SDF ที่ไม่ได้ระบุการประกาศจะล้มเหลว ดูรายละเอียดเพิ่มเติมเกี่ยวกับวิธีอัปเดตการผสานรวมเพื่อประกาศนี้ได้ที่
หน้าการเลิกใช้งาน
ขีดจำกัดการใช้งาน
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
ขีดจํากัดการใช้งานช่วยปกป้องโครงสร้างพื้นฐานของ 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 คําค้นหาการเขียนต่อนาที
เมธอดต่อไปนี้ถือว่ามีการเขียนข้อมูลเป็นจำนวนมาก
เกินขีดจำกัดโควต้า
ในกรณีที่ส่งคำขอไม่สำเร็จเนื่องจากมีคำขอ API เกินขีดจำกัด API จะแสดงรหัสสถานะ HTTP และเหตุผลของข้อผิดพลาด
นอกจากนี้ เนื้อหาของการตอบกลับยังมีคำอธิบายโดยละเอียดเกี่ยวกับสาเหตุของข้อผิดพลาด
รายการต่อไปนี้แสดงข้อผิดพลาดที่เป็นไปได้และการดําเนินการที่แนะนําสําหรับคำขอที่ไม่สําเร็จซึ่งเกิดจากคำขอ API เกินขีดจํากัด
| รหัส |
RPC |
ข้อความ |
การดำเนินการที่แนะนำ |
429
|
RESOURCE_EXHAUSTED
|
ทรัพยากรหมดแล้ว (เช่น ตรวจสอบโควต้า)
|
ตรวจสอบการใช้งานจาก Google API Console และแก้ไขเวิร์กโฟลว์เพื่อเพิ่มประสิทธิภาพการประมวลผลคำขอที่ส่งภายใต้ผู้ลงโฆษณารายต่างๆ หรือโดยทั่วไปให้ช้าลง |
คุณไม่สามารถขอเพิ่มขีดจํากัดโควต้า Display & Video 360 API
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-07-25 UTC
[null,null,["อัปเดตล่าสุด 2025-07-25 UTC"],[[["\u003cp\u003eDisplay & Video 360 API usage is subject to quota limits to protect Google's infrastructure and ensure fair usage.\u003c/p\u003e\n"],["\u003cp\u003eTwo main quota types exist: total requests and write requests (methods modifying resources), with limits applied per project and per advertiser per project.\u003c/p\u003e\n"],["\u003cp\u003eCertain write-intensive methods consume more write quota than others.\u003c/p\u003e\n"],["\u003cp\u003eExceeding quota limits can lead to request throttling, indicated by a 429 error code, requiring adjustments to request frequency.\u003c/p\u003e\n"],["\u003cp\u003eQuota limit increases for the Display & Video 360 API are not available.\u003c/p\u003e\n"]]],[],null,["# Usage Limits\n\nUsage limits protect Google's infrastructure from automated processes that use\nthe Display \\& Video 360 API in an inappropriate way. They ensure that one developer's\nactions can't negatively impact the larger community.\n\nAPI request quota limits\n------------------------\n\nThe Display \\& Video 360 API uses two types of limits:\n\n- **Total quota limits**, which all relevant requests count against.\n- **Write quota limits** , which all relevant requests made to write methods count against. Write methods are defined as methods---such as `create`, `patch`, `delete`, or `bulkEdit`---that modify resources. Note that [some\n methods](#write_intensive) consume more write quota than others.\n\nIf your project exceeds any of these limits, [throttling could\noccur](#exceeding_limits).\n\n### Project-wide quota limit\n\nThe following default quota limits are shared by all Display \\& Video 360 API resources\nand methods:\n\n- **Total requests per minute per project:** `1500`\n- **Write requests per minute per project:** `700`\n\n### Advertiser-specific request quota limits\n\nMethods that specify an advertiser ID in the request URL count against\nadditional \"per advertiser per project\" quota limits.\n\nAll requests with an advertiser ID specified in their URL path---such as\nthose to the [`advertisers.lineItems`](/display-video/api/reference/rest/current/advertisers.lineItems),\n[`advertisers.creatives`](/display-video/api/reference/rest/current/advertisers.creatives), or\n[`advertisers.channels`](/display-video/api/reference/rest/current/advertisers.channels) services---will count against\nthe following quota limits:\n\n- **Total requests per minute per advertiser per project:** `300`\n- **Write requests per minute per advertiser per project:** `150`\n\nWrite-intensive methods\n-----------------------\n\nThe following API methods are write-intensive, meaning that they use a\nsignificant amount of product resources and, as a result, consume more\nwrite request quota than other write requests.\n\nRequests made to write-intensive methods are counted as 5 write queries\nwhen computing write request quota consumption. For example, 100 standard write\nrequests and 21 write-intensive requests (none of which specify an advertiser)\nmade within a minute would be counted as 205 write queries (`100 + (21 * 5) =\n205`) and would exceed the existing general request quota limit of 200 write\nqueries per minute.\n\nThe following methods are considered write-intensive:\n\n- [`customBiddingAlgorithms.scripts.create`](/display-video/api/reference/rest/current/customBiddingAlgorithms.scripts/create)\n- [`customBiddingAlgorithms.uploadScript`](/display-video/api/reference/rest/current/customBiddingAlgorithms/uploadScript)\n- [`firstPartyAndPartnerAudiences.create`](/display-video/api/reference/rest/current/firstPartyAndPartnerAudiences/create)\n- [`firstPartyAndPartnerAudiences.editCustomerMatchMembers`](/display-video/api/reference/rest/current/firstPartyAndPartnerAudiences/editCustomerMatchMembers)\n- [`media.upload`](/display-video/api/reference/rest/current/media/upload)\n\nExceeding quota limits\n----------------------\n\nIn the unlikely event that your request fails due to exceeding an API request\nlimit, the API returns an HTTP status code and reason for the error.\nAdditionally, the body of the response contains a detailed description of what\ncaused the error.\n\nThe following list shows the possible errors and recommended actions for\nrequest failures caused by exceeding API request limits.\n\n| Code | RPC | Message | Recommended Action |\n|-------|----------------------|--------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `429` | `RESOURCE_EXHAUSTED` | Resource has been exhausted (e.g., check quota). | [Examine your usage](//console.developers.google.com/project/_/apiui/apiview/displayvideo.googleapis.com/metrics) from the Google API Console and modify your workflow to better parallelize requests made under different advertisers or more generally slow down the rate at which you are sending requests. |\n\nIncreases cannot be requested for Display \\& Video 360 API quota limits."]]
