Trang này trình bày các yêu cầu mẫu của API YouTube Analytics. Mỗi ví dụ mô tả ngắn gọn báo cáo đang được truy xuất, sau đó hiển thị các giá trị tham số dimensions, metrics, filters và sort tương ứng. (Tài liệu về báo cáo kênh và báo cáo chủ sở hữu nội dung sẽ cho biết những báo cáo mà API hỗ trợ.)
Mỗi ví dụ sẽ liên kết đến và điền các giá trị hiển thị vào Google API Explorer. Các ví dụ cũng sử dụng ngày bắt đầu và ngày kết thúc mặc định (YYYY-MM-DD) là 2023-09-01 và 2024-03-31.
Sau khi liên kết với Trình khám phá API, bạn vẫn phải chỉ định kênh hoặc chủ sở hữu nội dung mà bạn đang truy xuất báo cáo. APIs Explorer sẽ điền channel==MINE hoặc contentOwner==CONTENT_OWNER_ID vào giá trị tham số ids, tuỳ thuộc vào truy vấn mà bạn đã nhấp vào. Đối với báo cáo kênh, bạn có thể thay đổi MINE thành mã nhận dạng kênh của người dùng đã xác thực. Đối với báo cáo của chủ sở hữu nội dung, bạn cần thay thế CONTENT_OWNER_ID bằng mã nhận dạng chủ sở hữu nội dung của mình.
Bạn cũng phải được xác thực là chủ sở hữu kênh hoặc nội dung được chỉ định để Trình khám phá API có thể uỷ quyền cho các yêu cầu API của bạn bằng OAuth 2.0.
Sắp xếp yêu cầu theo nhiều phương diện/chỉ số
API này hỗ trợ khả năng sắp xếp dữ liệu phản hồi bằng cách sử dụng nhiều phương diện hoặc chỉ số. Ví dụ: yêu cầu bên dưới truy xuất dữ liệu nguồn lưu lượng truy cập hằng ngày cho các video của một kênh cụ thể. Mỗi hàng trong tập kết quả xác định số lượt xem và thời gian xem ước tính bắt nguồn từ một loại nguồn lưu lượng truy cập cụ thể (ví dụ: EXT_URL) vào một ngày cụ thể.
dimensions=day,insightTrafficSourceType
metrics=views,estimatedWatchTime
sort=day,-viewsTrong câu trả lời, các kết quả được sắp xếp theo trình tự thời gian. Trong tập hợp kết quả cho mỗi ngày, kết quả được sắp xếp theo thứ tự giảm dần theo số lượt xem. Do đó, hàng đầu tiên trong tập kết quả chứa dữ liệu về nguồn lưu lượng truy cập đã tạo ra nhiều lượt xem nhất vào ngày đầu tiên trong phạm vi ngày được yêu cầu. Hàng thứ hai chứa dữ liệu về nguồn lưu lượng truy cập đã tạo ra số lượt xem cao thứ hai vào ngày đầu tiên.
Báo cáo kênh
Báo cáo video
Tổng số lượt xem, thời gian xem ước tính và nhiều thông tin khác về một kênh
Truy vấn này truy xuất các chỉ số tổng hợp cho nội dung của kênh. Báo cáo này trả về một hàng dữ liệu chứa tổng số cho từng chỉ số được yêu cầu trong phạm vi ngày đã chỉ định.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDurationSố lượt xem theo quốc gia (và các thông tin khác) của một kênh
Truy vấn này truy xuất các chỉ số của một quốc gia cụ thể cho các video của một kênh. Báo cáo này trả về một hàng dữ liệu chứa tổng số cho từng chỉ số được yêu cầu trong phạm vi ngày đã chỉ định.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=country==USTop 10 – Những video được xem nhiều nhất của một kênh
Truy vấn này truy xuất 10 video được xem nhiều nhất của kênh, được đo bằng số phút đã xem ước tính trong phạm vi ngày được chỉ định. Kết quả được sắp xếp theo số phút đã xem ước tính theo thứ tự giảm dần.
Lưu ý: Báo cáo này yêu cầu bạn chỉ định giá trị cho tham số yêu cầu sort và đặt tham số maxResults thành giá trị số nguyên từ 10 trở xuống.
dimensions=video
metrics=estimatedMinutesWatched,views,likes,subscribersGained
maxResults=10
sort=-estimatedMinutesWatchedTop 10 – Tỷ lệ nhấp vào chú thích của những video được xem nhiều nhất trên kênh
Yêu cầu này truy xuất số lượt xem, tỷ lệ nhấp vào chú thích, tỷ lệ đóng chú thích và số lượt hiển thị chú thích của 10 video được xem nhiều nhất trên kênh. Kết quả được sắp xếp theo số lượt xem theo thứ tự giảm dần, tức là video được xem nhiều nhất sẽ xuất hiện trước tiên.
Lưu ý: Báo cáo này yêu cầu bạn chỉ định một giá trị cho tham số yêu cầu sort và đặt tham số maxResults thành giá trị số nguyên từ 10 trở xuống.
dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
maxResults=10
sort=-viewsBáo cáo danh sách phát
Tổng số lượt xem danh sách phát của một kênh
Yêu cầu này truy xuất tổng số lần bắt đầu danh sách phát, số phút xem ước tính, số lượt xem (chỉ số video tổng hợp), số lượt xem danh sách phát (chỉ số trong danh sách phát) và số lượt xem trên mỗi lần bắt đầu danh sách phát cho các danh sách phát trong kênh của người dùng đã xác thực.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStartSố liệu thống kê cho một danh sách phát cụ thể
Yêu cầu này truy xuất tổng số lượt bắt đầu của danh sách phát, số phút đã xem ước tính, số lượt xem (chỉ số video tổng hợp), số lượt xem danh sách phát (chỉ số trong danh sách phát) và số lượt xem trên mỗi lần bắt đầu của danh sách phát của một danh sách phát cụ thể. Xin lưu ý rằng để chạy truy vấn này trong Trình khám phá API, bạn phải thay thế chuỗi PLAYLIST_ID trong giá trị tham số filters bằng mã danh sách phát của một danh sách phát trong kênh của người dùng đã xác thực.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
filters=playlist==PLAYLIST_IDĐể truy xuất số liệu thống kê tổng hợp cho nhiều danh sách phát, bạn cũng có thể thay thế chuỗi PLAYLIST_ID bằng danh sách được phân tách bằng dấu phẩy gồm tối đa 500 mã danh sách phát cho các danh sách phát trong kênh của người dùng đã xác thực.
Top 10 – Danh sách phát được xem nhiều nhất của một kênh
Truy vấn này truy xuất 10 danh sách phát được xem nhiều nhất của một kênh, được tính theo số lượt xem danh sách phát trong phạm vi ngày đã chỉ định. API này cũng truy xuất một số chỉ số khác về danh sách phát, chẳng hạn như số lần người xem bắt đầu phát mỗi danh sách phát và thời lượng trung bình mà người xem xem video trong danh sách phát sau khi bắt đầu phát. Kết quả được sắp xếp theo số lượt xem danh sách phát theo thứ tự giảm dần.
Lưu ý: Vì báo cáo này sử dụng phương diện playlist, nên bạn phải chỉ định giá trị cho tham số yêu cầu sort và cũng đặt tham số maxResults thành giá trị số nguyên từ 10 trở xuống.
dimensions=playlist
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist,playlistSaves
maxResults=10
sort=-playlistViewsBáo cáo video
Chỉ số về thời gian xem hằng ngày của các video trên một kênh
Truy vấn này truy xuất số lượt xem hằng ngày, chỉ số thời gian xem và số người đăng ký mới cho các video của một kênh. Báo cáo này trả về một hàng dữ liệu cho mỗi ngày trong phạm vi ngày được yêu cầu. Các hàng được sắp xếp theo thứ tự thời gian.
dimensions=day
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=dayChỉ số hằng ngày về chú thích cho video của một kênh
Yêu cầu này truy xuất số lượt xem hằng ngày, tỷ lệ nhấp vào chú thích, tỷ lệ đóng chú thích và số lượt hiển thị chú thích cho nội dung của kênh. Kết quả được sắp xếp theo thứ tự thời gian.
dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=dayBáo cáo danh sách phát
Lượt xem danh sách phát hằng ngày của một kênh
Yêu cầu này truy xuất số lượt xem hằng ngày (một chỉ số video tổng hợp), số lượt xem danh sách phát (chỉ số trong danh sách phát), số lượt bắt đầu của danh sách phát, số phút đã xem ước tính và số lượt xem trên mỗi lần bắt đầu của danh sách phát đối với kênh của người dùng đã xác thực. Kết quả được sắp xếp theo thứ tự thời gian.
dimensions=day
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
sort=dayBáo cáo video
Chỉ số thời gian xem video của một kênh theo quốc gia cụ thể
Truy vấn này truy xuất số lượt xem, chỉ số thời gian xem và số người đăng ký theo quốc gia cho các video của một kênh. Báo cáo này trả về một hàng dữ liệu cho mỗi quốc gia nơi người dùng xem video của kênh. Các hàng được sắp xếp theo thứ tự giảm dần số phút đã xem.
dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=-estimatedMinutesWatchedChỉ số chú thích theo quốc gia cụ thể cho video của kênh
Yêu cầu này truy xuất số lượt xem, tỷ lệ nhấp vào chú thích, tỷ lệ đóng chú thích và số lượt hiển thị chú thích theo quốc gia cho các video của kênh. Kết quả được sắp xếp theo tỷ lệ nhấp vào chú thích theo thứ tự giảm dần, tức là quốc gia có tỷ lệ nhấp vào chú thích cao nhất sẽ được liệt kê trước tiên.
dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=-annotationClickThroughRateChỉ số theo tỉnh cho các tiểu bang ở Hoa Kỳ và Washington, D.C.
Yêu cầu này truy xuất thông tin chi tiết theo tỉnh về số lượt xem, số phút xem ước tính và thời lượng xem trung bình của các video trên kênh. Dữ liệu này bao gồm các tiểu bang của Hoa Kỳ và Washington D.C. Kết quả được sắp xếp theo thứ tự bảng chữ cái theo mã ISO 3166-2 của tỉnh bang.
dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=provinceTop 10 – Những video được xem nhiều nhất ở một quốc gia cụ thể
Truy vấn này truy xuất 10 video được xem nhiều nhất của kênh, được tính theo số lượt xem trong phạm vi ngày đã chỉ định, ở một quốc gia cụ thể. Kết quả được sắp xếp theo số lượt xem theo thứ tự giảm dần.
Lưu ý: Báo cáo này yêu cầu bạn chỉ định giá trị cho tham số yêu cầu sort và đặt tham số maxResults thành giá trị số nguyên từ 10 trở xuống.
dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=country==US
maxResults=10
sort=-views10 thành phố hàng đầu ở Hoa Kỳ theo tổng số lượt xem
Truy vấn này truy xuất danh sách 10 thành phố ở Hoa Kỳ có nhiều lượt xem nội dung của kênh nhất trong phạm vi ngày đã chỉ định. Bạn có thể sửa đổi truy vấn để yêu cầu dữ liệu cho một quốc gia khác bằng cách chọn một giá trị hợp lệ khác cho bộ lọc đó. Tương tự, bạn có thể sửa đổi truy vấn để truy xuất dữ liệu cho một tiểu lục địa, chẳng hạn như Tây Âu hoặc Đông Nam Á, bằng cách sử dụng bộ lọc subContinent (Tiểu lục địa) và một trong các giá trị hợp lệ của bộ lọc đó. Các bộ lọc khác cũng được hỗ trợ. Kết quả được sắp xếp theo số lượt xem theo thứ tự giảm dần.
dimensions=city
metrics=views
filters=country==US
maxResults=10
sort=-views10 thành phố hàng đầu ở Hoa Kỳ theo tổng số lượt xem của từng loại nội dung
Truy vấn này truy xuất danh sách 10 thành phố ở Hoa Kỳ có nhiều lượt xem nội dung của kênh nhất trong phạm vi ngày được chỉ định cho mỗi creatorContentType được hỗ trợ. Kết quả được sắp xếp theo số lượt xem theo thứ tự giảm dần.
dimensions=city,creatorContentType
metrics=views
filters=country==US
maxResults=10
sort=-views10 thành phố hàng đầu ở Hoa Kỳ theo tổng thời gian xem
Truy vấn này truy xuất danh sách 10 ngày hàng đầu trong phạm vi ngày đã chỉ định, khi bất kỳ thành phố nào của Hoa Kỳ có tổng thời gian xem nội dung của kênh nhiều nhất mỗi ngày. Kết quả truy vấn sẽ xác định tổng thời gian xem, ngày diễn ra thời gian xem và thành phố nơi nội dung được ước tính là đã được xem. Kết quả được sắp xếp theo thứ tự giảm dần của tổng thời gian xem.
dimensions=city,day
metrics=estimatedWatchTime
filters=country==US
maxResults=10
sort=-estimatedWatchTimeTop 10 – Video được xem nhiều nhất ở Châu Âu
Truy vấn này truy xuất 10 video được xem nhiều nhất của kênh ở Châu Âu, được đo bằng số lượt xem trong phạm vi ngày được chỉ định. Bạn có thể sửa đổi truy vấn để yêu cầu dữ liệu cho một Châu lục khác bằng cách chọn một giá trị hợp lệ khác cho bộ lọc đó. Tương tự, bạn có thể sửa đổi truy vấn để truy xuất dữ liệu cho một tiểu lục địa, chẳng hạn như Tây Âu hoặc Đông Nam Á, bằng cách sử dụng bộ lọc subContinent (Tiểu lục địa) và một trong các giá trị hợp lệ của bộ lọc đó. Kết quả được sắp xếp theo số lượt xem theo thứ tự giảm dần.
Lưu ý: Báo cáo này yêu cầu bạn chỉ định giá trị cho tham số yêu cầu sort và đặt tham số maxResults thành giá trị số nguyên từ 10 trở xuống.
dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=continent==150
maxResults=10
sort=-viewsBáo cáo danh sách phát
Chỉ số thời gian xem theo quốc gia cho danh sách phát của một kênh
Truy vấn này truy xuất số lượt xem theo quốc gia cụ thể (một chỉ số video tổng hợp), số lượt xem danh sách phát (chỉ số trong danh sách phát) và chỉ số thời gian xem cho các danh sách phát của một kênh. Báo cáo này trả về một hàng dữ liệu cho mỗi quốc gia nơi người dùng xem danh sách phát của kênh. Các hàng được sắp xếp theo thứ tự giảm dần về số phút xem.
dimensions=country
metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-estimatedMinutesWatchedTop 10 – Danh sách phát được bắt đầu nhiều nhất ở Hoa Kỳ
Truy vấn này truy xuất 10 danh sách phát mà người xem ở Hoa Kỳ bắt đầu xem thường xuyên nhất trong phạm vi ngày đã chỉ định. Kết quả được sắp xếp theo số lần bắt đầu của danh sách phát theo thứ tự giảm dần.
Lưu ý: Vì báo cáo này sử dụng phương diện playlist, nên bạn phải chỉ định một giá trị cho tham số yêu cầu sort cũng như đặt tham số maxResults thành giá trị số nguyên từ 10 trở xuống.
dimensions=playlist
metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration
filters=isCurated==1;country==US
maxResults=10
sort=-playlistStartsBáo cáo video
Số lượt xem và thời gian xem từ nhiều vị trí phát
Truy vấn này truy xuất số lượt xem và thời gian xem ước tính cho các video của kênh cụ thể. Kết quả được tổng hợp dựa trên loại trang hoặc ứng dụng nơi diễn ra lượt phát video và được sắp xếp theo thứ tự giảm dần theo số lượt xem.
dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
sort=-viewsSố lượt xem và thời gian xem hằng ngày ở nhiều vị trí phát
Truy vấn này truy xuất số lượt xem hằng ngày và thời gian xem ước tính ở Hoa Kỳ cho các video của một kênh cụ thể. Kết quả được nhóm theo ngày cho từng loại trang hoặc ứng dụng có lượt phát video. Kết quả được sắp xếp theo thứ tự thời gian.
dimensions=day,insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=country==US sort=day
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 một video được nhúng
Truy vấn này truy xuất số lượt xem và thời gian xem ước tính cho một video hoặc nhóm video cụ thể. Kết quả được nhóm theo trang web của bên thứ ba nơi video được nhúng. Kết quả được sắp xếp theo thứ tự giảm dần theo số lượt xem. Xin lưu ý rằng để chạy truy vấn này trong Trình khám phá API, bạn phải thay thế chuỗi VIDEO_ID trong giá trị tham số filters bằng danh sách được phân tách bằng dấu phẩy gồm một hoặc nhiều mã video cho các video bạn đã tải lên.
dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-viewsBáo cáo danh sách phát
Số lượt xem và thời gian xem danh sách phát ở nhiều vị trí phát
Truy vấn này truy xuất số lượt xem (chỉ số video tổng hợp), lượt xem danh sách phát (chỉ số trong danh sách phát), thời gian xem ước tính và số lượt bắt đầu danh sách phát của một danh sách phát cụ thể trên một kênh. Kết quả được tổng hợp dựa trên loại trang hoặc ứng dụng nơi xảy ra lượt phát video và kết quả được sắp xếp theo thứ tự giảm dần theo số lần bắt đầu danh sách phát.
dimensions=insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=-playlistStartsSố lượt xem và thời gian xem danh sách phát hằng ngày ở nhiều vị trí phát
Truy vấn này truy xuất số lượt bắt đầu danh sách phát hằng ngày, số lượt xem (chỉ số video tổng hợp), số lượt xem danh sách phát (chỉ số trong danh sách phát) và thời gian xem ước tính ở Hoa Kỳ cho các danh sách phát của một kênh cụ thể. Kết quả được nhóm theo ngày cho từng loại trang hoặc ứng dụng nơi xảy ra lượt xem danh sách phát. Kết quả được sắp xếp theo thứ tự thời gian.
dimensions=day,insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
filters=country==US
sort=dayBáo cáo video
Lượt thích và lượt không thích theo loại nội dung
Truy vấn này truy xuất số lượt thích và không thích cho từng loại nội dung trên một kênh.
dimensions=creatorContentType
metrics=likes,dislikesBáo cáo video
Số lượt xem và thời gian xem từ các nguồn lưu lượng truy cập ở một quốc gia
Yêu cầu này truy xuất số lượt xem và thời gian xem ước tính của các video trên kênh ở một quốc gia cụ thể. Các chỉ số này được tổng hợp theo nguồn lưu lượng truy cập, mô tả cách người dùng truy cập vào video.
dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=country==USSố lượt xem và thời gian xem hằng ngày từ các nguồn lưu lượng truy cập
Yêu cầu này truy xuất số lượt xem hằng ngày và thời gian xem ước tính hằng ngày cho các video của kênh. Các chỉ số này được tổng hợp hằng ngày theo nguồn lưu lượng truy cập và được sắp xếp theo thứ tự thời gian.
dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
sort=day10 cụm từ tìm kiếm hàng đầu trên YouTube giúp video thu hút nhiều lưu lượng truy cập nhất
Truy vấn này truy xuất 10 cụm từ tìm kiếm tạo ra nhiều lượt xem nhất từ kết quả tìm kiếm trên YouTube cho một hoặc nhiều video cụ thể. Kết quả được sắp xếp theo số lượt xem theo thứ tự giảm dần. Xin lưu ý rằng để chạy truy vấn này trong Trình khám phá API, bạn phải thay thế chuỗi VIDEO_ID trong giá trị tham số filters bằng danh sách được phân tách bằng dấu phẩy gồm tối đa 500 mã video.
Ví dụ: bạn có thể chạy truy vấn cho một video hoặc thay thế VIDEO_ID để xác định những cụm từ tìm kiếm tạo ra nhiều lưu lượng truy cập nhất cho video đó. Bạn cũng có thể liệt kê tất cả video trong một danh sách phát cụ thể để xác định những cụm từ tìm kiếm tạo ra nhiều lưu lượng truy cập nhất cho bất kỳ video nào trong danh sách phát đó.
dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-viewsTop 10 – Những trang web bên ngoài mang đến nhiều lưu lượng truy cập nhất cho một video
Truy vấn này truy xuất 10 trang web bên ngoài đã tạo ra nhiều lượt xem nhất cho một video hoặc nhóm video cụ thể. Kết quả được sắp xếp theo thời gian xem ước tính theo thứ tự giảm dần. Xin lưu ý rằng để chạy truy vấn này trong Trình khám phá API, bạn phải thay thế chuỗi VIDEO_ID trong giá trị tham số filters bằng danh sách được phân tách bằng dấu phẩy gồm tối đa 500 mã video cho các video mà bạn đã tải lên.
dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatchedBáo cáo danh sách phát
Số lượt xem và thời gian xem danh sách phát từ các nguồn lưu lượng truy cập khác nhau ở một quốc gia
Yêu cầu này truy xuất số lượt xem (chỉ số video tổng hợp), số lượt xem danh sách phát (chỉ số trong danh sách phát), số lượt bắt đầu danh sách phát và thời gian xem ước tính cho các lượt xem danh sách phát ở một quốc gia cụ thể. Các chỉ số này được tổng hợp theo nguồn lưu lượng truy cập, mô tả cách thức mà người dùng truy cập vào danh sách phát.
dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatchedplaylistStarts,playlistViews
filters=country==USSố lượt xem và thời gian xem danh sách phát hằng ngày từ nhiều nguồn lưu lượng truy cập
Yêu cầu này truy xuất số lượt xem danh sách phát hằng ngày của kênh (chỉ số trong danh sách phát), số lượt bắt đầu phát danh sách phát và thời gian xem ước tính. Phương thức này cũng truy xuất tổng số lượt xem (một chỉ số video tổng hợp). Các chỉ số được tổng hợp hằng ngày theo nguồn lưu lượng truy cập và được sắp xếp theo thứ tự thời gian.
dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=dayBáo cáo video
Các chỉ số hằng ngày về loại thiết bị cho hệ điều hành Android
Truy vấn này truy xuất số lượt xem hằng ngày và thời gian xem ước tính trên thiết bị Android cho các video của một kênh cụ thể. Kết quả được nhóm theo ngày cho từng loại thiết bị phát video. Kết quả được sắp xếp theo thứ tự thời gian.
dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=operatingSystem==ANDROID
sort=dayChỉ số hằng ngày về hệ điều hành cho thiết bị di động
Truy vấn này truy xuất số lượt xem hằng ngày và thời gian xem ước tính trên thiết bị di động cho các video của một kênh cụ thể. Kết quả được nhóm theo ngày cho từng hệ điều hành mà người dùng đã phát video. Kết quả được sắp xếp theo thứ tự thời gian.
dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=deviceType==MOBILE
sort=dayChỉ số hằng ngày về hệ điều hành và loại thiết bị
Truy vấn này truy xuất số lượt xem hằng ngày và thời gian xem ước tính của một kênh. Số liệu thống kê được nhóm theo hệ điều hành và loại thiết bị. Kết quả được sắp xếp theo thứ tự thời gian.
dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=dayBáo cáo về danh sách phát
Chỉ số hằng ngày về loại thiết bị cho số lượt xem danh sách phát trên hệ điều hành Android
Truy vấn này truy xuất số lượt xem hằng ngày (chỉ số video tổng hợp), số lượt xem danh sách phát (chỉ số trong danh sách phát) và thời gian xem ước tính trên thiết bị Android đối với danh sách phát của một kênh cụ thể. Kết quả được nhóm theo ngày cho từng loại thiết bị mà lượt xem danh sách phát đã diễn ra. Kết quả được sắp xếp theo thứ tự thời gian.
dimensions=day,deviceType
metrics=views,estimatedMinutesWatched,playlistViews
filters=operatingSystem==ANDROID
sort=dayChỉ số hằng ngày về hệ điều hành cho số lượt xem danh sách phát trên thiết bị di động
Truy vấn này truy xuất số lượt xem hằng ngày (chỉ số video tổng hợp), số lượt xem danh sách phát (chỉ số trong danh sách phát) và thời gian xem ước tính trên thiết bị di động cho các danh sách phát của một kênh cụ thể. Kết quả được nhóm theo ngày cho từng hệ điều hành mà lượt xem danh sách phát đã xảy ra. Kết quả được sắp xếp theo thứ tự thời gian.
dimensions=day,operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE
sort=dayBáo cáo video
Thông tin nhân khẩu học của người xem ở California (nhóm tuổi và giới tính)
Báo cáo này truy xuất số liệu thống kê về độ tuổi và giới tính của những người xem ở California đã xem video của kênh. Kết quả được sắp xếp theo giới tính, sau đó là theo nhóm tuổi. Bạn có thể sửa đổi truy vấn này để truy xuất cùng một số liệu thống kê cho tất cả người xem trên toàn thế giới hoặc tất cả người xem ở một quốc gia, lục địa, tiểu lục địa hoặc một tiểu bang khác của Hoa Kỳ bằng cách điều chỉnh giá trị tham số filters.
dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroupBáo cáo danh sách phát
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)
Báo cáo này truy xuất số liệu thống kê về độ tuổi và giới tính của những người xem ở California đã xem danh sách phát của kênh. Kết quả được sắp xếp theo giới tính, sau đó là theo nhóm tuổi. Bạn có thể sửa đổi truy vấn này để lấy cùng một số liệu thống kê cho tất cả người xem trên toàn thế giới hoặc cho tất cả người xem ở một quốc gia, châu lục, tiểu lục địa hoặc một tiểu bang khác của Hoa Kỳ bằng cách điều chỉnh giá trị tham số filters.
dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroupChỉ số về hoạt động chia sẻ, được tổng hợp theo dịch vụ mà video được chia sẻ
Yêu cầu này truy xuất số lần người dùng sử dụng nút Share để chia sẻ video của một kênh. Kết quả được tổng hợp theo dịch vụ chia sẻ (Google+, Twitter, v.v.) và được sắp xếp theo thứ tự giảm dần của số lượt chia sẻ.
dimensions=sharingService
metrics=shares
sort=-sharesChỉ số về tỷ lệ giữ chân người xem của một video
Báo cáo này đo lường khả năng giữ chân người xem của một video. Mỗi lần, bạn chỉ có thể truy xuất báo cáo cho một video. Lưu ý rằng để chạy truy vấn này trong APIs Explorer, bạn phải thay thế chuỗi VIDEO_ID trong giá trị tham số filters bằng mã video của một trong những video bạn đã tải lên. Xin lưu ý rằng báo cáo tỷ lệ giữ chân đối tượng không hỗ trợ việc chỉ định nhiều giá trị cho bộ lọc video.
Trong ví dụ này, báo cáo sử dụng bộ lọc audienceType để hạn chế câu trả lời sao cho chỉ chứa dữ liệu về lượt xem tự nhiên, là kết quả của một hành động trực tiếp của người dùng, chẳng hạn như tìm kiếm video hoặc nhấp vào một video đề xuất. Do đó, báo cáo này không bao gồm dữ liệu về số lượt xem từ quảng cáo TrueView trong luồng hoặc quảng cáo TrueView trong màn hình hiển thị. Bạn có thể xoá bộ lọc này để truy xuất dữ liệu tỷ lệ giữ chân người xem của video từ tất cả các loại đối tượng.
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 sẽ 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ừ những ngày trước đó. Các cụm từ tìm kiếm không sử dụng bộ lọc này sẽ hoạt động cho mọi ngày sau ngày 1 tháng 7 năm 2008.
dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANICChỉ số về doanh thu của kênh và hiệu suất quảng cáo
Yêu cầu này truy xuất các chỉ số về doanh thu và hiệu suất quảng cáo của một kênh. Báo cáo này trả về một hàng dữ liệu chứa tổng số cho từng chỉ số được yêu cầu trong phạm vi ngày đã chỉ định.
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacksChỉ số hiệu suất quảng cáo và doanh thu hằng ngày
Yêu cầu này truy xuất doanh thu hằng ngày và các chỉ số hiệu suất quảng cáo của một kênh.
dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacksChỉ số hiệu suất quảng cáo và doanh thu theo quốc gia
Yêu cầu này truy xuất chỉ số hiệu suất quảng cáo và doanh thu theo quốc gia của kênh. Kết quả được sắp xếp theo thứ tự giảm dần theo doanh thu, có nghĩa là quốc gia đầu tiên được liệt kê sẽ là quốc gia mà đối tác có doanh thu ròng lớn nhất.
dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
sort=-estimatedRevenueTop 10 – Video có doanh thu cao nhất
Yêu cầu này truy xuất các chỉ số về doanh thu và hiệu suất quảng cáo của 10 video có doanh thu lớn nhất trên kênh. Kết quả được sắp xếp theo thứ tự giảm dần theo số tiền doanh thu, tức là video đầu tiên sẽ là video có doanh thu ước tính cao nhất.
dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
maxResults=10
sort=-estimatedRevenueChỉ số hiệu suất quảng cáo cho nhiều loại quảng cáo
Yêu cầu này truy xuất các chỉ số hiệu suất quảng cáo cho nội dung được xác nhận quyền sở hữu của chủ sở hữu nội dung. Kết quả được nhóm theo loại quảng cáo, cho phép bạn so sánh giá trị doanh thu và CPM giữa các loại quảng cáo.
dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adTypeBáo cáo của chủ sở hữu nội dung
Báo cáo video
Tổng số lượt xem, thời gian xem ước tính và các thông tin khác về tất cả nội dung được xác nhận quyền sở hữu
Truy vấn này truy xuất các chỉ số tổng hợp cho nội dung mà chủ sở hữu nội dung đã xác nhận quyền sở hữu. Báo cáo này trả về một hàng dữ liệu chứa tổng số cho từng chỉ số được yêu cầu trong phạm vi ngày đã chỉ định.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimedSố lượt xem theo quốc gia (và nhiều thông tin khác) cho tất cả video do bạn tự tải lên
Truy vấn này truy xuất các chỉ số cho một quốc gia cụ thể đối với những video mà chủ sở hữu nội dung đã tải lên. Báo cáo này trả về một hàng dữ liệu chứa tổng số cho từng chỉ số được yêu cầu trong phạm vi ngày đã chỉ định.
metrics=views,comments,likes,dislikes,shares
filters=uploaderType==self;country==FRTổng số lượt xem (và các thông tin khác) của tất cả nội dung của bên thứ ba mà bạn đã xác nhận quyền sở hữu
Truy vấn này truy xuất các chỉ số tổng hợp cho những video mà chủ sở hữu nội dung đã xác nhận quyền sở hữu nhưng không tải lên. Báo cáo này trả về một hàng dữ liệu chứa tổng số của từng chỉ số được yêu cầu trong phạm vi ngày đã chỉ định.
metrics=views,comments,likes,dislikes,shares
filters=uploaderType==thirdParty;claimedStatus==claimedTổng số lượt xem (và các chỉ số khác) của tất cả nội dung do bạn tự tải lên
Truy vấn này truy xuất chỉ số tổng hợp cho những video mà chủ sở hữu nội dung đã tải lên. Báo cáo này trả về một hàng dữ liệu chứa tổng số cho từng chỉ số được yêu cầu trong phạm vi ngày đã chỉ định.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=uploaderType==selfTổng số lượt xem (và các thông tin khác) của tất cả nội dung do bạn tự tải lên và được xác nhận quyền sở hữu
Truy vấn này truy xuất các chỉ số tổng hợp cho những video mà chủ sở hữu nội dung đã tải lên và xác nhận quyền sở hữu. Báo cáo này trả về một hàng dữ liệu chứa tổng số cho từng chỉ số được yêu cầu trong phạm vi ngày đã chỉ định.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=uploaderType==self;claimedStatus==claimedTop 10 – Những video được xem nhiều nhất của một chủ sở hữu nội dung
Truy vấn này truy xuất 10 video được xem nhiều nhất (được tính theo số lượt xem trong phạm vi ngày đã chỉ định) mà chủ sở hữu nội dung đã tải lên. Kết quả được sắp xếp theo số lượt xem theo thứ tự giảm dần.
dimensions=video
metrics=views,estimatedMinutesWatched,estimatedRevenue,estimatedAdRevenue,monetizedPlaybacks,adImpressions
filters=uploaderType==self
maxResults=10
sort=-viewsTop 10 – Những video được xem nhiều nhất của một chủ sở hữu nội dung
Truy vấn này truy xuất 10 video được xem nhiều nhất (được tính theo số phút xem ước tính trong phạm vi ngày đã chỉ định) mà chủ sở hữu nội dung đã tải lên. Kết quả được sắp xếp theo số phút đã xem ước tính theo thứ tự giảm dần.
dimensions=video
metrics=estimatedMinutesWatched,averageViewDuration,averageViewPercentage,views,subscribersGained
filters=uploaderType==self
maxResults=10
sort=-estimatedMinutesWatchedTop 10 – Những video được xem nhiều nhất trên kênh của chủ sở hữu nội dung
Truy vấn này truy xuất 10 video được xem nhiều nhất trên một kênh hoặc nhóm kênh cụ thể mà chủ sở hữu nội dung quản lý. Kết quả được sắp xếp theo số lượt xem theo thứ tự giảm dần. Xin lưu ý rằng để chạy truy vấn này trong Trình khám phá API, bạn phải thay thế chuỗi CHANNEL_ID trong giá trị tham số filters bằng danh sách được phân tách bằng dấu phẩy gồm tối đa 500 mã kênh cho các kênh của bạn.
dimensions=video
metrics=views
filters=channel==CHANNEL_ID
maxResults=10
sort=-viewsTop 10 – Tỷ lệ nhấp vào chú thích của những video được xem nhiều nhất trên kênh
Yêu cầu này truy xuất số lượt xem, tỷ lệ nhấp vào chú thích, tỷ lệ đóng chú thích và số lần hiển thị chú thích cho 10 video được xem nhiều nhất trong một kênh hoặc nhóm kênh cụ thể. Kết quả được sắp xếp theo số lượt xem theo thứ tự giảm dần, có nghĩa là video được xem nhiều nhất sẽ được liệt kê đầu tiên. Xin lưu ý rằng để chạy truy vấn này trong Trình khám phá API, bạn phải thay thế chuỗi CHANNEL_ID trong giá trị tham số filters bằng danh sách được phân tách bằng dấu phẩy gồm tối đa 500 mã kênh cho các kênh của bạn.
dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=channel==CHANNEL_ID
maxResults=10
sort=-viewsBáo cáo danh sách phát
Số lượt xem danh sách phát trên các kênh của chủ sở hữu nội dung
Yêu cầu này truy xuất tổng số lượt bắt đầu của danh sách phát, số phút đã xem ước tính của danh sách phát, số lượt xem
danh sách phát và số lượt xem trên mỗi lần bắt đầu của danh sách phát cho các danh sách phát trên kênh của chủ sở hữu nội dung. Chỉ số
playlistViews chỉ tính lượt xem video xảy ra trong bối cảnh
danh sách phát. Vì tất cả chỉ số được yêu cầu đều là chỉ số trong danh sách phát, nên yêu cầu này cũng không cần phải bao gồm bộ lọc danh sách phát hoặc nhóm.
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStartSố liệu thống kê cho một danh sách phát cụ thể
Yêu cầu này truy xuất tổng số lượt bắt đầu của danh sách phát, số phút đã xem ước tính, số lượt xem (chỉ số video tổng hợp), số lượt xem danh sách phát (chỉ số trong danh sách phát) và số lượt xem trên mỗi lần bắt đầu của danh sách phát của một danh sách phát cụ thể. Xin lưu ý rằng để chạy truy vấn này trong Trình khám phá API, bạn phải thay thế chuỗi PLAYLIST_ID trong giá trị tham số filters bằng mã danh sách cho một danh sách phát trong một trong các kênh của chủ sở hữu nội dung.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
filters=playlist==PLAYLIST_IDĐể truy xuất số liệu thống kê tổng hợp cho nhiều danh sách phát, bạn cũng có thể thay thế chuỗi PLAYLIST_ID bằng danh sách được phân tách bằng dấu phẩy gồm tối đa 500 mã danh sách phát cho các danh sách phát trong kênh của chủ sở hữu nội dung.
Báo cáo video
Chỉ số về thời gian xem hằng ngày đối với nội dung do chính bạn tải lên
Truy vấn này truy xuất các chỉ số về thời gian xem hằng ngày, cũng như số lượt xem, số lượt phát có thể kiếm tiền và số lượt hiển thị cho những video mà chủ sở hữu nội dung đã tải lên. Báo cáo trả về một hàng dữ liệu cho mỗi ngày trong phạm vi ngày được yêu cầu và các hàng được sắp xếp theo thứ tự thời gian.
dimensions=day
metrics=estimatedMinutesWatched,averageViewPercentage,views,monetizedPlaybacks,adImpressions
filters=uploaderType==self
sort=dayChỉ số chú thích cho nội dung được xác nhận quyền sở hữu
Yêu cầu này truy xuất số lượt xem hằng ngày, tỷ lệ nhấp vào chú thích, tỷ lệ đóng chú thích và số lượt hiển thị chú thích cho nội dung đã được xác nhận quyền sở hữu của chủ sở hữu nội dung. Kết quả được sắp xếp theo thứ tự thời gian.
dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=claimedStatus==claimed
sort=dayBáo cáo danh sách phát
Số lượt xem danh sách phát hằng ngày của một chủ sở hữu nội dung
Yêu cầu này truy xuất các chỉ số về lượt tương tác hằng ngày của người dùng với video trong danh sách phát của chủ sở hữu nội dung. Các chỉ số được truy xuất trong báo cáo này là playlistViews, playlistStarts, playlistEstimatedMinutesWatched và viewsPerPlaylistStart. Tất cả các chỉ số này đều là chỉ số trong danh sách phát. Vì tất cả chỉ số được yêu cầu đều là chỉ số trong danh sách phát, nên yêu cầu không cần phải bao gồm bộ lọc danh sách phát hoặc nhóm.
dimensions=day
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
sort=dayBáo cáo video
Chỉ số thời gian xem theo quốc gia đối với nội dung do người dùng tự tải lên
Truy vấn này truy xuất số lượt xem, chỉ số thời gian xem và doanh thu ước tính từ quảng cáo cho từng quốc gia. Các chỉ số này là dành cho những video do chủ sở hữu nội dung tải lên. Báo cáo sẽ trả về một hàng dữ liệu cho mỗi quốc gia nơi video đã được xem và các hàng được sắp xếp theo thứ tự giảm dần về số phút đã xem.
dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,estimatedRevenue,estimatedAdRevenue,grossRevenue
filters=uploaderType==self
sort=-estimatedMinutesWatchedChỉ số chú thích theo quốc gia đối với nội dung do người dùng tự tải lên
Yêu cầu này truy xuất số lượt xem theo quốc gia cụ thể, tỷ lệ nhấp vào chú thích, tỷ lệ đóng chú thích và số lượt hiển thị chú thích cho video đã tải lên của chủ sở hữu nội dung. Kết quả được sắp xếp theo tỷ lệ nhấp vào chú thích theo thứ tự giảm dần, tức là quốc gia có tỷ lệ nhấp vào chú thích cao nhất sẽ được liệt kê trước tiên.
dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=uploaderType==self
sort=-annotationClickThroughRateChỉ số theo tỉnh cho các tiểu bang ở Hoa Kỳ và Washington, D.C.
Yêu cầu này sẽ truy xuất thông tin chi tiết theo tỉnh về số lượt xem, số phút xem ước tính và thời lượng xem trung bình của những video được xác nhận quyền sở hữu của chủ sở hữu nội dung. Dữ liệu này bao gồm các tiểu bang của Hoa Kỳ và Washington, D.C. Kết quả được sắp xếp theo thứ tự bảng chữ cái theo mã ISO 3166-2 của các tỉnh.
dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province10 thành phố hàng đầu ở Hoa Kỳ theo tổng số lượt xem
Truy vấn này truy xuất danh sách 10 thành phố ở Hoa Kỳ có nhiều lượt xem nhất đối với các video đã được xác nhận quyền sở hữu của chủ sở hữu nội dung trong khoảng thời gian đã chỉ định. Bạn có thể sửa đổi truy vấn để yêu cầu dữ liệu cho một quốc gia khác bằng cách chọn một giá trị hợp lệ khác cho bộ lọc đó. Tương tự, bạn có thể sửa đổi truy vấn để truy xuất dữ liệu cho một tiểu lục địa, chẳng hạn như Tây Âu hoặc Đông Nam Á, bằng cách sử dụng bộ lọc subContinent (Tiểu lục địa) và một trong các giá trị hợp lệ của bộ lọc đó. Các bộ lọc khác cũng được hỗ trợ. Kết quả được sắp xếp theo số lượt xem theo thứ tự giảm dần.
dimensions=city
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views10 thành phố hàng đầu ở Hoa Kỳ theo tổng số lượt xem của từng loại nội dung
Truy vấn này truy xuất danh sách 10 thành phố ở Hoa Kỳ có nhiều lượt xem nhất đối với nội dung được xác nhận quyền sở hữu của chủ sở hữu nội dung trong phạm vi ngày được chỉ định cho mỗi creatorContentType được hỗ trợ. Kết quả được sắp xếp theo số lượt xem theo thứ tự giảm dần.
dimensions=city,creatorContentType
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views10 thành phố hàng đầu ở Hoa Kỳ theo tổng thời gian xem
Truy vấn này truy xuất danh sách 10 ngày hàng đầu trong phạm vi ngày được chỉ định, khi bất kỳ thành phố nào ở Hoa Kỳ có tổng thời gian xem hằng ngày lớn nhất đối với nội dung được xác nhận quyền sở hữu của chủ sở hữu nội dung. Kết quả truy vấn cho biết tổng thời gian xem, ngày xảy ra thời gian xem và thành phố nơi nội dung được xem theo ước tính. Kết quả được sắp xếp theo thứ tự giảm dần của tổng thời gian xem.
dimensions=city,day
metrics=estimatedWatchTime
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-estimatedWatchTimeTop 10 – Video được xem nhiều nhất ở Châu Âu
Truy vấn này truy xuất 10 video được xem nhiều nhất ở Châu Âu, trong số những video do chủ sở hữu nội dung xác nhận quyền sở hữu, được đo bằng số lượt xem trong phạm vi ngày được chỉ định. Bạn có thể sửa đổi truy vấn để yêu cầu dữ liệu cho một lục địa khác bằng cách chọn một giá trị hợp lệ khác cho bộ lọc đó. Tương tự, bạn có thể sửa đổi truy vấn để truy xuất dữ liệu cho một tiểu lục địa, chẳng hạn như Tây Âu hoặc Đông Nam Á, bằng cách sử dụng bộ lọc subContinent (Tiểu lục địa) và một trong các giá trị hợp lệ của bộ lọc đó. Kết quả được sắp xếp theo số lượt xem theo thứ tự giảm dần.
dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=claimedStatus==claimed;filters=continent==150
maxResults=10
sort=-estimatedMinutesWatchedBáo cáo danh sách phát
Chỉ số thời gian xem theo quốc gia cho danh sách phát của chủ sở hữu nội dung
Truy vấn này truy xuất số lượt xem danh sách phát theo quốc gia và chỉ số thời gian xem danh sách phát cho tất cả danh sách phát trong các kênh của chủ sở hữu nội dung. Báo cáo này trả về một hàng dữ liệu cho mỗi quốc gia nơi người dùng xem danh sách phát. Các hàng được sắp xếp theo thứ tự giảm dần theo số phút xem.
dimensions=country
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-playlistEstimatedMinutesWatchedTop 10 – Danh sách phát được bắt đầu nhiều nhất ở Hoa Kỳ
Truy vấn này truy xuất 10 danh sách phát từ các kênh của chủ sở hữu nội dung mà người xem ở Hoa Kỳ bắt đầu xem thường xuyên nhất trong phạm vi ngày được chỉ định. Kết quả được sắp xếp theo số lần bắt đầu danh sách phát theo thứ tự giảm dần.
Lưu ý: Vì báo cáo này sử dụng phương diện playlist, nên bạn phải chỉ định giá trị cho tham số yêu cầu sort và cũng đặt tham số maxResults thành giá trị số nguyên từ 10 trở xuống.
dimensions=playlist
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched,playlistAverageViewDuration
filters=country==US
maxResults=10
sort=-playlistStartsBáo cáo video
Lượt thích và không thích theo loại nội dung
Truy vấn này truy xuất số lượt thích và lượt không thích cho từng loại nội dung trên một kênh hoặc nhóm kênh cụ thể. Xin lưu ý rằng để chạy truy vấn này trong Trình khám phá API, bạn phải thay thế chuỗi CHANNEL_ID trong giá trị tham số filters bằng danh sách được phân tách bằng dấu phẩy gồm tối đa 500 mã kênh cho các kênh của bạn.
dimensions=creatorContentType
metrics=likes,dislikes
filters=channel==CHANNEL_IDBáo cáo video
Số lượt xem và thời gian xem từ nhiều vị trí phát
Truy vấn này truy xuất số lượt xem và thời gian xem ước tính của các video được tải lên một kênh hoặc nhóm kênh cụ thể. Kết quả được tổng hợp dựa trên loại trang hoặc ứng dụng nơi diễn ra lượt phát video và được sắp xếp theo thứ tự giảm dần theo số lượt xem. Xin lưu ý rằng để chạy truy vấn này trong Trình khám phá API, bạn phải thay thế chuỗi CHANNEL_ID trong giá trị tham số filters bằng danh sách được phân tách bằng dấu phẩy gồm tối đa 500 mã kênh cho các kênh của bạn.
dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=channel==CHANNEL_ID
sort=-viewsSố lượt xem và thời gian xem hằng ngày ở nhiều vị trí phát
Truy vấn này truy xuất số lượt xem hằng ngày và thời gian xem ước tính ở Hoa Kỳ cho những video được tải lên một kênh hoặc nhóm kênh cụ thể. Kết quả được nhóm theo ngày cho từng loại trang hoặc ứng dụng có lượt phát video. Kết quả được sắp xếp theo thứ tự đảo ngược. Lưu ý: Để chạy truy vấn này trong APIs Explorer, bạn phải thay thế chuỗi CHANNEL_ID trong giá trị tham số filters bằng danh sách tối đa 500 mã nhận dạng kênh được phân tách bằng dấu phẩy cho các kênh của bạn.
dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US;channel==CHANNEL_ID
sort=-day10 hàng đầu – Các trang web của bên thứ ba tạo ra nhiều lượt xem nhất cho một video được nhúng
Truy vấn này truy xuất số lượt xem và thời gian xem ước tính cho một video hoặc nhóm video cụ thể. Kết quả được nhóm theo trang web của bên thứ ba nơi video được nhúng. Kết quả được sắp xếp theo thứ tự giảm dần theo số lượt xem. Xin lưu ý rằng để chạy truy vấn này trong Trình khám phá API, bạn phải thay thế chuỗi VIDEO_ID trong giá trị tham số filters bằng danh sách được phân tách bằng dấu phẩy gồm tối đa 500 mã video cho các video mà bạn đã tải lên.
dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-viewsBáo cáo danh sách phát
Số lượt xem danh sách phát và thời gian xem từ các vị trí phát khác nhau
Truy vấn này truy xuất số lượt xem danh sách phát, thời gian xem ước tính của danh sách phát và số lần bắt đầu phát danh sách phát cho tất cả danh sách phát trong kênh của chủ sở hữu nội dung. Kết quả được tổng hợp dựa trên loại trang hoặc ứng dụng nơi diễn ra lượt phát video và được sắp xếp theo thứ tự giảm dần theo số lần bắt đầu danh sách phát.
dimensions=insightPlaybackLocationType
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts
sort=-playlistStartsSố lượt xem danh sách phát và thời gian xem từ các vị trí phát khác nhau
Truy vấn này truy xuất số lượt bắt đầu xem danh sách phát hằng ngày, số lượt xem danh sách phát và thời gian xem danh sách phát ước tính tại Hoa Kỳ cho tất cả danh sách phát trong kênh của chủ sở hữu nội dung. Kết quả được trả về cho từng loại trang hoặc ứng dụng nơi xảy ra lượt xem danh sách phát.
dimensions=day,insightPlaybackLocationType metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched filters=country==US
Báo cáo video
Số lượt xem và thời gian xem từ các nguồn lưu lượng truy cập
Yêu cầu này truy xuất số lượt xem và thời gian xem ước tính cho video của chủ sở hữu nội dung. Các chỉ số này được tổng hợp theo nguồn lưu lượng truy cập, mô tả cách người dùng truy cập vào video.
dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==selfSố lượt xem và thời gian xem hằng ngày từ nhiều nguồn lưu lượng truy cập
Yêu cầu này truy xuất số lượt xem hằng ngày và thời gian xem ước tính hằng ngày cho các video của chủ sở hữu nội dung. Các chỉ số này được tổng hợp hằng ngày theo nguồn lưu lượng truy cập và được sắp xếp theo thứ tự đảo ngược theo thứ tự thời gian.
dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self
sort=-dayLưu ý: Hai báo cáo mẫu tiếp theo chỉ được hỗ trợ cho một số nguồn lưu lượng truy cập cụ thể. VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES và NO_LINK_EMBEDDED là một số nguồn lưu lượng truy cập không được hỗ trợ.
10 cụm từ tìm kiếm hàng đầu trên YouTube giúp video thu hút nhiều lưu lượng truy cập nhất
Truy vấn này truy xuất 10 cụm từ tìm kiếm đã tạo ra nhiều lượt xem nhất từ trang kết quả tìm kiếm trên YouTube cho một video hoặc nhóm video cụ thể. Kết quả được sắp xếp theo số lượt xem theo thứ tự giảm dần. Xin lưu ý rằng để chạy truy vấn này trong Trình khám phá API, bạn phải thay thế chuỗi VIDEO_ID trong giá trị tham số filters bằng danh sách được phân tách bằng dấu phẩy gồm tối đa 500 mã video cho các video mà bạn đã tải lên.
dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-viewsTop 10 – Những trang web bên ngoài mang đến nhiều lưu lượng truy cập nhất cho một video
Truy vấn này truy xuất 10 trang web bên ngoài tạo ra nhiều lượt xem nhất từ kết quả tìm kiếm của Google cho một video hoặc nhóm video cụ thể. Kết quả được sắp xếp theo thời gian xem ước tính theo thứ tự giảm dần. Xin lưu ý rằng để chạy truy vấn này trong Trình khám phá API, bạn phải thay thế chuỗi VIDEO_ID trong giá trị tham số filters bằng danh sách được phân tách bằng dấu phẩy gồm tối đa 500 mã video cho các video mà bạn đã tải lên.
dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatchedBáo cáo danh sách phát
Số lượt xem và thời gian xem danh sách phát từ các nguồn lưu lượng truy cập khác nhau ở một quốc gia
Yêu cầu này truy xuất số lượt xem danh sách phát, số lần bắt đầu danh sách phát và thời gian xem ước tính của danh sách phát cho lượt xem danh sách phát ở một quốc gia được chỉ định. Các chỉ số được tổng hợp theo nguồn lưu lượng truy cập, mô tả cách người dùng truy cập vào danh sách phát.
dimensions=insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=country==USSố lượt xem và thời gian xem danh sách phát từ nhiều nguồn lưu lượng truy cập
Yêu cầu này truy xuất số lượt xem danh sách phát, số lần bắt đầu danh sách phát và thời gian xem ước tính của danh sách phát
đối với các danh sách phát thuộc một hoặc nhiều kênh của một chủ sở hữu nội dung. Các chỉ số được tổng hợp theo nguồn lưu lượng truy cập. Xin lưu ý rằng để chạy truy vấn này trong Trình khám phá API, bạn phải thay thế chuỗi CHANNEL_ID trong giá trị tham số filters bằng danh sách được phân tách bằng dấu phẩy gồm tối đa 500 mã kênh cho các kênh của bạn.
dimensions=day,insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_IDBáo cáo video
Chỉ số về loại thiết bị hằng ngày đối với video đã được xác nhận quyền sở hữu
Truy vấn này truy xuất số lượt xem hằng ngày và thời gian xem ước tính theo loại thiết bị đối với những video do một chủ sở hữu nội dung cụ thể xác nhận quyền sở hữu. Kết quả được nhóm theo ngày trên từng loại thiết bị có lượt phát video. Kết quả được sắp xếp theo thứ tự thời gian.
dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed
sort=dayChỉ số hằng ngày về hệ điều hành đối với những video được xác nhận quyền sở hữu được xem trên thiết bị di động
Truy vấn này truy xuất số lượt xem hằng ngày và thời gian xem ước tính theo hệ điều hành đối với số lượt xem video do một chủ sở hữu nội dung cụ thể xác nhận quyền sở hữu diễn ra trên thiết bị di động. Kết quả được nhóm theo ngày cho từng hệ điều hành nơi diễn ra lượt phát video. Các kết quả được sắp xếp theo thứ tự thời gian.
dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed;deviceType==MOBILE
sort=dayChỉ số hằng ngày về hệ điều hành và loại thiết bị
Truy vấn này truy xuất số lượt xem hằng ngày và thời gian xem ước tính của những video do một chủ sở hữu nội dung cụ thể xác nhận quyền sở hữu. Số liệu thống kê được nhóm theo hệ điều hành và loại thiết bị. Các kết quả được sắp xếp theo thứ tự thời gian.
dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=dayBáo cáo danh sách phát
Chỉ số về loại thiết bị cho số lượt xem danh sách phát trên hệ điều hành Android
Truy vấn này truy xuất số lượt xem danh sách phát và thời gian xem ước tính về danh sách phát trên thiết bị Android đối với các danh sách phát thuộc một hoặc nhiều kênh của một chủ sở hữu nội dung. Kết quả được trả về cho từng loại thiết bị mà lượt xem danh sách phát đã xảy ra. Xin lưu ý rằng để chạy truy vấn này trong Trình khám phá API, bạn phải thay thế chuỗi CHANNEL_ID trong giá trị tham số filters bằng danh sách được phân tách bằng dấu phẩy gồm tối đa 500 mã kênh cho các kênh của bạn.
dimensions=deviceType
metrics=playlistViews,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID;operatingSystem==ANDROIDChỉ số hệ điều hành đối với lượt xem danh sách phát trên thiết bị di động
Truy vấn này truy xuất số lượt xem danh sách phát và thời gian xem ước tính của danh sách phát trên thiết bị di động đối với danh sách phát trong bất kỳ kênh nào của chủ sở hữu nội dung. Hệ thống sẽ trả về kết quả cho từng hệ điều hành xảy ra lượt xem danh sách phát.
dimensions=operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILEBáo cáo video
Thông tin nhân khẩu học của người xem ở California (nhóm tuổi và giới tính)
Báo cáo này truy xuất số liệu thống kê về độ tuổi và giới tính của những người xem ở California đã xem nội dung được xác nhận quyền sở hữu của chủ sở hữu nội dung. Kết quả được sắp xếp theo giới tính, sau đó theo nhóm tuổi. Bạn có thể sửa đổi truy vấn này để lấy cùng một số liệu thống kê cho tất cả người xem trên toàn thế giới hoặc cho tất cả người xem ở một quốc gia, châu lục, tiểu lục địa hoặc một tiểu bang khác của Hoa Kỳ bằng cách điều chỉnh giá trị tham số filters.
dimensions=ageGroup,gender
metrics=viewerPercentage
filters=claimedStatus==claimed;province==US-CA
sort=gender,ageGroupChỉ số về việc chia sẻ, tổng hợp theo dịch vụ nơi video được chia sẻ
Yêu cầu này truy xuất số lần người dùng sử dụng nút Share để chia sẻ video do chủ sở hữu nội dung tải lên. Kết quả được tổng hợp theo dịch vụ chia sẻ (Google+, Twitter, v.v.) và sắp xếp theo thứ tự giảm dần về số lượt chia sẻ.
dimensions=sharingService
metrics=shares
filters=uploaderType==self
sort=-sharesChỉ số về tỷ lệ giữ chân người xem của video
Báo cáo này đo lường khả năng giữ chân người xem của một video. Mỗi lần, bạn chỉ có thể truy xuất báo cáo cho một video. Xin lưu ý rằng để chạy truy vấn này trong Trình khám phá API, bạn phải thay thế chuỗi VIDEO_ID trong giá trị tham số filters bằng mã video của một trong những video bạn đã tải lên. Lưu ý rằng báo cáo tỷ lệ giữ chân người xem không hỗ trợ khả năng chỉ định nhiều giá trị cho bộ lọc video.
Trong ví dụ này, báo cáo sử dụng bộ lọc audienceType để hạn chế phản hồi chỉ chứa dữ liệu về lượt xem tự nhiên. Đây là kết quả của một hành động trực tiếp của người dùng, chẳng hạn như tìm kiếm một video hoặc nhấp vào một video được đề xuất. Do đó, báo cáo này không bao gồm dữ liệu về số lượt xem từ quảng cáo TrueView trong luồng hoặc quảng cáo TrueView trong màn hình hiển thị. Bạn có thể xoá bộ lọc này để truy xuất dữ liệu tỷ lệ giữ chân người xem của video từ tất cả các loại đối tượng.
Lưu ý rằng dữ liệu cho bộ lọc audienceType có sẵn từ ngày 25 tháng 9 năm 2013. API sẽ không trả về dữ liệu cho các 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 cụm từ tìm kiếm không sử dụng bộ lọc này sẽ hoạt động cho mọi ngày sau ngày 1 tháng 7 năm 2008.
dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANICChỉ 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
Yêu cầu này truy xuất các chỉ số về doanh thu và hiệu suất quảng cáo cho nội dung mà chủ sở hữu nội dung đã xác nhận quyền sở hữu. Báo cáo này trả về một hàng dữ liệu chứa tổng số cho từng chỉ số được yêu cầu trong phạm vi ngày đã chỉ định.
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimedChỉ số doanh thu hằng ngày và hiệu suất quảng cáo
Yêu cầu này truy xuất chỉ số doanh thu và hiệu suất quảng cáo hằng ngày cho nội dung đã được xác nhận quyền sở hữu của chủ sở hữu nội dung.
dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimedChỉ số doanh thu và hiệu suất quảng cáo theo quốc gia
Yêu cầu này truy xuất các chỉ số về hiệu suất quảng cáo và doanh thu theo quốc gia đối với nội dung được xác nhận quyền sở hữu của chủ sở hữu nội dung. Kết quả được sắp xếp theo thứ tự giảm dần theo số doanh thu, tức là quốc gia đầu tiên được liệt kê sẽ là quốc gia mà đối tác có doanh thu ước tính lớn nhất.
dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
sort=-estimatedRevenueTop 10 – Video có doanh thu cao nhất
Yêu cầu này truy xuất các chỉ số về doanh thu và hiệu suất quảng cáo của 10 video mà chủ sở hữu nội dung đã xác nhận quyền sở hữu và có doanh thu cao nhất. Kết quả được sắp xếp theo thứ tự giảm dần theo số tiền doanh thu, tức là video đầu tiên sẽ là video có doanh thu ước tính cao nhất.
dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
maxResults=10
sort=-estimatedRevenueChỉ số hiệu suất quảng cáo cho nhiều loại quảng cáo
Yêu cầu này truy xuất các chỉ số hiệu suất quảng cáo cho nội dung được xác nhận quyền sở hữu của chủ sở hữu nội dung. Kết quả được nhóm theo loại quảng cáo, cho phép bạn so sánh giá trị doanh thu và CPM giữa các loại quảng cáo.
dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType