Chúng tôi đang cập nhật YouTube Analytics và API Báo cáo để phù hợp với cách YouTube tính số lượt xem video ngắn.
Tìm hiểu thêm
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 hỗ trợ cho các tài nguyên report
.
Phương thức |
list |
Trả về danh sách các loại báo cáo mà chủ sở hữu nội dung hoặc kênh có thể truy xuất. |
Biểu diễn tài nguyên JSON
Cấu trúc JSON dưới đây 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 sử dụng để xác định duy nhất báo cáo. Giá trị thuộc tính có độ dài tối đa là 100 ký tự. Bảng bên dưới xác định phiên bản mới 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
Báo cáo |
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 cho video |
playlist_basic_a1 |
Hoạt động của người dùng trong danh sách phát |
playlist_province_a1 |
Hoạt động của người dùng 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 vào danh sách phát |
playlist_device_os_a1 |
Thiết bị danh sách phát và hệ điều hành |
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
Báo cáo |
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 trong danh sách phát |
content_owner_playlist_province_a1 |
Hoạt động của người dùng 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 vào danh sách phát |
content_owner_playlist_device_os_a1 |
Thiết bị danh sách phát và hệ điều hành |
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 nội dung |
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 các tài sản |
content_owner_asset_playback_location_a2 |
Vị trí phát tài sản |
content_owner_asset_traffic_source_a2 |
Nguồn lưu lượng truy cập của thành phầ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 thành phần |
content_owner_asset_sharing_service_a1 |
Dịch vụ chia sẻ tài sản |
content_owner_asset_annotations_a1 |
Chú thích về thành phần |
content_owner_asset_cards_a1 |
Thẻ thành phần |
content_owner_asset_end_screens_a1 |
Màn hình kết thúc của 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 được hỗ trợ do hệ thống quản lý (dành cho chủ sở hữu nội dung)
Báo cáo do hệ thống quản lý |
content_owner_ad_revenue_raw_a1 |
Doanh thu quảng cáo chi tiết trên mỗi video |
content_owner_ad_revenue_summary_a1 |
Tổng doanh thu quảng cáo trên mỗi video |
content_owner_asset_ad_revenue_raw_a1 |
Doanh thu quảng cáo chi tiết trên mỗi tài sản |
content_owner_asset_ad_revenue_summary_a1 |
Tổng doanh thu 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 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 được hoặc sẽ không được dùng nữa. Nếu bạn có công việc cho một loại báo cáo không dùng nữa, YouTube sẽ tạo báo cáo mới cho công việc đó trong vòng 3 tháng sau ngày công bố ngày ngừng hoạt động.
Ví dụ: thông báo về việc ngừng sử dụng báo cáo content_owner_basic_a1 là vào ngày 19 tháng 5 năm 2016. Do đó, trường deprecateTime cho loại báo cáo đó chỉ định thời điểm là 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 cần 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: 2024-08-21 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: 2024-08-21 UTC."],[[["A `reportType` resource in the YouTube API defines a specific report that can be retrieved by a channel or content owner."],["The API supports listing available report types via the `reportTypes.list` method, enabling users to identify the reports they can access."],["Each `reportType` resource is represented in JSON and includes properties such as `id`, `name`, `deprecateTime`, and `systemManaged`, detailing the report's identifier, name, deprecation status, and whether it is system-managed."],["The `id` property of a report type can help identify the most recent version of the report, and there are different reports for channels, content owners and system managed."],["The `systemManaged` property indicates whether a report is automatically generated by YouTube for content owners, or if they need to use the jobs.create method to initiate report generation."]]],["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"]]