YouTube¶
Đang trong giai đoạn thử nghiệm
Base URL:
https://api.logidata.vn/v1/youtube{đường dẫn YouTube Data API v3}
https://api.logidata.vn/v1/youtube-analytics/reports
Đường dẫn, tham số và response giống hệt YouTube Data API
v3 và YouTube Analytics
API. Gốc là
https://www.googleapis.com/youtube/v3 và
https://youtubeanalytics.googleapis.com/v2.
Một kết nối = một kênh YouTube (channel_id). youtube và
youtube-analytics dùng chung một kết nối — cấp quyền một lần, gọi được cả
hai.
Điều Logidata làm hộ bạn¶
| Việc | Gọi thẳng YouTube | Qua Logidata |
|---|---|---|
| Đăng ký project Google Cloud + xin xác minh OAuth cho scope nhạy cảm | Bạn làm, chờ Google duyệt | Đã có |
| Luồng OAuth theo từng kênh | Bạn dựng | Bấm một nút trên portal |
| Access token sống đúng 1 giờ — phải đổi refresh token lấy token mới | Bạn dựng cron + xử lý đua refresh | Tự động, có khoá phân tán |
| Đếm quota theo unit (không phải theo request) và phanh trước khi cạn | Bạn tự theo dõi | Tự động |
Nhóm dữ liệu — kênh của bạn (youtube)¶
Allowlist chỉ đọc. Tất cả đều là lệnh .list = 1 unit quota.
| Nhóm | Đường dẫn gốc | Dùng để |
|---|---|---|
| Kênh của bạn | /channels (mine=true) |
Subscriber, tổng lượt xem, và playlist tải lên dùng cho bước kế tiếp |
| Playlist | /playlists (mine=true) |
Playlist do kênh tự tạo |
| Video đã đăng | /playlistItems |
Duyệt video của kênh qua playlist tải lên |
| Chi tiết + thống kê video | /videos |
Lượt xem, like, comment, thời lượng — tối đa 50 ID/lần |
| Bình luận | /commentThreads |
Bình luận và trả lời trên video của kênh |
Cách dùng API /search
Để tìm một kênh: khách dán URL/handle → channels.list?forHandle= (1 unit).
Để liệt kê video của kênh: playlistItems.list trên playlist tải lên
(1 unit / 50 video), không search.list?channelId=.
Nhóm dữ liệu — Analytics kênh (youtube-analytics)¶
| Đường dẫn gốc | Dùng để |
|---|---|
/reports |
Báo cáo tuỳ biến: lượt xem, thời lượng xem, subscriber tăng/giảm theo ngày/video/quốc gia; từ khoá người xem gõ để tìm ra video của bạn (insightSearchTerms); nguồn traffic; nhân khẩu học; doanh thu kênh (estimatedRevenue, estimatedAdRevenue, grossRevenue, cpm, playbackBasedCpm) |
Trên trang Chạy thử có sẵn các mẫu báo cáo cho
/reports (tổng quan, từ khoá người xem, nguồn traffic, top video, doanh thu
theo ngày) — chọn mẫu là nạp sẵn bộ metrics/dimensions hợp lệ. Gọi qua API
thì truyền thẳng metrics/dimensions; xem YouTube Analytics
API cho danh sách đầy
đủ.
Chỉ số doanh thu cần kênh đã bật kiếm tiền
Các chỉ số estimatedRevenue, estimatedAdRevenue, grossRevenue, cpm,
playbackBasedCpm chỉ có với kênh đã vào YouTube Partner Program (YPP). Kênh
chưa bật kiếm tiền gọi vẫn thành công (HTTP 200) nhưng danh sách kết quả rỗng
— đó là trạng thái bình thường, không phải lỗi.
Xác thực và mã lỗi¶
youtube và youtube-analytics: X-API-Key + X-Account-Id (trỏ tới một kênh
YouTube) như mọi nền tảng khác.
Mã lỗi Logidata riêng cho nhóm này:
| HTTP | code |
Nghĩa |
|---|---|---|
| 429 | youtube_quota_exhausted |
Quota unit dùng chung trong ngày đã tới ngưỡng ngắt. Chờ sang ngày mới (giờ Thái Bình Dương). Được hoàn lại hạn mức tháng. |
| 401 | token_revoked |
Kênh đã thu hồi quyền hoặc đổi mật khẩu. Vào portal cấp lại quyền. |
| 403 | (lỗi gốc của YouTube) | Truy vấn chỉ số doanh thu trên một kết nối cấp quyền trước 2026-09-04 — grant đó chưa có quyền đọc doanh thu. Vào portal cấp quyền lại kênh YouTube. Khác token_revoked: các truy vấn Analytics khác của kết nối này vẫn chạy bình thường. |