YouTube API Quota Exceeded: Causes and Fixes

Mỗi dự án Google Cloud được cấp quota mặc định 10.000 đơn vị mỗi ngày cho YouTube Data API v3, reset vào nửa đêm giờ Thái Bình Dương - không có chuyển tiếp và không có cách nào kích hoạt reset sớm. Quota được theo dõi theo dự án, không theo API key, nên tạo key thứ hai từ cùng một dự án không cho bạn thêm một hạn mức mới.

Mỗi lệnh gọi API tốn đơn vị, không phải theo số request - và chi phí không đồng đều. Đây là bức tranh đầy đủ trên các endpoint mà nhà phát triển thực sự dùng:

Với 100 đơn vị mỗi lần search, một dự án có thể dùng cạn toàn bộ quota hàng ngày chỉ sau 100 lệnh gọi tìm kiếm - trước cả khi tải một phụ đề nào. Đây là cách phổ biến nhất khiến các dự án nhỏ chạm giới hạn: họ không thực hiện 10.000 request, họ thực hiện vài trăm lệnh gọi đắt đỏ. Ngược lại, videos.list, channels.list, và playlistItems.list rẻ với 1 đơn vị mỗi lần - nếu bạn đã biết video, channel, hoặc playlist ID, những lệnh gọi đó gần như không ảnh hưởng đến ngân sách hàng ngày.

1. Mở Google Cloud Console cho dự án gắn với API key của bạn.
2. Vào APIs & Services → YouTube Data API v3 → Quotas & System Limits.
3. Nơi này hiển thị mức sử dụng hiện tại so với Queries per day và các giới hạn theo phút, cập nhật có độ trễ nhỏ chứ không phải theo thời gian thực.

Nếu bạn đã gần chạm trần trước khi thực hiện 10.000 request, đây là cách xác nhận đó là vấn đề lệnh gọi đắt đỏ nêu trên, không phải một lỗi.

Cả hai đều trả về mã 403, và cả hai thường bị gộp chung là "lỗi quota" trong trò chuyện thông thường, nhưng chúng là hai vấn đề khác nhau với cách khắc phục khác nhau:

• quotaExceeded (lý do: dailyLimitExceeded) - dự án của bạn đã dùng hết hạn mức đơn vị hàng ngày. Không có gì khắc phục được điều này ngoài chờ reset vào nửa đêm giờ Thái Bình Dương, giảm chi phí mỗi lệnh gọi, hoặc xin duyệt tăng quota.
• rateLimitExceeded - bạn đang gửi request quá nhanh trong một khoảng thời gian ngắn, độc lập với tổng số hàng ngày. Đây là vấn đề tốc độ, không phải ngân sách - xem hướng dẫn về rate limit của chúng tôi để biết cách xử lý đúng bằng backoff.

1. Cache mạnh tay. Quota bị tính theo mỗi lệnh gọi API, không theo mỗi request từ người dùng - nếu bạn lấy lại phụ đề của cùng một video nhiều lần, hãy cache kết quả (dù chỉ là một cache TTL trong bộ nhớ đơn giản) thay vì gọi lại API cho dữ liệu không thay đổi theo từng phút.
2. Tránh dùng search.list khi một tra cứu ID trực tiếp là đủ. Nếu bạn đã có video, channel, hoặc playlist ID, lệnh gọi .list tương ứng rẻ hơn 100 lần so với một search.
3. Gộp các tra cứu ID. videos.list chấp nhận tối đa 50 ID phân tách bằng dấu phẩy mỗi lệnh gọi với cùng chi phí 1 đơn vị như một ID đơn - lấy 50 video từng cái một thay vì gộp lại đắt hơn 50 lần mà không cần thiết.
4. Xin duyệt tăng quota khi bạn đã có lưu lượng sản xuất thực để làm căn cứ, qua biểu mẫu YouTube API Services Audit and Quota Extension liên kết từ trang quota của Cloud Console. Hãy chờ đợi một lượt xét duyệt thủ công, không phải phê duyệt tức thì.
5. Dùng một API transcript không chạy qua quota YouTube của riêng bạn. API của GetYouTubeTranscript lấy transcript trên hạ tầng riêng của nó thay vì proxy captions.download bằng key của bạn, nên không có trần 10.000 đơn vị/ngày nào cần quản lý - chỉ có giới hạn tốc độ request riêng của gói.

cURL:

curl "https://getyoutubetranscript.com/api/v1/transcript?v=dQw4w9WgXcQ" \
  -H "Authorization: Bearer sk_live_..."

Node.js:

const res = await fetch(
  "https://getyoutubetranscript.com/api/v1/transcript?v=dQw4w9WgXcQ",
  { headers: { Authorization: `Bearer ${process.env.GETYOUTUBETRANSCRIPT_API_KEY}` } }
);
const { data } = await res.json();
console.log(data.transcript);

Python:

import os, requests

res = requests.get(
    "https://getyoutubetranscript.com/api/v1/transcript",
    params={"v": "dQw4w9WgXcQ"},
    headers={"Authorization": f"Bearer {os.environ['GETYOUTUBETRANSCRIPT_API_KEY']}"},
)
print(res.json()["data"]["transcript"])

Việc này tốn 1 tín dụng trên gói GetYouTubeTranscript của bạn, không phải đơn vị trên quota YouTube Data API của dự án Google Cloud. Nhận 100 tín dụng miễn phí, không cần thẻ, từ dashboard, hoặc xem đầy đủ tài liệu API.