Kể từ ngày 8 tháng 9 năm 2025, mỗi mục hàng mới sẽ cần phải khai báo xem mục hàng đó có phân phát quảng cáo chính trị ở Liên minh Châu Âu (EU) hay không. Display & Video 360 API và các tệp SDF được tải lên mà không cung cấp thông tin khai báo sẽ không thành công. Hãy xem trang thông báo về những nội dung không dùng nữa để biết thêm thông tin về cách cập nhật quy trình tích hợp để đưa ra nội dung khai báo này.
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Giới hạn sử dụng giúp bảo vệ cơ sở hạ tầng của Google khỏi các quy trình tự động sử dụng API Display & Video 360 theo cách không phù hợp. Các quy tắc này đảm bảo rằng hành động của một nhà phát triển không thể ảnh hưởng tiêu cực đến cộng đồng lớn hơn.
Giới hạn hạn mức yêu cầu API
API Display & Video 360 sử dụng hai loại giới hạn:
Tổng hạn mức hạn mức, trong đó tất cả các yêu cầu có liên quan đều được tính vào.
Giới hạn hạn mức ghi, trong đó tất cả các yêu cầu liên quan được thực hiện để ghi phương thức đều được tính vào. Phương thức ghi được xác định là các phương thức (chẳng hạn như create, patch, delete hoặc bulkEdit) sửa đổi tài nguyên. Xin lưu ý rằng một số phương thức tiêu thụ nhiều hạn mức ghi hơn so với các phương thức khác.
Tổng số yêu cầu mỗi phút trên mỗi nhà quảng cáo trên mỗi dự án:300
Số yêu cầu ghi mỗi phút trên mỗi nhà quảng cáo trên mỗi dự án:150
Các phương thức ghi dữ liệu nhiều
Các phương thức API sau đây có cường độ ghi cao, nghĩa là các phương thức này sử dụng một lượng lớn tài nguyên sản phẩm và do đó, tiêu thụ nhiều hạn mức yêu cầu ghi hơn so với các yêu cầu ghi khác.
Các yêu cầu được thực hiện cho các phương thức ghi dữ liệu nhiều sẽ được tính là 5 truy vấn ghi khi tính mức sử dụng hạn mức yêu cầu ghi. Ví dụ: 100 yêu cầu ghi tiêu chuẩn và 21 yêu cầu ghi chuyên sâu (không có yêu cầu nào chỉ định nhà quảng cáo) được thực hiện trong một phút sẽ được tính là 205 truy vấn ghi (100 + (21 * 5) =
205) và sẽ vượt quá hạn mức yêu cầu chung hiện tại là 200 truy vấn ghi mỗi phút.
Các phương thức sau đây được coi là phương thức ghi nhiều:
Trong trường hợp hiếm gặp yêu cầu của bạn không thành công do vượt quá giới hạn yêu cầu API, API sẽ trả về mã trạng thái HTTP và lý do gây ra lỗi.
Ngoài ra, nội dung của phản hồi chứa nội dung mô tả chi tiết về nguyên nhân gây ra lỗi.
Danh sách sau đây cho biết các lỗi có thể xảy ra và hành động được đề xuất đối với các yêu cầu không thành công do vượt quá giới hạn yêu cầu API.
Mã
RPC
Thông điệp
Việc nên làm
429
RESOURCE_EXHAUSTED
Tài nguyên đã
hết
(ví dụ: kiểm tra
hạn mức).
Kiểm tra mức sử dụng từ Google API Console và sửa đổi quy trình làm việc để chạy song song các yêu cầu được thực hiện theo nhiều nhà quảng cáo một cách hiệu quả hơn hoặc nói chung là làm chậm tốc độ gửi yêu cầu.
Bạn không thể yêu cầu tăng hạn mức hạn mức API Display & Video 360.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 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."]]
