Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.
ReportTypes
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.
Tài nguyên reportType xác định một báo cáo cụ thể mà kênh hoặc chủ sở hữu nội dung có thể truy xuất.
Phương thức
Bảng sau đây cho biết các phương thức mà API này hỗ trợ cho tài nguyên report.
| Phương thức |
list |
Trả về danh sách các loại báo cáo mà kênh hoặc chủ sở hữu nội dung có thể truy xuất. |
Biểu diễn tài nguyên JSON
Cấu trúc JSON bên dưới cho thấy định dạng của tài nguyên reportType:
{
"id": string,
"name": string,
"deprecateTime": timestamp,
"systemManaged": boolean
}
Thuộc tính
Bảng sau đây xác định các thuộc tính xuất hiện trong tài nguyên này:
| Thuộc tính |
id |
string
Mã nhận dạng mà YouTube dùng để xác định riêng biệt báo cáo. Giá trị thuộc tính có độ dài tối đa là 100 ký tự. Bảng dưới đây xác định phiên bản gần đây nhất của từng loại báo cáo được hỗ trợ (tối đa 100 ký tự).
Xem các báo cáo được hỗ trợ cho kênh
| Mã báo cáo |
Mô tả |
| channel_basic_a2 |
Hoạt động của người dùng |
| channel_province_a2 |
Hoạt động của người dùng theo tỉnh |
| channel_playback_location_a2 |
Vị trí phát |
| channel_traffic_source_a2 |
Nguồn lưu lượng truy cập |
| channel_device_os_a2 |
Thiết bị và hệ điều hành |
| channel_demographics_a1 |
Thông tin nhân khẩu học |
| channel_sharing_service_a1 |
Dịch vụ chia sẻ |
| channel_annotations_a1 |
Chú thích |
| channel_cards_a1 |
Thẻ |
| channel_end_screens_a1 |
Màn hình kết thúc |
| channel_subtitles_a2 |
Phụ đề |
| channel_combined_a2 |
Kết hợp |
| audience_retention_a1 |
Tỷ lệ giữ chân người xem của video |
| playlist_basic_a1 |
Hoạt động của người dùng trên danh sách phát |
| playlist_province_a1 |
Hoạt động của người dùng đối với danh sách phát theo tỉnh |
| playlist_playback_location_a1 |
Vị trí phát danh sách phát |
| playlist_traffic_source_a1 |
Nguồn lưu lượng truy cập danh sách phát |
| playlist_device_os_a1 |
Thiết bị và hệ điều hành của danh sách phát |
| playlist_combined_a1 |
Danh sách phát kết hợp |
Xem các báo cáo được hỗ trợ dành cho chủ sở hữu nội dung
| Mã báo cáo |
Mô tả |
| content_owner_basic_a3 |
Hoạt động của người dùng |
| content_owner_province_a2 |
Hoạt động của người dùng theo tỉnh |
| content_owner_playback_location_a2 |
Vị trí phát |
| content_owner_traffic_source_a2 |
Nguồn lưu lượng truy cập |
| content_owner_device_os_a2 |
Thiết bị và hệ điều hành |
| content_owner_demographics_a1 |
Thông tin nhân khẩu học |
| content_owner_sharing_service_a1 |
Dịch vụ chia sẻ |
| content_owner_annotations_a1 |
Chú thích |
| content_owner_cards_a1 |
Thẻ |
| content_owner_end_screens_a1 |
Màn hình kết thúc |
| content_owner_subtitles_a2 |
Phụ đề |
| content_owner_combined_a2 |
Kết hợp |
| content_owner_playlist_basic_a1 |
Hoạt động của người dùng trên danh sách phát |
| content_owner_playlist_province_a1 |
Hoạt động của người dùng đối với danh sách phát theo tỉnh |
| content_owner_playlist_playback_location_a1 |
Vị trí phát danh sách phát |
| content_owner_playlist_traffic_source_a1 |
Nguồn lưu lượng truy cập danh sách phát |
| content_owner_playlist_device_os_a1 |
Thiết bị và hệ điều hành của danh sách phát |
| content_owner_playlist_combined_a1 |
Danh sách phát kết hợp |
| content_owner_ad_rates_a1 |
Hiệu suất quảng cáo |
| content_owner_estimated_revenue_a1 |
Doanh thu ước tính theo video |
| content_owner_asset_estimated_revenue_a1 |
Doanh thu ước tính theo tài sản |
| content_owner_asset_basic_a2 |
Hoạt động của người dùng đối với các thành phần |
| content_owner_asset_province_a2 |
Hoạt động của người dùng theo tỉnh đối với tài sản |
| content_owner_asset_playback_location_a2 |
Vị trí phát nội dung |
| content_owner_asset_traffic_source_a2 |
Nguồn lưu lượng truy cập của tài sản |
| content_owner_asset_device_os_a2 |
Thiết bị và hệ điều hành của tài sản |
| content_owner_asset_demographics_a1 |
Thông tin nhân khẩu học của tài sản |
| content_owner_asset_sharing_service_a1 |
Dịch vụ chia sẻ tài sản |
| content_owner_asset_annotations_a1 |
Chú giải thành phần |
| content_owner_asset_cards_a1 |
Thẻ tài sản |
| content_owner_asset_end_screens_a1 |
Màn hình kết thúc có thành phần |
| content_owner_asset_combined_a2 |
Tài sản được kết hợp |
Xem các báo cáo do hệ thống quản lý được hỗ trợ (dành cho chủ sở hữu nội dung)
| Mã báo cáo |
Mô tả |
content_owner_ad_revenue_raw_a1 |
Doanh thu từ quảng cáo thật chi tiết theo từng video |
content_owner_ad_revenue_summary_a1 |
Tổng doanh thu từ quảng cáo trên mỗi video |
content_owner_asset_ad_revenue_raw_a1 |
Doanh thu từ quảng cáo chi tiết theo từng thành phần |
content_owner_asset_ad_revenue_summary_a1 |
Tổng doanh thu từ quảng cáo trên mỗi tài sản |
content_owner_claim_ad_revenue_summary_a1 |
Thông báo xác nhận quyền sở hữu (báo cáo này không chứa dữ liệu về doanh thu) |
|
name |
string
Tên của báo cáo. Giá trị thuộc tính có độ dài tối đa là 100 ký tự. |
deprecateTime |
timestamp
Ngày và giờ báo cáo bị hoặc sẽ bị ngừng sử dụng. Nếu bạn có một lệnh cho loại báo cáo không dùng nữa, thì YouTube sẽ tạo báo cáo mới cho lệnh đó trong 3 tháng sau khi thông báo về việc ngừng sử dụng được đưa ra.
Ví dụ: thông báo về việc ngừng sử dụng báo cáo content_owner_basic_a1 được đưa ra vào ngày 19 tháng 5 năm 2016. Do đó, trường deprecateTime cho loại báo cáo đó chỉ định một thời điểm vào ngày 19 tháng 8 năm 2016, sau thời điểm đó YouTube sẽ ngừng tạo báo cáo thuộc loại đó. |
systemManaged |
boolean
Giá trị này là true nếu YouTube tự động tạo báo cáo cho chủ sở hữu nội dung trên YouTube mà không cần chủ sở hữu nội dung phải gọi phương thức jobs.create trước để hướng dẫn YouTube tạo báo cáo. Trên thực tế, phương thức jobs.create sẽ trả về lỗi nếu thuộc tính reportTypeId xác định một báo cáo do hệ thống quản lý. |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2026-09-15 UTC.
[[["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: 2026-09-15 UTC."],[],["A `reportType` resource defines a retrievable report for channels or content owners. The API supports listing available `reportTypes`. Each `reportType` has an `id`, `name`, `deprecateTime`, and `systemManaged` status. The `id` property identifies the report's type, such as user activity or demographics. `SystemManaged` reports are generated automatically, whereas other reports have to be called using the `jobs.create` method. The deprecation date marks when report generation stops.\n"]]