Dimensions

Tài liệu này xác định các phương diện mà API YouTube Analytics hỗ trợ. API này hỗ trợ các truy vấn được nhắm mục tiêu theo thời gian thực để tạo báo cáo YouTube Analytics tuỳ chỉnh.

Phương diện là những tiêu chí phổ biến dùng để tổng hợp dữ liệu, chẳng hạn như ngày diễn ra hoạt động của người dùng hoặc quốc gia nơi người dùng sinh sống.

Mỗi báo cáo truy vấn sẽ xác định các phương diện được hỗ trợ. Ví dụ: khi truy xuất hoạt động của người dùng theo thời gian, bạn hãy chọn khoảng thời gian mà dữ liệu sẽ được báo cáo: ngày hoặc tháng. Trong bất kỳ báo cáo nào, mỗi hàng dữ liệu có một tổ hợp giá trị phương diện riêng biệt.

Để truy xuất báo cáo truy vấn, hãy gọi phương thức reports.query của API YouTube Analytics. Trong yêu cầu của bạn, hãy sử dụng thông số dimensions để chỉ định các phương diện mà YouTube sẽ sử dụng để tính giá trị chỉ số trong báo cáo.

Kích thước chính

Mặc dù API YouTube Analytics phải tuân thủ Chính sách về việc ngừng sử dụng được quy định trong Điều khoản dịch vụ, nhưng các phương diện không phải chính (và các chỉ số không phải chính) sẽ không phải tuân thủ chính sách này. Trong các định nghĩa trên trang này, bất kỳ phương diện nào là phương diện chính đều được xác định rõ ràng theo cách đó.

Danh sách sau đây xác định các phương diện chính của API.

Hãy xem danh sách các API YouTube tuân thủ Chính sách về việc ngừng sử dụng để biết thêm thông tin.

Bộ lọc

Tất cả báo cáo truy vấn đều hỗ trợ bộ lọc. Bộ lọc xác định những giá trị phương diện phải có trong tập dữ liệu đã truy xuất. Do đó, chúng giới hạn phản hồi API chỉ bao gồm dữ liệu khớp với một giá trị hoặc tập giá trị cụ thể. Ví dụ: thay vì truy xuất chỉ số hoạt động của người dùng ở tất cả các quốc gia, bạn có thể sử dụng một bộ lọc để chỉ truy xuất dữ liệu cho một quốc gia cụ thể.

Trong yêu cầu truy xuất báo cáo truy vấn, tham số yêu cầu filters (không bắt buộc) sẽ chỉ định các giá trị phương diện mà bạn muốn lọc dữ liệu. Ví dụ: để truy xuất chỉ số hoạt động của người dùng ở Châu Âu, bạn cần đặt giá trị tham số filters thành continent==150.

Lưu ý quan trọng: Các yêu cầu API để truy xuất báo cáo của chủ sở hữu nội dung phải lọc dữ liệu bằng cách sử dụng một trong các phương diện thực thể báo cáo hoặc kết hợp các phương diện claimedStatus và uploaderType được hỗ trợ.

Kích thước

Các phần sau đây xác định phương diện được sử dụng trong báo cáo truy vấn của API YouTube Analytics. Trừ phi có ghi chú khác, các phương diện này sẽ được dùng trong cả báo cáo kênh và báo cáo của chủ sở hữu nội dung. Những phương diện chỉ có thể dùng làm bộ lọc cũng được xác định.

Tài nguyên

Các phương diện sau tương ứng với tài nguyên mà kênh và chủ sở hữu nội dung quản lý trên YouTube:

Lưu ý: API cho phép bạn chỉ định nhiều giá trị cho các phương diện video, playlist và channel khi các giá trị đó được dùng làm bộ lọc. Để thực hiện việc này, hãy đặt giá trị tham số filters thành một danh sách được phân tách bằng dấu phẩy gồm các mã video, danh sách phát hoặc mã kênh cần lọc phản hồi API. Giá trị thông số có thể chỉ định tối đa 500 mã nhận dạng.

video (phương diện cốt lõi)
Mã nhận dạng của video trên YouTube. Trong API dữ liệu YouTube, đây là giá trị thuộc tính id của tài nguyên video. This is a core dimension and is subject to the Deprecation Policy.
danh sách phát
Mã nhận dạng của một danh sách phát trên YouTube. Trong API dữ liệu YouTube, đây là giá trị thuộc tính id của tài nguyên playlist.
kênh (phương diện cốt lõi) (chỉ được dùng trong báo cáo của chủ sở hữu nội dung)
Mã nhận dạng của một kênh YouTube. Trong API dữ liệu YouTube, đây là giá trị thuộc tính id của tài nguyên channel. This is a core dimension and is subject to the Deprecation Policy.

Phương diện channel thường được dùng trong các báo cáo của chủ sở hữu nội dung vì những báo cáo này thường tổng hợp dữ liệu cho nhiều kênh.
nhóm (chỉ lọc)
Mã nhận dạng của một nhóm trong YouTube Analytics. Bạn có thể truy xuất giá trị này bằng phương thức groups.list của API YouTube Analytics. Khi bạn sử dụng bộ lọc group, phản hồi của API chứa dữ liệu về tất cả video, danh sách phát hoặc kênh trong nhóm đó.

Ví dụ

Các yêu cầu mẫu sau đây sử dụng phương diện hoặc bộ lọc của thực thể báo cáo:

  • Ví dụ về kênh

    • Số liệu thống kê cơ bản
      • 10 video hàng đầu – Các video được xem nhiều nhất của một kênh
      • 10 hàng đầu – Tỷ lệ nhấp vào chú thích cho những video được xem nhiều nhất của một kênh
      • Số liệu thống kê cho một danh sách phát cụ thể
      • 10 hàng đầu – Danh sách phát được xem nhiều nhất của một kênh
    • Địa lý
      • 10 video hàng đầu – Các video có nhiều lượt xem nhất ở một quốc gia cụ thể
      • 10 video hàng đầu – Những video được xem nhiều nhất tại Châu Âu

  • Ví dụ về chủ sở hữu nội dung

    • Số liệu thống kê cơ bản
      • 10 video hàng đầu – Những video được xem nhiều nhất của một chủ sở hữu nội dung
      • 10 video hàng đầu – Những video được xem nhiều nhất của một chủ sở hữu nội dung
      • 10 video hàng đầu – Các video được xem nhiều nhất trên kênh của một chủ sở hữu nội dung
      • 10 hàng đầu – Tỷ lệ nhấp vào chú thích cho những video được xem nhiều nhất của một kênh
      • 10 danh sách phát hàng đầu – Danh sách phát được xem nhiều nhất của một chủ sở hữu nội dung
    • Địa lý
      • 10 video hàng đầu – Những video được xem nhiều nhất ở Châu Âu đối với một chủ sở hữu nội dung
      • 10 danh sách phát hàng đầu – Các danh sách phát được bắt đầu nhiều nhất ở Hoa Kỳ

Khu vực địa lý

Các phương diện này xác định khu vực địa lý liên quan đến hoạt động của người dùng, hiệu suất quảng cáo hoặc chỉ số doanh thu ước tính.

country (phương diện chính)
Quốc gia liên kết với các chỉ số trong hàng báo cáo. Giá trị phương diện là mã quốc gia gồm hai chữ cái theo tiêu chuẩn ISO-3166-1, chẳng hạn như US, CN (Trung Quốc) hoặc FR (Pháp). Mã quốc gia ZZ dùng để báo cáo những chỉ số mà YouTube không thể xác định quốc gia có liên quan. This is a core dimension and is subject to the Deprecation Policy.
province
Tiểu bang hoặc lãnh thổ của Hoa Kỳ liên kết với các chỉ số trong hàng báo cáo. Giá trị phương diện là mã ISO 3166-2 giúp xác định một tiểu bang của Hoa Kỳ hoặc Đặc khu Columbia, chẳng hạn như US-MI (Michigan) hoặc US-TX (Texas). Mã tỉnh US-ZZ dùng để báo cáo những chỉ số mà YouTube không thể xác định tiểu bang có liên quan của Hoa Kỳ. Khi một yêu cầu API đưa province vào giá trị thông số dimensions, thì yêu cầu đó cũng phải giới hạn dữ liệu ở Hoa Kỳ bằng cách thêm country==US vào giá trị thông số filters.

Lưu ý: Phương diện này không hỗ trợ các giá trị ISO 3166-2 xác định các khu vực ngoại vi của Hoa Kỳ vì những lãnh thổ đó cũng có mã quốc gia ISO 3166-1 riêng. Tính năng này cũng không hỗ trợ phân mục của các quốc gia không phải Hoa Kỳ.

city
Thành phố ước tính liên kết với các chỉ số trong hàng báo cáo. Bạn có thể xem dữ liệu cho phương diện này cho những ngày bắt đầu từ ngày 1 tháng 1 năm 2022.
lục địa (chỉ lọc)
Mã vùng thống kê của Liên Hợp Quốc (UN). API hỗ trợ các giá trị sau:
Giá trị
002 Châu Phi
019 Châu Mỹ (Bắc Mỹ, Mỹ Latinh, Nam Mỹ và Caribbean)
142 Châu Á
150 Châu Âu
009 Châu Đại dương
Phương diện này chỉ có thể được dùng để lọc dữ liệu. Để sử dụng phương diện này, hãy đặt giá trị của tham số filters thành continent==REGION_CODE, chỉ định giá trị REGION_CODE từ danh sách ở trên.
subContinent (chỉ bộ lọc)
Mã khu vực thống kê của Liên Hợp Quốc giúp xác định một khu vực địa lý phụ. Cục Thống kê Liên Hợp Quốc liệt kê các tiểu vùng cũng như các quốc gia liên kết với từng khu vực.

Phương diện này chỉ có thể được dùng để lọc dữ liệu. Để sử dụng phương diện này, hãy đặt giá trị của tham số filters thành subContinent==REGION_CODE, sau đó chỉ định giá trị REGION_CODE trong danh sách của Liên Hợp Quốc.

Ví dụ

Các yêu cầu mẫu sau đây sử dụng phương diện hoặc bộ lọc địa lý:

  • Ví dụ về kênh

    • Số liệu thống kê cơ bản: Số lượt xem theo quốc gia cụ thể (và các số liệu khác) của một kênh
    • Địa lý
      • Chỉ số thời gian xem video của một kênh theo quốc gia
      • Chỉ số chú thích theo quốc gia cụ thể cho video của kênh
      • Chỉ số theo tỉnh cụ thể cho các tiểu bang của Hoa Kỳ và Washington D.C.
      • Chỉ số thời gian xem theo quốc gia cụ thể cho danh sách phát của một kênh
      • 10 danh sách phát hàng đầu – Các danh sách phát được bắt đầu nhiều nhất ở Hoa Kỳ
    • Vị trí phát: Số lượt xem hằng ngày và thời gian xem ở nhiều vị trí phát
    • Nguồn lưu lượng truy cập: Số lượt xem và thời gian xem từ nhiều nguồn lưu lượng truy cập trong một quốc gia
    • Thông tin nhân khẩu học: Thông tin nhân khẩu học của người xem ở California (nhóm tuổi và giới tính)
    • Video hàng đầu
      • 10 video hàng đầu – Các video có nhiều lượt xem nhất ở một quốc gia cụ thể
      • 10 video hàng đầu – Những video được xem nhiều nhất tại Châu Âu

  • Ví dụ về chủ sở hữu nội dung

    • Số liệu thống kê cơ bản: Số lượt xem theo quốc gia cụ thể (và các thông tin khác) của tất cả video tự tải lên
    • Địa lý
      • Chỉ số thời gian xem theo quốc gia cụ thể đối với nội dung tự tải lên
      • Chỉ số chú thích theo quốc gia cụ thể cho nội dung tự tải lên
      • Chỉ số theo tỉnh cụ thể cho các tiểu bang của Hoa Kỳ và Washington D.C.
      • Chỉ số thời gian xem theo quốc gia cụ thể cho danh sách phát của một chủ sở hữu nội dung
      • 10 danh sách phát hàng đầu – Các danh sách phát được bắt đầu nhiều nhất ở Hoa Kỳ
    • Vị trí phát: Số lượt xem hằng ngày và thời gian xem ở nhiều vị trí phát
    • Thông tin nhân khẩu học: Thông tin nhân khẩu học của người xem ở California (nhóm tuổi và giới tính)
    • Video hàng đầu: 10 video hàng đầu – Những video được xem nhiều nhất ở Châu Âu đối với một chủ sở hữu nội dung
    • Doanh thu/Hiệu suất quảng cáo: Chỉ số doanh thu và hiệu suất quảng cáo theo quốc gia

Khoảng thời gian

Những phương diện này cho biết báo cáo phải tổng hợp dữ liệu dựa trên một khoảng thời gian, chẳng hạn như ngày, tuần hoặc tháng. Thông số yêu cầu startDate và endDate chỉ định khoảng thời gian mà báo cáo bao gồm dữ liệu. Lưu ý rằng báo cáo thực sự trả về dữ liệu cho đến ngày cuối cùng mà tất cả các chỉ số được chỉ định trong yêu cầu có sẵn tại thời điểm thực hiện truy vấn. Trong báo cáo, ngày được liệt kê ở định dạng YYYY-MM-DD.

Lưu ý quan trọng: Tất cả ngày tháng đều là khoảng thời gian bắt đầu từ 0 giờ sáng theo giờ Thái Bình Dương (UTC-7 hoặc UTC-8) và kết thúc lúc 23 giờ 59 phút theo giờ Thái Bình Dương vào ngày, tháng và năm đã chỉ định. Do đó, ngày mà đồng hồ được điều chỉnh tiến theo Giờ mùa hè biểu thị khoảng thời gian 23 giờ, còn ngày mà đồng hồ được điều chỉnh lùi tương ứng với khoảng thời gian 25 giờ.

Phương diện tháng đề cập đến khoảng thời gian bắt đầu từ 12 giờ sáng theo giờ Thái Bình Dương (UTC-7 hoặc UTC-8) vào ngày đầu tiên của tháng và năm được chỉ định.

ngày (phương diện chính)
Khi bạn sử dụng phương diện này, dữ liệu trong báo cáo sẽ được tổng hợp hằng ngày và mỗi hàng chứa dữ liệu trong một ngày. Bạn có thể sử dụng các phương diện khác để phân tích dữ liệu chi tiết hơn nữa. Ví dụ: báo cáo nguồn lưu lượng truy cập có thể tổng hợp số liệu thống kê về lượt xem hàng ngày dựa trên cách người dùng tiếp cận video của bạn. This is a core dimension and is subject to the Deprecation Policy.
tháng (phương diện chính)
Dữ liệu trong báo cáo được tổng hợp theo tháng. Giống như báo cáo hàng ngày, bạn có thể sử dụng các bộ lọc khác để phân đoạn dữ liệu sâu hơn nữa. Trong báo cáo, ngày được liệt kê ở định dạng YYYY-MM.

Lưu ý: Nếu truy vấn API của bạn sử dụng phương diện month, thì cả hai thông số start-date và end-date phải được đặt thành ngày đầu tiên của tháng. This is a core dimension and is subject to the Deprecation Policy.

Ví dụ

Các yêu cầu mẫu sau đây sử dụng phương diện hoặc bộ lọc tạm thời:

  • Ví dụ về kênh

    • Dựa trên thời gian
      • Chỉ số thời gian xem hằng ngày cho video trên một kênh
      • Số liệu chú thích hằng ngày cho video của một kênh
      • Số lượt xem danh sách phát hằng ngày của một kênh
    • Vị trí phát: Số lượt xem hằng ngày và thời gian xem ở nhiều vị trí phát
    • Nguồn lưu lượng truy cập: Số lượt xem hằng ngày và thời gian xem từ nhiều nguồn lưu lượng truy cập
    • Thiết bị/hệ điều hành
      • Chỉ số hằng ngày về loại thiết bị cho hệ điều hành Android
      • Các chỉ số hằng ngày về hệ điều hành trên thiết bị di động
      • Chỉ số về hệ điều hành và loại thiết bị hằng ngày

  • Ví dụ về chủ sở hữu nội dung

    • Dựa trên thời gian
      • Chỉ số thời gian xem hằng ngày đối với nội dung tự tải lên
      • Chỉ số về chú thích cho nội dung đã được xác nhận quyền sở hữu
      • Số lượt xem danh sách phát hằng ngày của một chủ sở hữu nội dung
    • Vị trí phát: Số lượt xem hằng ngày và thời gian xem ở nhiều vị trí phát
    • Nguồn lưu lượng truy cập: Số lượt xem hằng ngày và thời gian xem từ nhiều nguồn lưu lượng truy cập
    • Thiết bị/hệ điều hành
      • Chỉ số hằng ngày về loại thiết bị cho video đã được xác nhận quyền sở hữu
      • Chỉ số hệ điều hành hằng ngày cho video đã được xác nhận quyền sở hữu được xem trên thiết bị di động
      • Chỉ số về hệ điều hành và loại thiết bị hằng ngày
    • Doanh thu/Hiệu suất quảng cáo: Chỉ số doanh thu hằng ngày và hiệu suất quảng cáo

Vị trí phát

Các phương diện này cung cấp thông tin chi tiết về trang hoặc ứng dụng nơi hoạt động của người dùng xảy ra.

insightPlaybackLocationType
Dữ liệu trong báo cáo được tổng hợp dựa trên loại trang hoặc ứng dụng có lượt phát video. Phương diện này có thể chứa các giá trị sau:

  • BROWSE – Dữ liệu mô tả lượt xem diễn ra trên trang chủ YouTube hoặc màn hình chính, trên trang kênh đăng ký của người dùng hoặc trong một tính năng duyệt xem khác của YouTube.

  • CHANNEL – Dữ liệu mô tả lượt xem xảy ra trên trang kênh.

  • EMBEDDED – Dữ liệu mô tả lượt xem xảy ra trên một trang web hoặc ứng dụng khác, nơi video được nhúng bằng phương thức nhúng <iframe> hoặc <object>.

  • EXTERNAL_APP – Dữ liệu mô tả lượt xem xảy ra trong một ứng dụng của bên thứ ba, trong đó video được phát bằng một phương thức không phải là phương thức nhúng <iframe> hoặc <object>. Ví dụ: lượt phát trong ứng dụng sử dụng YouTube Android Player API sẽ được phân loại theo giá trị này.

  • MOBILE – Dữ liệu mô tả lượt xem xảy ra trên trang web dành cho thiết bị di động của YouTube hoặc trên các ứng dụng API YouTube được phê duyệt, bao gồm cả thiết bị di động.

    Kể từ ngày 10 tháng 9 năm 2013, số lượt phát không còn được phân loại là lượt phát MOBILE trong báo cáo YouTube Analytics. Giá trị này có thể vẫn còn trong báo cáo vì dữ liệu cũ vẫn thuộc danh mục đó. Tuy nhiên, sau ngày đó, số lượt phát trên thiết bị di động sẽ được phân loại là lượt phát WATCH, EMBEDDED hoặc EXTERNAL_APP, tuỳ thuộc vào loại ứng dụng có lượt phát đó.

  • SEARCH – Dữ liệu mô tả số lượt xem diễn ra ngay trên trang kết quả tìm kiếm trên YouTube.

  • WATCH – Dữ liệu mô tả lượt xem xảy ra trên trang xem YouTube của video hoặc trong ứng dụng YouTube chính thức, chẳng hạn như ứng dụng YouTube dành cho Android.

  • YT_OTHER – Dữ liệu mô tả các chế độ xem không được phân loại khác.

insightPlaybackLocationDetail
Dữ liệu được tổng hợp dựa trên trang chứa trình phát. Lưu ý rằng báo cáo này chỉ được hỗ trợ cho lượt xem xảy ra trong trình phát được nhúng và báo cáo này xác định các trình phát được nhúng tạo ra nhiều lượt xem nhất cho một video cụ thể. Do đó, báo cáo này cung cấp chế độ xem chi tiết hơn so với báo cáo vị trí phát nhờ xác định các URL hoặc ứng dụng được liên kết với các trình phát được nhúng hàng đầu.

Ví dụ

Các yêu cầu mẫu sau đây sử dụng phương diện vị trí phát:

  • Ví dụ về kênh

    • Vị trí phát
      • Số lượt xem và thời gian xem từ các vị trí phát khác nhau
      • Số lượt xem hằng ngày và thời gian xem ở các vị trí phát khác nhau
      • 10 hàng đầu – Các trang web của bên thứ ba tạo ra nhiều lượt xem nhất cho video được nhúng
      • Số lượt xem danh sách phát và thời gian xem ở các vị trí phát khác nhau
      • Số lượt xem danh sách phát hằng ngày và thời gian xem ở nhiều vị trí phát

  • Ví dụ về chủ sở hữu nội dung

    • Vị trí phát
      • Số lượt xem và thời gian xem từ các vị trí phát khác nhau
      • Số lượt xem hằng ngày và thời gian xem ở các vị trí phát khác nhau
      • 10 hàng đầu – Các trang web của bên thứ ba tạo ra nhiều lượt xem nhất cho video được nhúng
      • Số lượt xem danh sách phát và thời gian xem ở các vị trí phát khác nhau
      • Số lượt xem danh sách phát hằng ngày và thời gian xem ở nhiều vị trí phát

Thông tin chi tiết về quá trình phát

creatorContentType
Phương diện này xác định loại nội dung liên kết với chỉ số hoạt động của người dùng trong hàng dữ liệu. Bạn có thể xem dữ liệu cho phương diện này cho những ngày bắt đầu từ ngày 1 tháng 1 năm 2019.

Bảng sau liệt kê các giá trị phương diện:
Giá trị
LIVE_STREAM Nội dung được xem là một sự kiện phát trực tiếp trên YouTube.
SHORTS Nội dung được xem là một video ngắn trên YouTube.
STORY Nội dung được xem là một Câu chuyện trên YouTube.
VIDEO_ON_DEMAND Nội dung đã xem là video trên YouTube không thuộc một trong các giá trị phương diện khác.
UNSPECIFIED Loại nội dung của nội dung đã xem không xác định.
liveOrOnDemand
Phương diện này cho biết liệu chỉ số hoạt động của người dùng trong hàng dữ liệu có liên kết với lượt xem một chương trình phát sóng trực tiếp hay không. Dữ liệu cho phương diện này có sẵn cho những ngày bắt đầu từ ngày 1 tháng 4 năm 2014.

Bảng sau liệt kê các giá trị phương diện:
Giá trị
LIVE Dữ liệu của hàng mô tả hoạt động của người dùng đã xảy ra trong một chương trình phát sóng trực tiếp.
ON_DEMAND Dữ liệu của hàng này mô tả hoạt động của người dùng không xảy ra trong thời gian phát sóng trực tiếp.
subscribedStatus
Phương diện này cho biết liệu chỉ số hoạt động của người dùng trong hàng dữ liệu có liên quan đến những người xem đã đăng ký kênh của video hoặc danh sách phát hay không. Các giá trị có thể là SUBSCRIBED và UNSUBSCRIBED.

Xin lưu ý rằng giá trị phương diện là giá trị chính xác tại thời điểm diễn ra hoạt động của người dùng. Ví dụ: giả sử một người dùng chưa đăng ký một kênh và xem một trong các video của kênh đó, sau đó đăng ký kênh đó và xem một video khác, tất cả diễn ra trong cùng một ngày. Báo cáo của kênh cho biết rằng một lượt xem có giá trị subscribedStatus là SUBSCRIBED và một lượt xem có giá trị subscribedStatus là UNSUBSCRIBED.
youtubeProduct
Phương diện này xác định dịch vụ YouTube có hoạt động của người dùng diễn ra trên đó. Dữ liệu cho phương diện này có sẵn kể từ ngày 18 tháng 7 năm 2015.

Bảng sau liệt kê các giá trị phương diện:
Giá trị
CORE Hoạt động của người dùng không diễn ra ở một trong các ứng dụng chuyên biệt của YouTube (YouTube Gaming, YouTube Kids hoặc YouTube Music). Trường hợp ngoại lệ: Hoạt động của người dùng xảy ra trong YouTube Music trước ngày 1 tháng 3 năm 2021 được tính vào CORE.
GAMING Hoạt động của người dùng xảy ra trong YouTube Gaming.
KIDS Hoạt động của người dùng xảy ra trong YouTube Kids.
MUSIC Hoạt động của người dùng xảy ra trong YouTube Music từ ngày 1 tháng 3 năm 2021. Dữ liệu trước ngày 1 tháng 3 năm 2021 được đưa vào CORE. Hệ thống không ghi lại dữ liệu theo thời gian thực.
UNKNOWN Hoạt động của người dùng xảy ra trước ngày 18 tháng 7 năm 2015.

Nguồn lưu lượng truy cập

insightTrafficSourceType
Dữ liệu trong báo cáo được tổng hợp dựa trên loại đường liên kết giới thiệu, mô tả cách người dùng truy cập vào video. Phương diện này có thể có các giá trị sau:
  • ADVERTISING – Người xem được quảng cáo giới thiệu đến video. Nếu bạn lọc dựa trên nguồn lưu lượng truy cập này, thì trường insightTrafficSourceDetail sẽ xác định loại quảng cáo.
  • ANNOTATION – Người xem đã truy cập vào video bằng cách nhấp vào chú thích trong một video khác.
  • CAMPAIGN_CARD – Số lượt xem bắt nguồn từ các video do người dùng tải lên do người dùng xác nhận quyền sở hữu mà chủ sở hữu nội dung dùng để quảng bá nội dung đã được xem. Nguồn lưu lượng truy cập này chỉ được hỗ trợ cho các báo cáo của chủ sở hữu nội dung.
  • END_SCREEN – Các lượt xem được chuyển đến từ màn hình kết thúc của một video khác.
  • EXT_URL – Lượt xem video được giới thiệu từ liên kết trên một trang web khác. Nếu bạn lọc dựa trên nguồn lưu lượng truy cập này, thì trường insightTrafficSourceDetail sẽ xác định trang web. Nguồn lưu lượng truy cập này bao gồm giới thiệu từ kết quả tìm kiếm của Google.
  • HASHTAGS – Lượt xem bắt nguồn từ các trang hashtag theo yêu cầu hoặc các trang tổng hợp hashtag trên Shorts.
  • LIVE_REDIRECT – Lượt xem video được giới thiệu từ tính năng Live Redirect.
  • NO_LINK_EMBEDDED – Video đã được nhúng trên một trang web khác khi có người xem.
  • NO_LINK_OTHER – YouTube không xác định được đường liên kết giới thiệu nào cho lưu lượng truy cập. Danh mục này bao gồm lưu lượng truy cập trực tiếp vào video cũng như lưu lượng truy cập trên ứng dụng di động.
  • NOTIFICATION – Số lượt xem video được giới thiệu từ email hoặc thông báo của YouTube.
  • PLAYLIST – Lượt xem video xảy ra khi video đang được phát như một phần của danh sách phát. Số liệu này bao gồm cả lưu lượng truy cập bắt nguồn từ trang danh sách phát.
  • PRODUCT_PAGE – Lượt xem video được dẫn đến từ trang Sản phẩm.
  • PROMOTED – Số lượt xem video được giới thiệu từ quảng cáo không phải trả tiền của YouTube, chẳng hạn như trang "Video nổi bật" trên YouTube.
  • RELATED_VIDEO – Lượt xem video được giới thiệu từ danh sách video có liên quan trên một trang xem video khác. Nếu bạn lọc theo nguồn lưu lượng truy cập này, thì trường insightTrafficSourceDetail sẽ chỉ định mã video của video đó.
  • SHORTS – Người xem được giới thiệu bằng cách vuốt dọc màn hình của video trước trong trang xem video ngắn.
  • SOUND_PAGE – Lượt xem bắt nguồn từ các trang tổng hợp âm thanh trên Shorts.
  • SUBSCRIBER – Lượt xem video được giới thiệu từ các nguồn cấp dữ liệu trên trang chủ YouTube hoặc từ các tính năng đăng ký của YouTube. Nếu bạn lọc theo nguồn lưu lượng truy cập này, thì trường insightTrafficSourceDetail sẽ chỉ định các mục trong nguồn cấp dữ liệu trang chủ hoặc trang khác mà từ đó các lượt xem được giới thiệu.
  • YT_CHANNEL – Lượt xem video xảy ra trên trang kênh. Nếu bạn lọc theo nguồn lưu lượng truy cập này, thì trường insightTrafficSourceDetail sẽ chỉ định mã nhận dạng kênh của kênh đó.
  • YT_OTHER_PAGE – Lượt xem video được giới thiệu từ một liên kết không phải là kết quả tìm kiếm hoặc liên kết video có liên quan xuất hiện trên một trang YouTube. Nếu bạn lọc dựa trên nguồn lưu lượng truy cập này, thì trường insightTrafficSourceDetail sẽ xác định trang.
  • YT_SEARCH – Lượt xem video được giới thiệu từ kết quả tìm kiếm trên YouTube. Nếu bạn lọc dựa trên nguồn lưu lượng truy cập này, thì trường insightTrafficSourceDetail sẽ chỉ định cụm từ tìm kiếm.
  • VIDEO_REMIXES – Lượt xem video được lấy từ đường liên kết đến video phối lại trong trình phát Shorts. Nếu bạn lọc theo nguồn lưu lượng truy cập này, thì trường insightTrafficSourceDetail sẽ chỉ định video mà người xem được giới thiệu.
insightTrafficSourceDetail
Dữ liệu trong báo cáo được tổng hợp dựa trên các đường liên kết giới thiệu đã tạo ra nhiều lượt xem nhất cho một video cụ thể và một loại nguồn lưu lượng truy cập cụ thể. Danh sách sau đây xác định nguồn lưu lượng truy cập có sẵn báo cáo này. Đối với mỗi nguồn lưu lượng truy cập, danh sách này sẽ xác định thông tin mà phương diện insightTrafficSourceDetail cung cấp.
  • ADVERTISING – Loại quảng cáo đã dẫn đến các lượt xem. Các giá trị có thể sử dụng là:
    • Quảng cáo tương tác nhấp để phát
    • Quảng cáo tương tác
    • Quảng cáo đi kèm kết quả tìm kiếm của Google
    • Quảng cáo video trên trang chủ
    • Quảng cáo trong luồng có thể bỏ qua dành riêng
    • TrueView trong tìm kiếm và trong hiển thị
    • Quảng cáo TrueView trong luồng
    • Quảng cáo YouTube chưa được phân loại
    • Hộp hiển thị video
  • CAMPAIGN_CARD – Video đã được xác nhận quyền sở hữu đã đưa người xem đến video được xác định trong báo cáo.
  • END_SCREEN – Video đưa người xem đến video được xác định trong báo cáo.
  • EXT_URL – Trang web giới thiệu người xem đến video.
  • HASHTAGS – Hashtag đã dẫn đến lượt xem.
  • NOTIFICATION – Email hoặc thông báo đã giới thiệu lưu lượng truy cập đến.
  • RELATED_VIDEO – Video có liên quan đã đưa người xem đến video được đề cập trong báo cáo.
  • SOUND_PAGE – Video đã mang đến lượt xem.
  • SUBSCRIBER – Mục trong nguồn cấp dữ liệu trên trang chủ hoặc tính năng đăng ký trên YouTube giúp người xem tìm thấy video được đề cập trong báo cáo. Có các giá trị hợp lệ như sau:
    • activity – Lượt xem từ các mục trong trang kênh đăng ký trên trang chủ bắt nguồn từ hoạt động kênh không tải lên và không phải mạng xã hội, bao gồm cả lượt thích, mục yêu thích, bài đăng bản tin và lượt thêm vào danh sách phát.
    • blogged – Lượt xem từ các mục trong nguồn cấp dữ liệu đăng ký trang chủ bắt nguồn từ các đường liên kết từ các blog hàng đầu.
    • mychannel – Số lượt xem từ các mục trong những nguồn cấp dữ liệu khác được liệt kê trên trang chủ, chẳng hạn như "Lượt thích", "Danh sách video đã xem" và "Xem sau".
    • podcasts – Số lượt xem bắt nguồn từ các mục trên trang đích của Podcast.
    • sdig – Lượt xem bắt nguồn từ email cập nhật gói đăng ký.
    • uploaded – Lượt xem từ các mục uploaded trong nguồn cấp dữ liệu đăng ký trang chủ.
    • / – Các lượt xem khác bắt nguồn từ trang chủ YouTube.
    • /my_subscriptions – Lượt xem bắt nguồn từ các trang Đăng ký của tôi của người dùng trên YouTube.
  • YT_CHANNEL – Trang kênh nơi khán giả xem video.
  • YT_OTHER_PAGE – Trang YouTube nơi người xem được giới thiệu đến video.
  • YT_SEARCH – Cụm từ tìm kiếm đưa người xem đến video.
  • VIDEO_REMIXES – Video đã mang đến lượt xem.

Ví dụ

Các yêu cầu mẫu sau đây sử dụng phương diện nguồn lưu lượng truy cập:

  • Ví dụ về kênh

    • Nguồn lưu lượng truy cập
      • Số lượt xem và thời gian xem từ các nguồn lưu lượng truy cập khác nhau trong một quốc gia
      • Số lượt xem hằng ngày và thời gian xem từ các nguồn lưu lượng truy cập khác nhau
      • 10 cụm từ hàng đầu – Cụm từ tìm kiếm trên YouTube tạo ra nhiều lưu lượng truy cập nhất cho một video
      • 10 cụm từ tìm kiếm hàng đầu – Các cụm từ tìm kiếm trên Google tạo ra nhiều lưu lượng truy cập nhất cho một video
      • Số lượt xem danh sách phát và thời gian xem từ nhiều nguồn lưu lượng truy cập trong một quốc gia
      • Số lượt xem danh sách phát hằng ngày và thời gian xem từ nhiều nguồn lưu lượng truy cập

  • Ví dụ về chủ sở hữu nội dung

    • Nguồn lưu lượng truy cập
      • Số lượt xem và thời gian xem từ các nguồn lưu lượng truy cập khác nhau
      • Số lượt xem hằng ngày và thời gian xem từ các nguồn lưu lượng truy cập khác nhau
      • 10 cụm từ hàng đầu – Cụm từ tìm kiếm trên YouTube tạo ra nhiều lưu lượng truy cập nhất cho một video
      • 10 cụm từ tìm kiếm hàng đầu – Các cụm từ tìm kiếm trên Google tạo ra nhiều lưu lượng truy cập nhất cho một video
      • Số lượt xem danh sách phát và thời gian xem từ nhiều nguồn lưu lượng truy cập trong một quốc gia
      • Số lượt xem danh sách phát hằng ngày và thời gian xem từ nhiều nguồn lưu lượng truy cập

Thiết bị

deviceType
Phương diện này xác định kiểu dáng vật lý của thiết bị mang đến lượt xem. Danh sách sau đây xác định các loại thiết bị mà API trả về dữ liệu. Bạn cũng có thể dùng phương diện deviceType làm bộ lọc để hạn chế rằng một báo cáo của hệ điều hành chỉ chứa dữ liệu cho một loại thiết bị cụ thể.
  • DESKTOP
  • GAME_CONSOLE
  • MOBILE
  • TABLET
  • TV
  • UNKNOWN_PLATFORM
operatingSystem
Phương diện này xác định hệ thống phần mềm của thiết bị có lượt xem xảy ra. Danh sách sau đây xác định các hệ điều hành mà API trả về dữ liệu. Bạn cũng có thể dùng operatingSystem làm bộ lọc để hạn chế sao cho báo cáo loại thiết bị chỉ chứa dữ liệu cho một hệ điều hành cụ thể.
  • ANDROID
  • BADA
  • BLACKBERRY
  • CHROMECAST
  • DOCOMO
  • FIREFOX
  • HIPTOP
  • IOS
  • KAIOS
  • LINUX
  • MACINTOSH
  • MEEGO
  • NINTENDO_3DS
  • OTHER
  • PLAYSTATION
  • PLAYSTATION_VITA
  • REALMEDIA
  • SMART_TV
  • SYMBIAN
  • TIZEN
  • VIDAA
  • WEBOS
  • WII
  • WINDOWS
  • WINDOWS_MOBILE
  • XBOX

Ví dụ

Các yêu cầu mẫu sau đây sử dụng phương diện thiết bị:

  • Ví dụ về kênh

    • Thiết bị/hệ điều hành
      • Chỉ số hằng ngày về loại thiết bị cho hệ điều hành Android
      • Các chỉ số hằng ngày về hệ điều hành trên thiết bị di động
      • Chỉ số về hệ điều hành và loại thiết bị hằng ngày
      • Chỉ số hằng ngày về loại thiết bị cho lượt xem danh sách phát trên hệ điều hành Android
      • Chỉ số hệ điều hành hằng ngày cho lượt xem danh sách phát trên thiết bị di động

  • Ví dụ về chủ sở hữu nội dung

    • Thiết bị/hệ điều hành
      • Chỉ số hằng ngày về loại thiết bị cho video đã được xác nhận quyền sở hữu
      • Chỉ số hệ điều hành hằng ngày cho video đã được xác nhận quyền sở hữu được xem trên thiết bị di động
      • Chỉ số về hệ điều hành và loại thiết bị hằng ngày
      • Chỉ số hằng ngày về loại thiết bị cho lượt xem danh sách phát trên hệ điều hành Android
      • Chỉ số hệ điều hành hằng ngày cho lượt xem danh sách phát trên thiết bị di động

Thông tin nhân khẩu học

Phương diện nhân khẩu học giúp bạn hiểu rõ sự phân bổ về độ tuổi và giới tính của người xem. Trung tâm trợ giúp của YouTube chứa thêm thông tin về dữ liệu nhân khẩu học trong các báo cáo YouTube Analytics.

ageGroup (phương diện chính)
Phương diện này xác định nhóm tuổi của người dùng đã đăng nhập được liên kết với dữ liệu báo cáo. API này sử dụng các nhóm tuổi sau:
  • age13-17
  • age18-24
  • age25-34
  • age35-44
  • age45-54
  • age55-64
  • age65-
This is a core dimension and is subject to the Deprecation Policy.
giới tính (phương diện cốt lõi)
Phương diện này xác định giới tính của người dùng đã đăng nhập liên kết với dữ liệu báo cáo. Các giá trị hợp lệ là female, male và user_specified. This is a core dimension and is subject to the Deprecation Policy.

Ví dụ

Các yêu cầu mẫu sau đây sử dụng phương diện nhân khẩu học:

  • Ví dụ về kênh

    • Thông tin nhân khẩu học
      • Thông tin nhân khẩu học của người xem ở California (nhóm tuổi và giới tính)
      • Thông tin nhân khẩu học của người xem danh sách phát ở California (nhóm tuổi và giới tính)

  • Ví dụ về chủ sở hữu nội dung

    • Thông tin nhân khẩu học
      • Thông tin nhân khẩu học của người xem ở California (nhóm tuổi và giới tính)
      • Thông tin nhân khẩu học của người xem danh sách phát ở California (nhóm tuổi và giới tính)

Hoạt động tương tác và chia sẻ nội dung

sharingService (phương diện cốt lõi)
Phương diện này xác định dịch vụ bạn đã dùng để chia sẻ video. Bạn có thể chia sẻ video trên YouTube (hoặc qua trình phát YouTube) bằng nút "Chia sẻ". This is a core dimension and is subject to the Deprecation Policy.

Bảng sau đây liệt kê các giá trị phương diện hợp lệ:
Dịch vụ chia sẻ Giá trị API
Ameba AMEBA
Email Android ANDROID_EMAIL
Messenger trên Android ANDROID_MESSENGER
Nhắn tin trên Android ANDROID_MMS
Messenger trên Blackberry BBM
Blogger BLOGGER
Sao chép vào bảng nhớ tạm COPY_PASTE
Thế giới khổng lồ CYWORLD
Cắm xuống đất DIGG
Dropbox DROPBOX
Nhúng EMBED
Email MAIL
Facebook FACEBOOK
Facebook Messenger FACEBOOK_MESSENGER
Trang Facebook FACEBOOK_PAGES
Tiếng Fotka FOTKA
Gmail GMAIL
goo GOO
Google+ GOOGLEPLUS
Dùng SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
Tin nhắn văn bản của HTC HTC_MMS
Hộp thư đến của Google INBOX
Hộp thoại hoạt động hệ thống iOS IOS_SYSTEM_ACTIVITY_DIALOG
Câu chuyện của KakaO KAKAO_STORY
Tiếng Kakao (Kakao Talk) KAKAO
Tiếng Kik KIK
Email LGE LGE_EMAIL
Line LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
hoa cúc menéame MENEAME
mixi MIXI
Nhắn tin cho Motorola MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
Chia sẻ lân cận NEARBY_SHARE
NUjij NUJIJ
Tiếng Odnoklassniki (hãy дноклассники) ODNOKLASSNIKI
Khác OTHER
Pinterest PINTEREST
Rakuten (楽天與場) RAKUTEN
Reddit REDDIT
Skype SKYPE
Xanh đá SKYBLOG
Cuộc trò chuyện của Sony SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
Tin nhắn văn bản TEXT_MESSAGE
Lễ hội Tuenti TUENTI
tumblr. TUMBLR
Twitter TWITTER
Không xác định UNKNOWN
Tin nhắn của Verizon VERIZON_MMS
Viber VIBER
VKontakte (thay Контакте) VKONTAKTE
WeChat WECHAT
Weibo WEIBO
WhatsApp WHATS_APP
Wykop WYKOP
Người bán trên Yahoo! Nhật Bản YAHOO
YouTube Gaming YOUTUBE_GAMING
YouTube Kids YOUTUBE_KIDS
YouTube Music YOUTUBE_MUSIC
YouTube TV YOUTUBE_TV

Hãy xem tài liệu trợ giúp để biết thêm thông tin.

Ví dụ

Các yêu cầu mẫu sau đây sử dụng phương diện xã hội:

  • Ví dụ về kênh

    • Mạng xã hội: Chỉ số về lượt chia sẻ, tổng hợp theo dịch vụ nơi video được chia sẻ

  • Ví dụ về chủ sở hữu nội dung

    • Mạng xã hội: Chỉ số về lượt chia sẻ, tổng hợp theo dịch vụ nơi video được chia sẻ

Tỷ lệ giữ chân người xem

elapsedVideoTimeRatio
Kích thước này chỉ định tỷ lệ giữa phần đã trôi qua của video so với thời lượng của video. Các phương diện và chỉ số về tỷ lệ giữ chân người dùng được dùng để đo lường tỷ lệ giữ chân người xem theo thời gian, trong đó phương diện elapsedVideoTimeRatio là thước đo thời gian. Ví dụ: giá trị 0.4 cho biết dữ liệu báo cáo tương ứng hiển thị dữ liệu về tỷ lệ giữ chân người dùng sau khi 40% thời lượng video đã trôi qua.

API sẽ trả về 100 điểm dữ liệu cho mỗi video với các giá trị tỷ lệ trong khoảng từ 0.01 đến 1.0. Những thời điểm dữ liệu được đo lường trong quá trình phát video có cách đều nhau cho mỗi video. Điều này có nghĩa là đối với video dài 2 phút, khoảng thời gian giữa các điểm dữ liệu là 1,2 giây. Tuy nhiên, đối với video dài 2 giờ, khoảng thời gian giữa các điểm dữ liệu là 72 giây. Giá trị của phương diện biểu thị điểm kết thúc không bao gồm của khoảng thời gian này.
audienceType (chỉ áp dụng cho bộ lọc)
Giá trị phương diện xác định loại lưu lượng truy cập liên kết với dữ liệu báo cáo. Các giá trị được hỗ trợ: ORGANIC, AD_INSTREAM và AD_INDISPLAY. Hãy truy cập vào Trung tâm trợ giúp của YouTube để xem thông tin giải thích về các loại nguồn lưu lượng truy cập này.

Xin lưu ý rằng dữ liệu cho bộ lọc audienceType có từ ngày 25 tháng 9 năm 2013. API không trả về dữ liệu cho những truy vấn sử dụng bộ lọc để cố gắng truy xuất dữ liệu từ các ngày trước đó. Các truy vấn không sử dụng bộ lọc sẽ hoạt động cho bất kỳ ngày nào sau ngày 1 tháng 7 năm 2008.

Ví dụ

Các yêu cầu mẫu sau đây sử dụng phương diện tỷ lệ giữ chân người xem:

Hiệu suất quảng cáo

adType
Phương diện adType được dùng trong báo cáo hiệu suất quảng cáo và tổng hợp các chỉ số theo yêu cầu dựa trên các loại quảng cáo chạy trong các lượt phát video. Danh sách sau đây giải thích các giá trị phương diện có thể có. Hãy truy cập vào Trung tâm trợ giúp của YouTube để biết thêm thông tin về các định dạng quảng cáo trên YouTube.

  • auctionBumperInstream – Quảng cáo dạng video không thể bỏ qua, được đặt thông qua phiên đấu giá, có thời lượng tối đa 6 giây mà khán giả phải xem hết thì mới có thể xem video.

  • auctionDisplay – Quảng cáo đa phương tiện hoặc quảng cáo hình ảnh xuất hiện dưới dạng lớp phủ ở cuối trình phát video, dưới dạng đơn vị quảng cáo 300x250 trên trang xem video hoặc kết hợp cả hai. Khi chạy, lớp phủ sẽ tự động đóng sau khi hiển thị trong một khoảng thời gian nhất định và người dùng cũng có thể đóng lớp phủ đó. Nếu lớp phủ và biểu ngữ hiển thị cùng nhau, thì mỗi quảng cáo được tính là một lượt hiển thị riêng biệt.

  • auctionInstream – Quảng cáo dạng video không thể bỏ qua chạy trước, trong hoặc sau video chính.

  • auctionTrueviewInslate – Người xem chọn một trong nhiều quảng cáo dạng video trong một loạt các lựa chọn hiển thị trước video. See the TrueView documentation for more information.

  • auctionTrueviewInstream – Quảng cáo dạng video có thể bỏ qua chạy trước hoặc trong video chính. Xem tài liệu TrueView để biết thêm thông tin.

  • auctionUnknown – Quảng cáo được mua thông qua phiên đấu giá của AdWords nhưng chưa được phân loại vào một trong các loại quảng cáo khác.

  • reservedBumperInstream – Quảng cáo dạng video không thể bỏ qua, được bán theo hình thức đặt trước, có thời lượng tối đa 6 giây mà khán giả phải xem hết thì mới có thể xem video.

  • reservedClickToPlay – Quảng cáo video mà người dùng phải nhấp vào để bắt đầu phát lại. Một lượt hiển thị quảng cáo được ghi lại bất cứ khi nào đơn vị quảng cáo nhấp để phát hiển thị, bất kể người dùng có bắt đầu phát hay không. Những video này được bán theo hình thức đặt trước.

  • reservedDisplay – Quảng cáo đa phương tiện hoặc quảng cáo hình ảnh xuất hiện dưới dạng lớp phủ ở cuối trình phát video, dưới dạng đơn vị quảng cáo 300x250 trên trang xem video hoặc kết hợp cả hai. Khi chạy, lớp phủ sẽ tự động đóng sau khi hiển thị trong một khoảng thời gian nhất định và người dùng cũng có thể đóng lớp phủ đó. Nếu lớp phủ và biểu ngữ hiển thị cùng nhau, thì mỗi quảng cáo được tính là một lượt hiển thị riêng biệt.

  • reservedInstream – Quảng cáo dạng video không thể bỏ qua được chèn trước, trong hoặc sau video chính.

  • reservedInstreamSelect

  • reservedMasthead – Một quảng cáo lớn, có thể bao gồm các yếu tố video và đồ hoạ, xuất hiện trên trang chủ.

  • reservedUnknown – Quảng cáo được bán trên cơ sở đặt trước không thể phân loại vào một trong các loại quảng cáo khác.

  • unknown – Chúng tôi không thể phân loại loại quảng cáo này.

Ví dụ

Các báo cáo mẫu sau đây truy xuất chỉ số hiệu suất quảng cáo hoặc doanh thu:

  • Ví dụ về kênh

    • Doanh thu/Quảng cáo
      • Chỉ số doanh thu của kênh và hiệu suất quảng cáo
      • Chỉ số doanh thu hằng ngày và hiệu suất quảng cáo
      • Chỉ số doanh thu và hiệu suất quảng cáo theo quốc gia
      • 10 video hàng đầu – Video có doanh thu cao nhất
      • Chỉ số hiệu suất quảng cáo cho các loại quảng cáo

  • Ví dụ về chủ sở hữu nội dung

    • Doanh thu/Quảng cáo
      • Chỉ số về doanh thu và hiệu suất quảng cáo cho nội dung đã được xác nhận quyền sở hữu
      • Chỉ số doanh thu hằng ngày và hiệu suất quảng cáo
      • Chỉ số doanh thu và hiệu suất quảng cáo theo quốc gia
      • 10 video hàng đầu – Video có doanh thu cao nhất
      • Chỉ số hiệu suất quảng cáo cho các loại quảng cáo

Danh sách phát

isCurated (chỉ áp dụng cho bộ lọc)
Bộ lọc này cho biết yêu cầu đang truy xuất dữ liệu về lượt xem video xảy ra trong bối cảnh của một danh sách phát.

Ví dụ

Tất cả các yêu cầu mẫu truy xuất báo cáo danh sách phát đều sử dụng bộ lọc isCurated.

Phương diện của chủ sở hữu nội dung

Các phương diện sau chỉ được hỗ trợ cho báo cáo của chủ sở hữu nội dung.

Lưu ý quan trọng: Các yêu cầu API để truy xuất báo cáo của chủ sở hữu nội dung phải lọc dữ liệu bằng một trong các phương diện sau:
  • video
  • channel
  • Tổ hợp các phương diện claimedStatus và uploaderType được hỗ trợ như được xác định bên dưới.
claimStatus (chỉ được sử dụng trong báo cáo của chủ sở hữu nội dung)
Phương diện này cho phép bạn chỉ định rằng một phản hồi của API chỉ được chứa các chỉ số cho nội dung đã được xác nhận quyền sở hữu. Giá trị hợp lệ duy nhất cho phương diện này là claimed. Nếu tham số filters giới hạn truy vấn ở mức claimedStatus==claimed, thì API sẽ chỉ truy xuất dữ liệu cho nội dung đã được xác nhận quyền sở hữu. Bảng trong phần định nghĩa phương diện uploaderType cung cấp thêm thông tin chi tiết về cách sử dụng phương diện này.
chất lượng tải lên (phương diện cốt lõi) (chỉ được dùng trong báo cáo của chủ sở hữu nội dung)
Phương diện này cho phép bạn cho biết liệu phản hồi của API có chứa chỉ số về nội dung do chủ sở hữu nội dung chỉ định và/hoặc nội dung do bên thứ ba tải lên hay không, chẳng hạn như video do người dùng tải lên. Các giá trị hợp lệ là self và thirdParty. Đây là phương diện chính và tuân theo Chính sách về việc ngừng sử dụng.

Bảng dưới đây cho thấy các cách kết hợp được hỗ trợ cho phương diện claimedStatus và uploaderType, cả hai đều dùng trong tham số filters:

Giá trị claimedStatus Giá trị uploaderType Nội dung mô tả
[Chưa đặt] bản thân Truy xuất dữ liệu YouTube Analytics cho nội dung được xác nhận quyền sở hữu và chưa được xác nhận quyền sở hữu do chủ sở hữu nội dung tải lên.
đã xác nhận quyền sở hữu [Chưa đặt] Truy xuất dữ liệu cho nội dung được xác nhận quyền sở hữu do chủ sở hữu nội dung hoặc bên thứ ba tải lên.
đã xác nhận quyền sở hữu bản thân Truy xuất dữ liệu cho nội dung đã được xác nhận quyền sở hữu do chủ sở hữu nội dung tải lên.
đã xác nhận quyền sở hữu thirdParty Truy xuất dữ liệu cho nội dung đã được xác nhận quyền sở hữu do bên thứ ba tải lên.

Ví dụ

Nhiều yêu cầu API mẫu cho báo cáo của chủ sở hữu nội dung sử dụng tổ hợp được hỗ trợ của các phương diện claimedStatus và uploaderType để lọc dữ liệu.