Nhật ký sửa đổi

Trang này liệt kê các thay đổi về API và nội dung cập nhật tài liệu cho cả API Báo cáo của YouTube và API YouTube Analytics. Cả hai API này đều cho phép nhà phát triển truy cập vào dữ liệu YouTube Analytics, mặc dù theo những cách khác nhau.

Ngày 30 tháng 10 năm 2026

API Báo cáo của YouTube hiện hỗ trợ các báo cáo do hệ thống quản lý sau đây cho chủ sở hữu nội dung:

Danh mục Tên báo cáo Mã loại báo cáo
Tóm tắt tài chính Tóm tắt các khoản điều chỉnh đối với kênh hằng tháng content_owner_channel_adjustments_summary_a1
Tóm tắt tài chính Doanh thu hằng tháng từ các giao dịch mua tính năng có tính phí content_owner_transactions_paid_features_revenue_a1
Tóm tắt tài chính Doanh thu hằng tháng từ giao dịch TVOD theo tựa đề và quốc gia tvod_content_owner_country_title_tvod_revenue_a1
Tóm tắt tài chính Doanh thu hằng tháng từ giao dịch TVOD theo quốc gia tvod_content_owner_country_transactions_tvod_revenue_a1
Video ngắn Số lượt tạo video ngắn từ tài sản của hãng thu âm hằng tháng music_content_owner_shorts_asset_creations_a1
Video ngắn Số lượt xem hằng tháng đối với tài sản video ngắn của hãng thu âm music_content_owner_shorts_asset_views_a1
Video ngắn Số lượt tạo video ngắn từ tài sản của nhà xuất bản âm nhạc hằng tháng publisher_content_owner_shorts_asset_creations_a1
Video ngắn Số lượt xem hằng tháng đối với tài sản video ngắn của nhà xuất bản âm nhạc publisher_content_owner_shorts_asset_views_a1
Thuế Báo cáo tóm tắt hằng tháng về khoản thuế hoàn lại cho kênh liên kết của MCN content_owner_affiliate_tax_refund_summary_a1
Tài sản Báo cáo SRMF hằng tuần publisher_content_owner_weekly_srmf
Tài sản Báo cáo hằng ngày về trạng thái yêu cầu liên quan đến Kênh nghệ sĩ chính thức content_owner_oac_request_status_a1
Tài sản Báo cáo hằng ngày về chất lượng yêu cầu liên quan đến Kênh nghệ sĩ chính thức content_owner_oac_quality_status_a1

Ngày 13 tháng 9 năm 2026

API Báo cáo của YouTube hiện hỗ trợ Phiên bản 1.1 của báo cáo tệp đối chiếu hằng tuần cho chủ sở hữu nội dung (content_owner_active_references_a2).

Phiên bản 1.1 có những thay đổi sau:

  • Thêm trường status_detail để cung cấp thêm thông tin chi tiết hoặc lý do liên quan đến trạng thái của tệp đối chiếu.
  • Cập nhật trường asset_owners để sử dụng tên hiển thị hoặc mã nhận dạng bên ngoài của chủ sở hữu nội dung thay vì mã đối tác.

Phiên bản trước của báo cáo, Phiên bản 1.0 (content_owner_active_references_a1), vẫn được cung cấp.

Ngày 9 tháng 9 năm 2026

Tài liệu về YouTube Analytics API và API Báo cáo của YouTube đã được cập nhật với những nội dung bổ sung và làm rõ sau đây:

  • SLA về độ mới của dữ liệu và độ trễ: Thêm một phần riêng vào Mô hình dữ liệu để giải thích về độ trễ xử lý dữ liệu từ 48 đến 72 giờ, việc cắt bớt ngày kết thúc thành ngày cuối cùng được xử lý đầy đủ và đề xuất phương thức videos.list của YouTube Data API cho số liệu thống kê về video theo thời gian thực.

  • Chỉ số tiền tệ trong báo cáo kênh: Cập nhật tài liệu uỷ quyền cho báo cáo kênh để làm rõ rằng các chỉ số về doanh thu ước tính và hiệu suất quảng cáo được hỗ trợ cho báo cáo kênh được uỷ quyền trong phạm vi https://www.googleapis.com/auth/yt-analytics-monetary.readonly khi kênh là thành viên của Chương trình Đối tác YouTube (YPP) và các kênh không kiếm tiền sẽ trả về HTTP 403 Forbidden.

  • Các quy tắc ràng buộc về truy vấn và khả năng tương thích của tham số: Thêm một ghi chú tư vấn vào bài viết Tìm hiểu về bảng báo cáo để làm rõ rằng các tổ hợp phương diện, chỉ số và bộ lọc không hợp lệ hoặc loại trừ lẫn nhau sẽ trả về HTTP 400 badRequest ("The query is not supported.").

  • Giá trị phương diện trống trong báo cáo hàng loạt: Cập nhật đặc điểm báo cáo của API Báo cáo của YouTube để giải thích rằng các cột phương diện như video_id hoặc channel_id chứa chuỗi trống để giữ nguyên số liệu tổng hợp cho các tài nguyên đã xoá và để thể hiện các sự kiện ở cấp kênh.

Ngày 27 tháng 8 năm 2026

YouTube sẽ áp dụng cách tính số lượt xem công khai thống nhất cho mọi định dạng video: video dài, sự kiện phát trực tiếp và video Shorts. YouTube sẽ tính lượt xem công khai ngay khi video bắt đầu phát.

Điều kiện tham gia kiếm tiền và phần lớn các chỉ số hiệu suất cốt lõi không bị ảnh hưởng vì vẫn dựa trên các chỉ số tương tác. Thu nhập của nhà sáng tạo vẫn được tính dựa trên "Số lượt xem video Shorts có chủ đích" và "Số giờ xem có chủ đích". Bạn có thể xem các chỉ số này trong YouTube Analytics > Chế độ nâng cao.

Điều kiện tham gia Chương trình Đối tác YouTube không có gì thay đổi. Các yêu cầu tham gia Chương trình Đối tác YouTube giờ đây cũng sẽ được gọi là "số lượt xem video Shorts đủ điều kiện" và "số giờ xem đủ điều kiện" (trước đây là "số lượt xem video Shorts công khai hợp lệ" và "số giờ xem công khai hợp lệ").

Để tìm hiểu thêm, hãy xem bài viết Tìm hiểu hiệu suất nội dung của bạn trên YouTube.

Chỉ số Trạng thái Trigger Dùng cho
Xem Đã cập nhật Video phát từ khung hình đầu tiên (bao gồm cả tính năng tự động phát, di chuột qua và nhấp/nhấn để phát). Số lượt xem công khai thông thường.
Lượt xem được chủ động thực hiện Không thay đổi Video tiếp tục phát sau khung hình đầu tiên hoặc người dùng nhấp/nhấn để phát. Kiếm tiền thông qua Chương trình Đối tác YouTube, hầu hết các số liệu phân tích cốt lõi (tỷ lệ nhấp, thời lượng xem trung bình) và báo cáo về mức độ tương tác.
Lượt hiển thị hình thu nhỏ Không thay đổi Hình thu nhỏ được hiển thị mà không có hoạt động tương tác hoặc tự động phát. Đo lường mức độ hiển thị và đóng gói ở cấp nguồn cấp dữ liệu.

Nội dung cập nhật về tài liệu API: Cập nhật định nghĩa về chỉ số engagedViews trong tài liệu về các chỉ số của YouTube Analytics API và các chỉ số của API Báo cáo của YouTube.

Ngày 25 tháng 6 năm 2026

Tài liệu về YouTube Analytics API (Truy vấn có mục tiêu) đã được cập nhật để xoá báo cáo Hoạt động của người dùng theo thành phố cho chủ sở hữu nội dung. Báo cáo này không được hỗ trợ cho chủ sở hữu nội dung; các truy vấn của chủ sở hữu nội dung về hoạt động của người dùng theo thành phố sẽ trả về kết quả trống.

Ngày 9 tháng 3 năm 2026

Các phương diện ageGroup (YouTube Analytics API) và age_group (API Báo cáo của YouTube) hiện bao gồm cả những người dùng mà YouTube ước tính là dưới 18 tuổi.

Ngày 15 tháng 1 năm 2026

API Báo cáo của YouTube hiện hỗ trợ báo cáo phạm vi tiếp cận cho các kênh và chủ sở hữu nội dung. Báo cáo Phạm vi tiếp cận cung cấp số liệu thống kê về số lượt hiển thị và tỷ lệ nhấp của hình thu nhỏ video.

  • Báo cáo channel_reach_basic_a1 và channel_reach_combined_a1 được cung cấp cho các kênh.
  • Báo cáo content_owner_reach_basic_a1 và content_owner_reach_combined_a1 dành cho chủ sở hữu nội dung.

Các báo cáo này hỗ trợ những chỉ số mới sau:

  • video_thumbnail_impressions
  • video_thumbnail_impressions_ctr

Ngày 22 tháng 9 năm 2025

Thời điểm ngừng cung cấp báo cáo như đã thông báo trước đây đã được dời từ ngày 30 tháng 9 năm 2025 sang ngày 31 tháng 10 năm 2025. Các phiên bản báo cáo trước đây được cập nhật theo thay đổi về cách tính số lượt xem video Shorts sẽ tiếp tục được cung cấp cho đến thời điểm đó, ngoại trừ Báo cáo thông báo xác nhận quyền sở hữu phiên bản 1.0 (content_owner_active_claims_a1) và Báo cáo thông báo xác nhận quyền sở hữu phiên bản 1.1 (content_owner_active_claims_a2) vẫn sẽ ngừng hoạt động từ ngày 30 tháng 9.

Ngày 24 tháng 6 năm 2025

Như đã thông báo vào ngày 26 tháng 3 năm 2025, API Báo cáo hàng loạt sẽ được cập nhật theo thay đổi mới về số lượt xem video ngắn. Chúng tôi đã thực hiện những thay đổi sau:

  • Các phiên bản báo cáo mới đã được tạo cho từng báo cáo có ch��a chế độ xem (chiếm phần lớn các báo cáo). Phiên bản của mỗi báo cáo bị ảnh hưởng đã tăng thêm một, chẳng hạn như phiên bản a2 lên phiên bản a3.
  • Đối với video Shorts, số lượt xem từ nay sẽ là số lần một video Shorts bắt đầu phát hoặc phát lại. Đối với Video, không có thay đổi nào.
  • Báo cáo mới sẽ có một cột mới là engaged_views, phản ánh cách tính số lượt xem trước đây.

Những thay đổi này có hiệu lực từ ngày 30 tháng 6 năm 2025 đối với API báo cáo hàng loạt. Hãy nhớ điều chỉnh quy trình xử lý báo cáo cho phù hợp.

Các phiên bản báo cáo trước đây sẽ được cung cấp cho đến hết ngày 30 tháng 9 năm 2025. Sau ngày 30 tháng 9 năm 2025, các phiên bản trước sẽ ngừng hoạt động. Hãy nhớ di chuyển sang phiên bản mới nhất.

Cuối cùng, hãy nhớ làm theo các phương pháp hay nhất khi xử lý báo cáo để tránh những thay đổi trong tương lai đối với báo cáo làm hỏng quy trình xử lý của bạn.

Các bảng sau đây cho thấy phiên bản báo cáo mới cho từng loại báo cáo:

Báo cáo dữ liệu hàng loạt cho YouTube Analytics

Báo cáo kênh – Báo cáo video
Tên báo cáo Phiên bản trước Phiên bản mới nhất
Hoạt động của người dùng channel_basic_a2 channel_basic_a3
Hoạt động của người dùng theo tỉnh channel_province_a2 channel_province_a3
Vị trí phát channel_playback_location_a2 channel_playback_location_a3
Nguồn lưu lượng truy cập channel_traffic_source_a2 channel_traffic_source_a3
Loại thiết bị và hệ điều hành channel_device_os_a2 channel_device_os_a3
Phụ đề channel_subtitles_a2 channel_subtitles_a3
Kết hợp channel_combined_a2 channel_combined_a3
Báo cáo kênh – Báo cáo danh sách phát
Tên báo cáo Phiên bản trước Phiên bản mới nhất
Hoạt động của người dùng playlist_basic_a1 playlist_basic_a2
Hoạt động của người dùng theo tỉnh playlist_province_a1 playlist_province_a2
Vị trí phát playlist_playback_location_a1 playlist_playback_location_a2
Nguồn lưu lượng truy cập playlist_traffic_source_a1 playlist_traffic_source_a2
Loại thiết bị và hệ điều hành playlist_device_os_a1 playlist_device_os_a2
Kết hợp playlist_combined_a1 playlist_combined_a2
Báo cáo của chủ sở hữu nội dung – Báo cáo video
Tên báo cáo Phiên bản trước Phiên bản mới nhất
Hoạt động của người dùng content_owner_basic_a3 content_owner_basic_a4
Hoạt động của người dùng theo tỉnh content_owner_province_a2 content_owner_province_a3
Vị trí phát content_owner_playback_location_a2 content_owner_playback_location_a3
Nguồn lưu lượng truy cập content_owner_traffic_source_a2 content_owner_traffic_source_a3
Loại thiết bị và hệ điều hành content_owner_device_os_a2 content_owner_device_os_a3
Phụ đề content_owner_subtitles_a2 content_owner_subtitles_a3
Kết hợp content_owner_combined_a2 content_owner_combined_a3
Báo cáo của chủ sở hữu nội dung – Báo cáo danh sách phát
Tên báo cáo Phiên bản trước Phiên bản mới nhất
Hoạt động của người dùng content_owner_playlist_basic_a1 content_owner_playlist_basic_a2
Hoạt động của người dùng theo tỉnh content_owner_playlist_province_a1 content_owner_playlist_province_a2
Vị trí phát content_owner_playlist_playback_location_a1 content_owner_playlist_playback_location_a2
Nguồn lưu lượng truy cập content_owner_playlist_traffic_source_a1 content_owner_playlist_traffic_source_a2
Loại thiết bị và hệ điều hành content_owner_playlist_device_os_a1 content_owner_playlist_device_os_a2
Kết hợp content_owner_playlist_combined_a1 content_owner_playlist_combined_a2
Báo cáo của chủ sở hữu nội dung – Báo cáo thành phần
Tên báo cáo Phiên bản trước Phiên bản mới nhất
Hoạt động của người dùng content_owner_asset_basic_a2 content_owner_asset_basic_a3
Hoạt động của người dùng theo tỉnh content_owner_asset_province_a2 content_owner_asset_province_a3
Vị trí phát video content_owner_asset_playback_location_a2 content_owner_asset_playback_location_a3
Nguồn lưu lượng truy cập content_owner_asset_traffic_source_a2 content_owner_asset_traffic_source_a3
Loại thiết bị và hệ điều hành content_owner_asset_device_os_a2 content_owner_asset_device_os_a3
Kết hợp content_owner_asset_combined_a2 content_owner_asset_combined_a3

Báo cáo do hệ thống quản lý – Tài chính (Không phải âm nhạc)

Báo cáo của chủ sở hữu nội dung – Báo cáo Shorts (không phải video nhạc)
Tên báo cáo Phiên bản trước Phiên bản mới nhất
Tóm tắt doanh thu từ quảng cáo trên toàn cầu content_owner_shorts_global_ad_revenue_summary_a1 content_owner_shorts_global_ad_revenue_summary_a2
Tóm tắt doanh thu từ quảng cáo hằng ngày content_owner_shorts_day_ad_revenue_summary_a1 content_owner_shorts_day_ad_revenue_summary_a2
Tóm tắt doanh thu từ quảng cáo theo quốc gia content_owner_shorts_country_ad_revenue_summary_a1 content_owner_shorts_country_ad_revenue_summary_a2
Tóm tắt doanh thu từ quảng cáo content_owner_shorts_ad_revenue_summary_a1 content_owner_shorts_ad_revenue_summary_a2

Báo cáo do hệ thống quản lý – Phi tài chính

Báo cáo của chủ sở hữu nội dung – Báo cáo thông báo xác nhận quyền sở hữu
Tên báo cáo Phiên bản trước Phiên bản mới nhất
Xác nhận quyền sở hữu hoạt động content_owner_active_claims_a2 content_owner_active_claims_a3
Báo cáo của chủ sở hữu nội dung – Báo cáo siêu dữ liệu video
Tên báo cáo Phiên bản trước Phiên bản mới nhất
Siêu dữ liệu video content_owner_video_metadata_a3 content_owner_video_metadata_a4
Báo cáo của chủ sở hữu nội dung – Báo cáo thành phần
Tên báo cáo Phiên bản trước Phiên bản mới nhất
Thành phần content_owner_asset_a2 content_owner_asset_a3
Xung đột về tài sản content_owner_asset_conflict_a2 content_owner_asset_conflict_a3

Ngày 24 tháng 4 năm 2025

Như đã thông báo vào ngày 26 tháng 3 năm 2025, API Truy vấn có mục tiêu sẽ được cập nhật trong lần thay đổi mới về cách tính số lượt xem video Shorts:

  • Đối với video Shorts, views từ nay sẽ tính số lần một video Shorts bắt đầu phát hoặc phát lại.
  • Chỉ số mới engagedViews sẽ phản ánh phương pháp đếm số lượt xem trước đây. engagedViews sẽ có trong tất cả báo cáo cùng với views.

Những thay đổi này sẽ có hiệu lực từ ngày 30 tháng 4 năm 2025 đối với API Truy vấn có mục tiêu. Hãy nhớ điều chỉnh cụm từ tìm kiếm cho phù hợp.

Hãy xem nhật ký sửa đổi này để biết những thay đổi và thời điểm thay đổi đối với API Báo cáo hàng loạt.

Ngày 22 tháng 4 năm 2025

Như đã thông báo vào ngày 7 tháng 4 năm 2024, phương diện isCurated không còn được dùng cho báo cáo kênh và báo cáo danh sách phát của chủ sở hữu nội dung. Kể từ ngày 31 tháng 12 năm 2024, phương diện này sẽ không còn được hỗ trợ nữa. Phương diện này đã bị xoá khỏi báo cáo và tài liệu.

Ngày 26 tháng 3 năm 2025

Bản cập nhật này có thay đổi sau đây liên quan đến YouTube Analytics và API Báo cáo:

Kể từ ngày 31 tháng 3 năm 2025, YouTube sẽ thay đổi cách tính số lượt xem video Shorts. Trước đây, đối với video Shorts, lượt xem được tính sau khi người dùng phát một video Shorts trong số lượng giây nhất định. Giờ đây, số lượt xem sẽ là số lần video Shorts của bạn bắt đầu phát hoặc phát lại mà không có yêu cầu về thời gian xem tối thiểu. Tìm hiểu thêm

API YouTube Analytics (Truy vấn có mục tiêu) và API Báo cáo (Báo cáo hàng loạt) sẽ được cập nhật những thay đổi sau:

  • Đối với video Shorts, views là số lần một video Shorts bắt đầu phát hoặc phát lại.
  • Chúng tôi sẽ cung cấp một chỉ số mới là engagedViews để phản ánh phương pháp tính số lượt xem trước đây.
  • Nếu sở hữu một kênh hoặc được uỷ quyền truy cập vào dữ liệu của một kênh, bạn sẽ có thể truy vấn cả số liệu lượt xem và lượt xem có chủ đích mới cập nhật.

Truy vấn có mục tiêu sẽ được cập nhật muộn nhất vào ngày 30 tháng 4 và Báo cáo hàng loạt sẽ được cập nhật muộn nhất vào ngày 30 tháng 6. Cho đến lúc đó, số lượt xem sẽ được tính theo phương pháp cũ. Số lượt xem video ngắn và số lượt xem kênh sẽ không khớp với số liệu trong Analytics của Studio.

Ngoài ra, chúng tôi cũng hoãn việc ngừng cung cấp báo cáo Thông báo xác nhận quyền sở hữu hằng ngày (Phiên bản 1.0) như đã thông báo trước đây.

Hãy xem nhật ký sửa đổi này để biết thời điểm các thay đổi được thực hiện đối với API.

Ngày 3 tháng 3 năm 2025

Bản cập nhật này có thay đổi sau đây liên quan đến YouTube Reporting API:

Lưu ý: Đây là thông báo ngừng cung cấp.

Báo cáo Thông báo xác nhận quyền sở hữu hằng ngày (Phiên bản 1.0) đã ngừng hoạt động đối với các đối tác. Chúng tôi sẽ ngừng hỗ trợ tính năng này kể từ ngày 30 tháng 4 năm 2025. Định nghĩa của báo cáo đó đã được cập nhật cho phù hợp. Hãy sử dụng báo cáo Thông báo xác nhận quyền sở hữu hằng ngày mới nhất.

Ngày 15 tháng 11 năm 2024

Lưu ý: Thay đổi sau đây có hiệu lực từ ngày 18 tháng 11 năm 2024.

Tài liệu về API YouTube Analytics (Truy vấn có mục tiêu) đã được cập nhật để lưu ý rằng đối với báo cáo Nguồn lưu lượng truy cập, phương thức reports.query của API hiện sẽ trả về lỗi nếu tích của số lượng video được truy vấn X số ngày trong phạm vi ngày vượt quá 50.000. Ví dụ: một truy vấn truy xuất dữ liệu cho 500 mã video có thể yêu cầu dữ liệu trong tối đa 100 ngày.

Thay đổi này ảnh hưởng đến báo cáo của cả kênh và chủ sở hữu nội dung.

Để giảm số hàng mà một yêu cầu trả về, hãy chia truy vấn của bạn thành nhiều truy vấn chỉ định ít video hơn hoặc đặt phạm vi ngày ngắn hơn. Theo quy tắc, bạn nên dùng báo cáo hàng loạt cho các tập dữ liệu lớn.

Ngày 6 tháng 5 năm 2024

YouTube Analytics API (Truy vấn có mục tiêu) hỗ trợ 3 báo cáo mới cho các kênh:

Ngoài ra, báo cáo Tỷ lệ giữ chân người xem đã được cải tiến để hỗ trợ 3 chỉ số mới:

Ngày 7 tháng 4 năm 2024

API YouTube Analytics (Truy vấn có mục tiêu) có một số nội dung cập nhật liên quan đến báo cáo danh sách phát của chủ sở hữu nội dung. Những thay đổi này giống với những thay đổi liên quan đến báo cáo danh sách phát của kênh, được công bố vào ngày 19 tháng 1 năm 2024.

Mục nhật ký sửa đổi sau đây cung cấp thông tin gần như giống với mục nhật ký ngày 19 tháng 1 năm 2024. Tuy nhiên, xin lưu ý rằng báo cáo danh sách phát của chủ sở hữu nội dung sẽ hỗ trợ phương diện isCurated cho đến hết ngày 31 tháng 12 năm 2024, còn báo cáo danh sách phát của kênh sẽ hỗ trợ phương diện này cho đến hết ngày 30 tháng 6 năm 2024.

  • Lưu ý: Đây là thông báo ngừng cung cấp.

    Phương diện isCurated không còn được dùng cho báo cáo danh sách phát của chủ sở hữu nội dung. Ứng dụng này sẽ không còn được hỗ trợ kể từ ngày 31 tháng 12 năm 2024. Định nghĩa của phương diện đó đã được cập nhật cho phù hợp.

    Để duy trì khả năng tương thích ngược khi xoá phương diện isCurated, bạn cũng phải cập nhật mã để truy xuất chỉ số playlistViews thay vì chỉ số views chỉ cho báo cáo danh sách phát. Vì chỉ số views vẫn được hỗ trợ cho báo cáo danh sách phát, mặc dù có ý nghĩa khác, nên API vẫn sẽ trả về dữ liệu nếu bạn không cập nhật tên chỉ số. Tất nhiên, bạn có thể sửa đổi ứng dụng để truy xuất và hiển thị cả views và playlistViews.

    Ngoài phương diện isCurated, chức năng API sau đây không còn được hỗ trợ trong báo cáo mới:

    • Bộ lọc vị trí, chẳng hạn như continent và subcontinent không được hỗ trợ cho báo cáo danh sách phát mới của kênh.
    • Các chỉ số redViews và estimatedRedMinutesWatched không còn được hỗ trợ cho báo cáo danh sách phát mới của kênh. Những chỉ số này chưa có trong YouTube Studio, nên thay đổi này sẽ giúp chức năng của API phù hợp với chức năng có trong ứng dụng Studio.
    • Phương diện subscribedStatus và youtubeProduct không còn được hỗ trợ làm bộ lọc cho báo cáo danh sách phát của kênh. Những bộ lọc này chưa có trong YouTube Studio, nên thay đổi này sẽ giúp chức năng của API phù hợp với chức năng có trong ứng dụng Studio.

  • Phần báo cáo danh sách phát trong tài liệu báo cáo của chủ sở hữu nội dung đã được cập nhật để giải thích kỹ hơn về các loại chỉ số được hỗ trợ cho báo cáo danh sách phát:

    • Chỉ số tổng hợp về video cung cấp các chỉ số về hoạt động của người dùng và lượt hiển thị được tổng hợp cho tất cả video trong danh sách phát của chủ sở hữu nội dung và cũng thuộc quyền sở hữu của chủ sở hữu nội dung đó. Các chỉ số video tổng hợp chỉ được hỗ trợ cho những yêu cầu API không sử dụng phương diện isCurated.
    • Các chỉ số trong danh sách phát phản ánh hoạt động của người dùng và mức độ tương tác trong trang danh sách phát. Các chỉ số này bao gồm dữ liệu về cả lượt xem của những video không thuộc quyền sở hữu của bạn trong danh sách phát, nhưng chỉ khi những lượt xem đó diễn ra trong danh sách phát.
    • Phần các chỉ số được hỗ trợ cho danh sách phát xác định các chỉ số tổng hợp về video và các chỉ số trong danh sách phát được hỗ trợ cho báo cáo về danh sách phát.

  • Các chỉ số mới sau đây trong danh sách phát được hỗ trợ cho báo cáo danh sách phát của chủ sở hữu nội dung. Xin lưu ý rằng các chỉ số này chỉ được hỗ trợ nếu yêu cầu API để truy xuất báo cáo không sử dụng phương diện isCurated. Hãy xem tài liệu về chỉ số để biết định nghĩa của từng chỉ số:

  • Hành vi của chỉ số views hiện phụ thuộc vào việc yêu cầu API truy xuất báo cáo danh sách phát có sử dụng phương diện isCurated hay không:

    • Khi một yêu cầu bao gồm phương diện isCurated, chỉ số views là chỉ số trong danh sách phát cho biết số lần video được xem trong danh sách phát của chủ sở hữu nội dung.
    • Khi một yêu cầu không bao gồm phương diện isCurated, chỉ số views là chỉ số video tổng hợp cho biết tổng số lần các video trong danh sách phát của chủ sở hữu nội dung được xem, bất kể các lượt xem đó có diễn ra trong bối cảnh danh sách phát hay không. Tổng số lượt xem tổng hợp chỉ bao gồm số lượt xem của những video thuộc quyền sở hữu của chủ sở hữu nội dung liên kết với kênh sở hữu danh sách phát.

      Trong những báo cáo này (không sử dụng phương diện isCurated), chỉ số playlistViews cho biết số lần video được xem trong bối cảnh danh sách phát. Chỉ số này tính số lượt xem của tất cả video trong danh sách phát, bất kể kênh nào sở hữu video.

  • Đối với mỗi báo cáo danh sách phát, tài liệu về báo cáo của chủ sở hữu nội dung hiện có các bảng cho biết những chỉ số được hỗ trợ cho báo cáo đó, tuỳ thuộc vào việc yêu cầu API có chứa phương diện isCurated hay không. Hãy tham khảo phần xác định báo cáo danh sách phát theo thời gian để xem ví dụ.

Ngày 19 tháng 1 năm 2024

API YouTube Analytics (Truy vấn có mục tiêu) có một số nội dung cập nhật liên quan đến báo cáo danh sách phát của kênh. Nội dung cập nhật bao gồm một phương diện không dùng nữa và một số chỉ số mới cũng như chỉ số được cập nhật:

  • Lưu ý: Đây là thông báo ngừng cung cấp.

    Phương diện isCurated không còn được dùng cho báo cáo kênh. Tính năng này sẽ không còn được hỗ trợ kể từ ngày 30 tháng 6 năm 2024. Định nghĩa của phương diện đó đã được cập nhật cho phù hợp.

    Để duy trì khả năng tương thích ngược khi xoá phương diện isCurated, bạn cũng phải cập nhật mã để truy xuất chỉ số playlistViews thay vì chỉ số views chỉ cho báo cáo danh sách phát. Vì chỉ số views vẫn được hỗ trợ cho báo cáo danh sách phát, mặc dù có ý nghĩa khác, nên API vẫn sẽ trả về dữ liệu nếu bạn không cập nhật tên chỉ số. Tất nhiên, bạn có thể sửa đổi ứng dụng của mình để truy xuất và hiển thị cả views và playlistViews.

    Ngoài phương diện isCurated, chức năng API sau đây không còn được hỗ trợ trong báo cáo mới:

    • Bộ lọc vị trí, chẳng hạn như continent và subcontinent không được hỗ trợ cho báo cáo danh sách phát mới của kênh.
    • Các chỉ số redViews và estimatedRedMinutesWatched không còn được hỗ trợ cho báo cáo danh sách phát mới của kênh. Những chỉ số này chưa có trong YouTube Studio, nên thay đổi này sẽ giúp chức năng của API phù hợp với chức năng có trong ứng dụng Studio.
    • Phương diện subscribedStatus và youtubeProduct không còn được hỗ trợ làm bộ lọc cho báo cáo danh sách phát của kênh. Những bộ lọc này chưa có trong YouTube Studio, nên thay đổi này sẽ giúp chức năng của API phù hợp với chức năng có trong ứng dụng Studio.

  • Phần báo cáo danh sách phát trong tài liệu về báo cáo kênh đã được cập nhật để giải thích kỹ hơn về các loại chỉ số được hỗ trợ cho báo cáo danh sách phát:

    • Chỉ số tổng hợp về video cung cấp các chỉ số về hoạt động của người dùng và lượt hiển thị được tổng hợp cho tất cả video trong danh sách phát của kênh mà kênh đó cũng sở hữu. Các chỉ số video tổng hợp chỉ được hỗ trợ cho những yêu cầu API không sử dụng phương diện isCurated.
    • Các chỉ số trong danh sách phát phản ánh hoạt động của người dùng và mức độ tương tác trong trang danh sách phát. Các chỉ số này bao gồm dữ liệu về cả lượt xem của những video không thuộc quyền sở hữu của bạn trong danh sách phát, nhưng chỉ khi những lượt xem đó diễn ra trong danh sách phát.
    • Phần các chỉ số được hỗ trợ cho danh sách phát xác định các chỉ số tổng hợp về video và các chỉ số trong danh sách phát được hỗ trợ cho báo cáo về danh sách phát.

  • Các chỉ số mới sau đây trong danh sách phát được hỗ trợ cho báo cáo danh sách phát của kênh. Những chỉ số này chưa được hỗ trợ cho báo cáo của chủ sở hữu nội dung. Xin lưu ý rằng các chỉ số này chỉ được hỗ trợ nếu yêu cầu API để truy xuất báo cáo không sử dụng phương diện isCurated. Hãy xem tài liệu về chỉ số để biết định nghĩa của từng chỉ số:

  • Hành vi của chỉ số views hiện phụ thuộc vào việc yêu cầu API truy xuất báo cáo danh sách phát có sử dụng phương diện isCurated hay không:

    • Khi một yêu cầu có chứa phương diện isCurated, chỉ số views là một chỉ số trong danh sách phát cho biết số lần video được xem trong bối cảnh danh sách phát của kênh.
    • Khi một yêu cầu không bao gồm phương diện isCurated, chỉ số views là chỉ số video tổng hợp cho biết tổng số lần video trong danh sách phát của kênh được xem, bất kể những lượt xem đó có diễn ra trong bối cảnh danh sách phát hay không. Tổng số lượt xem chỉ bao gồm lượt xem của những video thuộc quyền sở hữu của kênh sở hữu danh sách phát.

      Trong những báo cáo này (không sử dụng phương diện isCurated), chỉ số playlistViews cho biết số lần video được xem trong bối cảnh danh sách phát. Chỉ số này tính số lượt xem của tất cả video trong danh sách phát, bất kể kênh nào sở hữu video.

  • Đối với mỗi báo cáo danh sách phát, tài liệu báo cáo kênh hiện có các bảng cho biết những chỉ số được hỗ trợ cho báo cáo đó, tuỳ thuộc vào việc yêu cầu API có chứa phương diện isCurated hay không. Hãy tham khảo phần xác định báo cáo danh sách phát theo thời gian để xem ví dụ.

Ngày 4 tháng 12 năm 2023

API YouTube Analytics (truy vấn có mục tiêu) đã được cập nhật để hợp nhất hai giá trị phương diện insightTrafficSourceType. Trước đây, phương diện này phân biệt giữa video được phát trong danh sách phát (PLAYLIST) và lượt xem bắt nguồn từ một trang liệt kê tất cả video trong danh sách phát (YT_PLAYLIST_PAGE). Từ nay về sau, cả hai loại lượt xem này sẽ được liên kết với giá trị phương diện PLAYLIST.

Ngày 15 tháng 12 năm 2022

API YouTube Analytics (Truy vấn có mục tiêu) hỗ trợ hai phương diện mới và một báo cáo mới:

  • Một báo cáo mới cung cấp thông tin về hoạt động của người dùng theo thành phố. Báo cáo này dành cho kênh và chủ sở hữu nội dung. Báo cáo này chứa phương diện city mới, giúp xác định thành phố mà YouTube ước tính là nơi diễn ra hoạt động của người dùng.

  • Phương diện creatorContentType mới xác định loại nội dung trên YouTube liên quan đến các chỉ số về hoạt động của người dùng trong hàng dữ liệu. Các giá trị được hỗ trợ là LIVE_STREAM, SHORTS, STORY và VIDEO_ON_DEMAND.

    Phương diện creatorContentType được hỗ trợ dưới dạng phương diện không bắt buộc cho tất cả báo cáo video của kênh và chủ sở hữu nội dung.

  • Hướng dẫn về yêu cầu mẫu của YouTube Analytics API hiện có các ví dụ cho cả hai phương diện mới.

  • Nội dung tham chiếu đến các phương diện 7DayTotals và 30DayTotals đã bị xoá khỏi tài liệu. Chúng tôi đã thông báo về việc ngừng sử dụng các phương diện này vào tháng 10 năm 2019.

Ngày 26 tháng 8 năm 2022

YouTube Analytics API (Truy vấn có mục tiêu) và API Báo cáo của YouTube (Báo cáo hàng loạt) đều hỗ trợ một giá trị mới cho thông tin chi tiết về nguồn lưu lượng truy cập:

  • Trong YouTube Analytics API (Truy vấn có mục tiêu), nếu giá trị của phương diện insightTrafficSourceType là SUBSCRIBER, thì giá trị của insightTrafficSourceDetail có thể được đặt thành podcasts, cho biết rằng lưu lượng truy cập được giới thiệu từ trang đích Podcast.
  • Trong YouTube Reporting (Báo cáo hàng loạt) API, nếu giá trị của phương diện traffic_source_type là 3, thì giá trị traffic_source_detail có thể được đặt thành podcasts, cho biết rằng lưu lượng truy cập được giới thiệu từ trang đích Podcast.

Ngày 11 tháng 2 năm 2022

Tập hợp các giá trị hợp lệ cho phương diện gender sẽ thay đổi từ ngày 11 tháng 8 năm 2022. Đây có thể là một thay đổi không có khả năng tương thích ngược trong quá trình triển khai API. Để tuân thủ phần Thay đổi không tương thích ngược trong Điều khoản dịch vụ của Các dịch vụ API YouTube, chúng tôi thông báo về thay đổi này sáu tháng trước khi thay đổi có hiệu lực. Vui lòng cập nhật cách triển khai API của bạn trước ngày 11 tháng 8 năm 2022 để đảm bảo quá trình chuyển đổi sang nhóm giá trị mới diễn ra suôn sẻ.

Sau đây là những thay đổi cụ thể:

  • Trong YouTube Analytics (API truy vấn có mục ti��u), phương diện gender hiện hỗ trợ hai giá trị: female và male. Kể từ ngày 11 tháng 8 năm 2022, phương diện đó sẽ hỗ trợ 3 giá trị: female, male và user_specified.
  • Trong API Báo cáo của YouTube (Báo cáo hàng loạt), phương diện gender hiện hỗ trợ 3 giá trị: FEMALE, MALE và GENDER_OTHER. Kể từ ngày 11 tháng 8 năm 2022, tập hợp các giá trị được hỗ trợ sẽ thay đổi thành FEMALE, MALE và USER_SPECIFIED.

Ngày 9 tháng 2 năm 2022

Hai chỉ số đã được cập nhật để loại trừ lưu lượng truy cập từ đoạn video lặp lại kể từ ngày 13 tháng 12 năm 2021. Thay đổi này ảnh hưởng đến cả API YouTube Analytics (Truy vấn có mục tiêu) và API Báo cáo của YouTube (Báo cáo hàng loạt).

Ngày 2 tháng 2 năm 2022

API YouTube Reporting (Báo cáo hàng loạt) hỗ trợ một giá trị mới cho phương diện nguồn lưu lượng truy cập, cho biết rằng lượt xem bắt nguồn từ tính năng Live Redirect:

  • Trong API Báo cáo của YouTube (Báo cáo hàng loạt), phương diện traffic_source_type hỗ trợ giá trị 28.

Đối với loại nguồn lưu lượng truy cập này, phương diện traffic_source_detail cho biết mã nhận dạng kênh đã giới thiệu người xem.

Ngày 23 tháng 9 năm 2020

Cả YouTube Analytics API (Truy vấn có mục tiêu) và API Báo cáo của YouTube (Báo cáo hàng loạt) đều hỗ trợ một giá trị phương diện nguồn lưu lượng truy cập mới, cho biết rằng người xem đã được giới thiệu bằng cách vuốt dọc trong trải nghiệm xem YouTube Shorts:

  • Trong YouTube Analytics API (Truy vấn có mục tiêu), phương diện insightTrafficSourceType hỗ trợ giá trị SHORTS.
  • Trong API Báo cáo của YouTube (Báo cáo hàng loạt), phương diện traffic_source_type hỗ trợ giá trị 24.

Phương diện chi tiết về nguồn lưu lượng truy cập (insightTrafficSourceDetail trong YouTube Analytics API hoặc traffic_source_detail trong API Báo cáo của YouTube) không được điền sẵn cho loại nguồn lưu lượng truy cập mới này.

Ngày 20 tháng 7 năm 2020

Nội dung cập nhật này bao gồm hai thay đổi ảnh hưởng đến YouTube Analytics (truy vấn có mục tiêu) API:

  • Quy mô tối đa của một nhóm báo cáo trong YouTube Analytics đã tăng từ 200 lên 500 thực thể.
  • Tham số filters của phương thức reports.query xác định danh sách các bộ lọc cần áp dụng khi truy xuất dữ liệu YouTube Analytics. Tham số này hỗ trợ khả năng chỉ định nhiều giá trị cho các bộ lọc video, playlist và channel, đồng thời số lượng mã nhận dạng tối đa có thể chỉ định cho các bộ lọc đó đã tăng từ 200 lên 500 mã nhận dạng.

Ngày 13 tháng 2 năm 2020

Nội dung cập nhật này bao gồm những thay đổi sau đây liên quan đến API YouTube Analytics (Truy vấn có mục tiêu) và API Báo cáo của YouTube (Báo cáo hàng loạt). Bạn có thể tìm hiểu thêm về những thay đổi này trong Trung tâm trợ giúp của YouTube.

Trong cả hai API, tập hợp các giá trị chi tiết có thể có về nguồn lưu lượng truy cập cho thông báo đang thay đổi. Trong truy vấn có mục tiêu, thông báo được báo cáo là insightTrafficSourceType=NOTIFICATION. Trong báo cáo hàng loạt, thông báo được báo cáo là traffic_source_type=17.

Các giá trị mới chia thông báo liên quan đến video đã tải lên và sự kiện phát trực tiếp (trước đây được báo cáo là uploaded) thành hai danh mục:

  • uploaded_push – Số lượt xem bắt nguồn từ thông báo đẩy được gửi đến người đăng ký khi video được tải lên
  • uploaded_other – Số lượt xem bắt nguồn từ thông báo không phải thông báo đẩy, chẳng hạn như thông báo qua email hoặc thông báo trong hộp thư đến, được gửi đến người đăng ký khi một video được tải lên.

Các giá trị này được trả về cho phạm vi thời gian bắt đầu từ ngày 13 tháng 1 năm 2020.

Ngoài ra, xin lưu ý rằng những giá trị này không đại diện cho chính thông báo, mà đại diện cho các nguồn lưu lượng truy cập đã thúc đẩy một số lượt xem nhất định trên YouTube. Ví dụ: nếu một hàng trong báo cáo cho biết views=3, traffic_source_type=17 (NOTIFICATION) và traffic_source_detail=uploaded_push, thì hàng đó cho biết rằng có 3 lượt xem bắt nguồn từ việc người xem nhấp vào thông báo đẩy được gửi khi video được tải lên.

Ngày 15 tháng 10 năm 2019

Bản cập nhật này có những thay đổi sau đây liên quan đến API YouTube Analytics (Truy vấn có mục tiêu):

  • Lưu ý: Đây là thông báo ngừng cung cấp.

    YouTube sẽ ngừng hỗ trợ các phương diện 7DayTotals và 30DayTotals. Bạn vẫn có thể truy xuất dữ liệu bằng các phương diện đó cho đến hết ngày 15 tháng 4 năm 2020. Kể từ ngày đó, mọi nỗ lực truy xuất báo cáo bằng phương diện 7DayTotals hoặc 30DayTotals sẽ trả về lỗi.

    Xin lưu ý rằng người dùng có thể tái tạo một số dữ liệu cho các phương diện này bằng cách truy vấn bằng phương diện day và tổng hợp hoặc lấy dữ liệu trong khoảng thời gian 7 hoặc 30 ngày. Ví dụ:

    • Bạn có thể tính số lượt xem trong khoảng thời gian 7 ngày bằng cách cộng số lượt xem của từng ngày trong khoảng thời gian đó.
    • Bạn có thể tính viewerPercentage cho khoảng thời gian 7 ngày bằng cách nhân số lượt xem mỗi ngày với viewerPercentage của ngày đó để biết số người xem đã đăng nhập khi xem video vào ngày đó. Sau đó, bạn có thể cộng số người xem đã đăng nhập trong toàn bộ khoảng thời gian rồi chia cho tổng số lượt xem trong khoảng thời gian đó để có được viewerPercentage cho toàn bộ khoảng thời gian.
    • Không thể tính số người xem riêng biệt trong khoảng thời gian 7 ngày vì cùng một người xem có thể được tính là người xem riêng biệt vào những ngày khác nhau. Tuy nhiên, bạn có thể sử dụng phương diện month thay vì phương diện 30DayTotals để ngoại suy dữ liệu về số người xem riêng biệt trong khoảng thời gian 30 ngày. Xin lưu ý rằng phương diện month đề cập đến tháng dương lịch, trong khi phương diện 30DayTotals tính khoảng thời gian 30 ngày dựa trên ngày bắt đầu và ngày kết thúc được chỉ định.

Ngày 27 tháng 6 năm 2019

Bản cập nhật này có những thay đổi sau đây liên quan đến YouTube Analytics (truy vấn có mục tiêu) API:

  • Vì phiên bản 1 của API hiện đã ngừng hoạt động hoàn toàn, nên tài liệu đã được cập nhật để xoá các thông tin tham chiếu đến phiên bản đó, bao gồm cả thông báo ngừng hoạt động và hướng dẫn di chuyển giải thích cách cập nhật lên phiên bản 2.

Ngày 1 tháng 11 năm 2018

Bản cập nhật này có những thay đổi sau đây liên quan đến YouTube Analytics (truy vấn có mục tiêu) API:

  • Phiên bản 1 của API hiện không còn được dùng nữa. Nếu bạn chưa làm, vui lòng cập nhật ứng dụng API của bạn để sử dụng phiên bản 2 của API càng sớm càng tốt nhằm giảm thiểu tình trạng gián đoạn dịch vụ. Xem hướng dẫn di chuyển để biết thêm thông tin chi tiết.

    Xin lưu ý rằng lịch trình ngừng sử dụng này ban đầu được thông báo vào ngày 26 tháng 4 năm 2018.

Ngày 17 tháng 9 năm 2018

Bản cập nhật này có những thay đổi sau đây liên quan đến API YouTube Analytics (Truy vấn có mục tiêu):

  • Mục mới về tính năng ẩn danh dữ liệu trong tài liệu tổng quan về Mô hình dữ liệu giải thích rằng một số dữ liệu trong YouTube Analytics bị giới hạn khi các chỉ số không đạt một ngưỡng nhất định. Điều này có thể xảy ra trong nhiều trường hợp. Trên thực tế, điều này có nghĩa là một báo cáo có thể không chứa tất cả (hoặc bất kỳ) dữ liệu nào của bạn nếu:

    1. video hoặc kênh có lưu lượng truy cập bị giới hạn trong một khoảng thời gian cụ thể,

      hoặc

    2. bạn đã chọn một bộ lọc hoặc phương diện (chẳng hạn như nguồn lưu lượng truy cập hoặc quốc gia) có những giá trị không đáp ứng một ngưỡng nhất định.

    Phần mới này cũng thảo luận về các loại dữ liệu có thể bị giới hạn trong báo cáo của YouTube Analytics.

  • Tài liệu về báo cáo kênh và báo cáo chủ sở hữu nội dung đã được cập nhật để phản ánh việc các chỉ số redViews và estimatedRedMinutesWatched không còn được hỗ trợ cho báo cáo về vị trí phát, nguồn lưu lượng truy cập và loại thiết bị/hệ điều hành.

Ngày 18 tháng 6 năm 2018

Bản cập nhật này có những thay đổi sau đối với YouTube Analytics (truy vấn có mục tiêu) API:

  • Yêu cầu về phạm vi cho các phương thức sau đã thay đổi:
    • Yêu cầu đối với phương thức reports.query phải có quyền truy cập vào phạm vi https://www.googleapis.com/auth/youtube.readonly.
    • Yêu cầu đối với phương thức groupItems.list phải có quyền truy cập vào:
      • phạm vi https://www.googleapis.com/auth/youtube
        hoặc
      • phạm vi https://www.googleapis.com/auth/youtube.readonly
        và
        phạm vi https://www.googleapis.com/auth/yt-analytics.readonly

      Lựa chọn đầu tiên sử dụng một phạm vi, đó là phạm vi đọc-ghi, còn lựa chọn thứ hai sử dụng hai phạm vi chỉ đọc.

Ngày 23 tháng 5 năm 2018

Bản cập nhật này có những thay đổi sau đối với YouTube Analytics (truy vấn có mục tiêu) API:

  • Tổng quan về API có một phần mới là chỉ số tổng hợp và mục đã xoá. Phần này giải thích cách phản hồi của API xử lý dữ liệu liên quan đến các tài nguyên đã xoá, chẳng hạn như video, danh sách phát hoặc kênh.
  • Mục các phương pháp hay nhất trong phần Tổng quan về API đã được cập nhật để nhắc bạn rằng bạn có thể sử dụng YouTube Data API để truy xuất siêu dữ liệu bổ sung cho các tài nguyên được xác định trong phản hồi của API YouTube Analytics. Như đã nêu trong Chính sách dành cho nhà phát triển của Các dịch vụ API YouTube (mục III.E.4.b đến III.E.4.d), ứng dụng API phải xoá hoặc làm mới siêu dữ liệu của tài nguyên được lưu trữ từ API đó sau 30 ngày.

Ngày 22 tháng 5 năm 2018

Bản cập nhật này có những thay đổi sau đây liên quan đến API Báo cáo của YouTube (Báo cáo hàng loạt):

  • Những thay đổi sau đây dự kiến sẽ có hiệu lực vào tháng 7 năm 2018 và các chính sách mới sẽ áp dụng trên toàn cầu cho tất cả báo cáo và công việc báo cáo.

    • Sau khi thay đổi, hầu hết các báo cáo API (bao gồm cả báo cáo lấp đầy) sẽ được cung cấp trong vòng 60 ngày kể từ thời điểm tạo. Tuy nhiên, các báo cáo chứa dữ liệu trong quá khứ sẽ được cung cấp trong vòng 30 ngày kể từ lúc tạo.

      Trước thông báo này, tất cả báo cáo API đều được cung cấp trong vòng 180 ngày kể từ lúc tạo. Xin lưu ý rằng khi thay đổi này về chính sách có hiệu lực, bạn cũng sẽ không thể truy cập vào các báo cáo có dữ liệu trong quá khứ đã quá 30 ngày thông qua API. Tất cả các báo cáo khác đã quá 60 ngày cũng sẽ không còn truy cập được nữa. Do đó, tài liệu hiện nêu rõ rằng các báo cáo được tạo trước khi chính sách thay đổi sẽ được cung cấp trong tối đa 180 ngày.

    • Sau khi thay đổi, khi bạn lên lịch cho một công việc báo cáo, YouTube sẽ tạo báo cáo từ ngày đó trở đi và bao gồm khoảng thời gian 30 ngày trước thời điểm công việc được lên lịch. Trước khi thay đổi, khi bạn lên lịch cho một công việc báo cáo, YouTube sẽ tạo báo cáo trong khoảng thời gian 180 ngày trước thời điểm công việc đó được lên lịch.

  • Phần các phương pháp hay nhất đã được cập nhật để nhắc bạn rằng bạn có thể sử dụng YouTube Data API để truy xuất siêu dữ liệu bổ sung cho các tài nguyên được xác định trong báo cáo. Như đã nêu trong Chính sách dành cho nhà phát triển của Các dịch vụ API YouTube (mục III.E.4.b đến III.E.4.d), ứng dụng API phải xoá hoặc làm mới siêu dữ liệu của tài nguyên được lưu trữ từ API đó sau 30 ngày.

  • Mục Đặc điểm của báo cáo đã được cập nhật để lưu ý rằng mặc dù dữ liệu báo cáo không được lọc, nhưng những báo cáo chứa dữ liệu trong khoảng thời gian từ ngày 1 tháng 6 năm 2018 trở đi sẽ không chứa bất kỳ thông tin tham chiếu nào đến các tài nguyên trên YouTube đã bị xoá ít nhất 30 ngày trước ngày tạo báo cáo.

  • Phần dữ liệu trong quá khứ của thông tin tổng quan về API đã được cập nhật để lưu ý rằng khi bạn lên lịch cho một công việc báo cáo mới, các báo cáo trong quá khứ thường được đăng trong vòng vài ngày. Trước đây, tài liệu cho biết có thể mất đến 30 ngày thì các báo cáo như vậy mới có sẵn.

  • Phần dữ liệu bổ sung trong thông tin tổng quan về API đã được cập nhật để xác định rõ hơn dữ liệu bổ sung là một tập dữ liệu thay thế cho một tập dữ liệu đã được phân phối trước đó.

Ngày 26 tháng 4 năm 2018

Phiên bản 2 của API YouTube Analytics (Truy vấn có mục tiêu) (phiên bản 2) hiện đã được cung cấp công khai. Danh sách sau đây xác định các thay đổi về sản phẩm và tài liệu liên quan đến phiên bản API mới:

  • API của v2 gần như giống hệt API của v1. Tuy nhiên, có thể bạn sẽ cần cập nhật mã để phản ánh những thay đổi được liệt kê bên dưới. Tất cả những thay đổi này đều được giải thích chi tiết trong hướng dẫn di chuyển mới.

    • Phiên bản của API đã thay đổi từ v1 thành v2.
    • URL cơ sở cho các yêu cầu API đã thay đổi từ https://www.googleapis.com/youtube/analytics/v1 thành https://youtubeanalytics.googleapis.com/v2.
    • Một số tham số cho phương thức reports.query đã được cập nhật tên. Cụ thể, tên tham số chứa dấu gạch nối, chẳng hạn như end-date trong API phiên bản 1, sẽ sử dụng kiểu viết lạc đà (endDate) thay vì dấu gạch nối trong API phiên bản 2. Thay đổi này giúp tên tham số nhất quán trong toàn bộ API vì các phương thức của API để tạo và quản lý nhóm đã sử dụng kiểu viết lạc đà cho tên tham số.
    • API phiên bản 2 không hỗ trợ các yêu cầu theo lô được gửi đến điểm cuối HTTP theo lô chung của Google (www.googleapis.com/batch). Nếu đang gửi yêu cầu theo lô trong API phiên bản 2, bạn cần sử dụng điểm cuối https://youtubeanalytics.googleapis.com/v2.

    Ngoài ra, một số tính năng của phiên bản 1 không được hỗ trợ trong API phiên bản 2:

    • Phương thức reports.query không còn hỗ trợ các tham số yêu cầu alt, quotaUser và userIp.
    • API phiên bản 2 không cung cấp điểm cuối theo lô hỗ trợ các lô bao gồm yêu cầu đến nhiều API. (Tuy nhiên, một lô có thể bao gồm các yêu cầu đối với nhiều phương thức của cùng một API.) Việc ngừng sử dụng này không chỉ áp dụng cho API YouTube Analytics, vì Google đang ngừng sử dụng điểm cuối theo lô chung trên tất cả các API của mình.
    • API phiên bản 2 không hỗ trợ giao thức JSON-RPC (giao thức được hỗ trợ trong API phiên bản 1). Xin nhắc lại, việc ngừng sử dụng này không chỉ áp dụng cho YouTube Analytics API.

  • Lưu ý: Đây là thông báo ngừng cung cấp.

    Phiên bản 1 của API (v1) hiện không còn được dùng nữa và sẽ được hỗ trợ đến hết ngày 31 tháng 10 năm 2018. Mọi yêu cầu gửi đến API phiên bản 1 sẽ ngừng hoạt động sau ngày đó. Do đó, hãy nhớ nâng cấp lên API phiên bản 2 chậm nhất là ngày 31 tháng 10 năm 2018 để tránh bị gián đoạn khi truy cập vào dữ liệu YouTube Analytics thông qua API.

Ngày 21 tháng 2 năm 2018

Bản cập nhật này có những thay đổi sau đối với YouTube Analytics (truy vấn có mục tiêu) API:

  • Báo cáo nhân khẩu học của người xem (tổng hợp số liệu thống kê về lượt xem dựa trên nhóm tuổi và giới tính của người xem) không còn hỗ trợ phương diện youtubeProduct (xác định dịch vụ YouTube nơi hoạt động của người dùng diễn ra).

Ngày 18 tháng 1 năm 2018

Bản cập nhật này có những thay đổi sau:

  • YouTube Reporting API (Báo cáo hàng loạt)

    • Phương diện operating_system (xác định hệ thống phần mềm của thiết bị mà lượt xem diễn ra) hiện hỗ trợ giá trị sau:
      • 25: KaiOS

  • YouTube Analytics API (Truy vấn có mục tiêu)

    • Phương diện operatingSystem hỗ trợ giá trị phương diện KAIOS.

Ngày 20 tháng 12 năm 2017

Bản cập nhật này có hai thay đổi liên quan đến API Báo cáo của YouTube:

  • Máy chủ API hiện hỗ trợ tính năng nén gzip cho các yêu cầu tải báo cáo xuống. Xin lưu ý rằng tính năng nén gzip không được hỗ trợ cho các loại yêu cầu API khác. Việc bật tính năng nén gzip sẽ giảm băng thông cần thiết cho mỗi phản hồi của API. Mặc dù ứng dụng của bạn sẽ cần thêm thời gian của CPU để giải nén phản hồi của API, nhưng lợi ích của việc tiêu thụ ít tài nguyên mạng hơn thường lớn hơn chi phí đó.

    Để nhận được phản hồi được mã ho�� sau khi nén gzip, hãy đặt tiêu đề của yêu cầu HTTP Accept-Encoding thành gzip như trong ví dụ sau:

    Accept-Encoding: gzip

    Chức năng này được giải thích trong phần Tổng quan về API và trong định nghĩa về thuộc tính downloadUrl của tài nguyên report.

  • Tài liệu về phương diện age group và gender đã được chỉnh sửa để cho thấy các giá trị thực tế mà API trả về cho các phương diện đó. Xin lưu ý rằng đây là nội dung chỉnh sửa tài liệu và không phản ánh thay đổi về chức năng hoặc hành vi của API. Cụ thể, các giá trị sau đã thay đổi:

    • Giá trị cho phương diện age_group sử dụng chữ in hoa, chứa dấu gạch dưới giữa từ AGE và các số trong nhóm tuổi, đồng thời sử dụng dấu gạch dưới thay vì dấu gạch nối. Do đó, các giá trị như age13-17 và age18-24 đã được điều chỉnh tương ứng thành AGE_13_17 và AGE_18_24.
    • Giá trị cho phương diện gender sử dụng chữ in hoa. Do đó, các giá trị female, male và gender_other đã được sửa thành FEMALE, MALE và GENDER_OTHER.

Ngày 10 tháng 8 năm 2017

Vào ngày 10 tháng 8 năm 2016, tài liệu này đã thông báo về việc ngừng sử dụng chỉ số earnings của API YouTube Analytics. (Đồng thời, API này cũng hỗ trợ một chỉ số mới có tên là estimatedRevenue, cung cấp cùng một dữ liệu.)

Vì chỉ số earnings là một chỉ số chính, nên chỉ số này được hỗ trợ trong một năm kể từ ngày thông báo. Tuy nhiên, vì khoảng thời gian một năm đó đã kết thúc, nên chỉ số earnings không còn được hỗ trợ nữa. Do đó, các yêu cầu API chỉ định chỉ số earnings hiện sẽ trả về mã phản hồi HTTP 400. Nếu bạn chưa cập nhật ứng dụng để sử dụng chỉ số estimatedRevenue thay vì chỉ số earnings, vui lòng cập nhật sớm nhất có thể.

Tài liệu về API đã được cập nhật để xoá các thông tin tham chiếu còn lại đến chỉ số earnings.

Ngày 6 tháng 7 năm 2017

Bản cập nhật này có những thay đổi sau:

  • YouTube Analytics API (Truy vấn có mục tiêu)

    • Tài liệu về API đã được cập nhật để phản ánh rằng phản hồi của API chứa dữ liệu cho đến ngày cuối cùng trong ph��m vi ngày được yêu cầu mà t��t c�� ch�� số đang được truy vấn đều có sẵn.

      Ví dụ: nếu một yêu cầu chỉ định ngày kết thúc là ngày 5 tháng 7 năm 2017 và giá trị cho tất cả các chỉ số được yêu cầu chỉ có sẵn đến ngày 3 tháng 7 năm 2017, thì đó sẽ là ngày cuối cùng mà dữ liệu được đưa vào phản hồi. (Điều này đúng ngay cả khi dữ liệu cho một số chỉ số được yêu cầu có sẵn cho ngày 4 tháng 7 năm 2017.)

    • Phương diện adType hiện hỗ trợ giá trị reservedBumperInstream, tức là quảng cáo dạng video không thể bỏ qua, dài tối đa 6 giây và phát trước khi người dùng có thể xem video. Định dạng quảng cáo này giống hệt với quảng cáo auctionBumperInstream, nhưng loại này đề cập đến quảng cáo được bán theo hình thức đặt trước thay vì đấu giá.

  • YouTube Reporting API (Báo cáo hàng loạt)

    • Phương diện ad_type hiện hỗ trợ giá trị 20, tức là quảng cáo đệm được bán theo hình thức đặt trước. Quảng cáo đệm là quảng cáo dạng video không thể bỏ qua, có thời lượng tối đa 6 giây và phát trước khi người xem có thể xem video. Xin lưu ý rằng giá trị 19 cho phương diện này cũng đề cập đến quảng cáo đệm được bán theo hình thức đấu giá thay vì đặt trước.

    • Các công việc báo cáo cho những báo cáo sau đây của API Báo cáo YouTube đã bị xoá:

      • channel_basic_a1
      • channel_province_a1
      • channel_playback_location_a1
      • channel_traffic_source_a1
      • channel_device_os_a1
      • channel_subtitles_a1
      • channel_combined_a1
      • content_owner_basic_a2
      • content_owner_province_a1
      • content_owner_playback_location_a1
      • content_owner_traffic_source_a1
      • content_owner_device_os_a1
      • content_owner_subtitles_a1
      • content_owner_combined_a1
      • content_owner_asset_basic_a1
      • content_owner_asset_province_a1
      • content_owner_asset_playback_location_a1
      • content_owner_asset_traffic_source_a1
      • content_owner_asset_device_os_a1
      • content_owner_asset_combined_a1

      Các loại báo cáo này đã được thông báo là ngừng hoạt động vào ngày 15 tháng 9 năm 2016 và báo cáo không còn được tạo cho các loại báo cáo đó sau ngày 15 tháng 12 năm 2016. Các báo cáo được tạo trước đây vẫn có sẵn trong vòng 180 ngày kể từ thời điểm tạo. Do đó, một số báo cáo có thể truy cập được muộn nhất vào ngày 15 tháng 6 năm 2017. Tuy nhiên, vì các báo cáo không còn nữa, nên bạn cũng không cần các công việc liên quan đến báo cáo.

Ngày 24 tháng 5 năm 2017

Tất cả công việc báo cáo cho các báo cáo sau đây của API Báo cáo YouTube đã bị xoá:

  • content_owner_ad_performance_a1
  • content_owner_asset_estimated_earnings_a1
  • content_owner_estimated_earnings_a1

Các loại báo cáo này đã được thông báo là ngừng hoạt động vào ngày 22 tháng 6 năm 2016 và báo cáo không còn được tạo cho các loại báo cáo đó sau ngày 22 tháng 9 năm 2016. Các báo cáo được tạo trước đây vẫn có sẵn trong vòng 180 ngày kể từ thời điểm tạo. Do đó, một số báo cáo có thể truy cập được muộn nhất vào ngày 22 tháng 3 năm 2017. Tuy nhiên, vì các báo cáo không còn nữa, nên bạn cũng không cần các công việc liên quan đến báo cáo.

Ngày 22 tháng 5 năm 2017

Bản cập nhật này có những thay đổi sau:

  • YouTube Reporting API (Báo cáo hàng loạt)

    • Phương diện sharing_service (giúp xác định dịch vụ được dùng để chia sẻ video) hiện hỗ trợ các giá trị sau:
      • 85: YouTube Music
      • 86: YouTube Gaming
      • 87: YouTube Kids
      • 88: YouTube TV

      Ngoài ra, tên dùng để xác định giá trị 52 đã được cập nhật trong tài liệu thành Kakao (Kakao Talk) để phân biệt rõ hơn với giá trị 73 (Kakao Story). Thay đổi này không phản ánh bất kỳ thay đổi nào về hành vi của API hoặc cách phân loại video được chia sẻ với các dịch vụ này.

  • YouTube Analytics API (Truy vấn có mục tiêu)

    • Phương diện sharingService hiện hỗ trợ các giá trị sau:
      • YOUTUBE_GAMING
      • YOUTUBE_KIDS
      • YOUTUBE_MUSIC
      • YOUTUBE_TV

Ngày 28 tháng 3 năm 2017

Những chủ sở hữu kênh có thể truy cập vào dữ liệu doanh thu thông qua YouTube Analytics trong Creator Studio giờ đây cũng có thể truy cập vào dữ liệu doanh thu đó thông qua YouTube Analytics API:

Ngày 17 tháng 3 năm 2017

Bản cập nhật này có những thay đổi sau:

Ngày 3 tháng 3 năm 2017

Bản cập nhật này có những thay đổi sau:

  • YouTube Reporting API (Báo cáo hàng loạt)

    • Định nghĩa về phương diện date đã được điều chỉnh để lưu ý rằng giá trị phương diện đề cập đến khoảng thời gian bắt đầu từ 12:00 sáng giờ Thái Bình Dương và kết thúc lúc 11:59 tối giờ Thái Bình Dương vào ngày, tháng và năm được chỉ định. Tuỳ thuộc vào thời điểm trong năm, giờ Thái Bình Dương là UTC-7 hoặc UTC-8.

      Mặc dù ngày thường đại diện cho khoảng thời gian 24 giờ, nhưng ngày mà đồng hồ được điều chỉnh tiến lên đại diện cho khoảng thời gian 23 giờ và ngày mà đồng hồ được điều chỉnh lùi lại đại diện cho khoảng thời gian 25 giờ. (Trước đây, tài liệu nêu rõ rằng mỗi ngày đại diện cho một khoảng thời gian 24 giờ riêng biệt và giờ Thái Bình Dương luôn là UTC-8.)

      Xin lưu ý rằng nội dung chỉnh sửa này không thể hiện sự thay đổi trong hành vi thực tế của API.

    • Phương diện operating_system (xác định hệ thống phần mềm của thiết bị mà lượt xem diễn ra) hiện hỗ trợ các giá trị sau:
      • 22: Tizen
      • 23: Firefox
      • 24: RealMedia

    • Tất cả các tác vụ báo cáo cho loại báo cáo content_owner_basic_a1 đã bị xoá. Loại báo cáo đó đã ngừng hoạt động hoàn toàn kể từ ngày 19 tháng 8 năm 2016, nhưng các báo cáo content_owner_basic_a1 được tạo trước đó vẫn được cung cấp trong vòng 180 ngày kể từ lúc tạo. Do đó, một số báo cáo có thể truy cập được muộn nhất là ngày 19 tháng 2 năm 2017. Tuy nhiên, vì các báo cáo không còn nữa, nên bạn cũng không cần các công việc liên quan đến báo cáo.

  • YouTube Analytics API (Truy vấn có mục tiêu)

    • Nội dung mô tả về các phương diện liên quan đến time periods đã được chỉnh sửa để lưu ý rằng giá trị phương diện đề cập đến khoảng thời gian bắt đầu từ 12:00 sáng theo giờ Thái Bình Dương và kết thúc lúc 11:59 tối theo giờ Thái Bình Dương vào ngày, tháng và năm được chỉ định. Tuỳ thuộc vào thời điểm trong năm, giờ Thái Bình Dương là UTC-7 hoặc UTC-8.

      Mặc dù ngày thường đại diện cho khoảng thời gian 24 giờ, nhưng ngày mà đồng hồ được điều chỉnh tiến lên đại diện cho khoảng thời gian 23 giờ và ngày mà đồng hồ được điều chỉnh lùi lại đại diện cho khoảng thời gian 25 giờ. (Trước đây, tài liệu này nêu rõ rằng giờ Thái Bình Dương là UTC-8 và không đề cập đến khả năng một ngày có thể không đại diện cho khoảng thời gian 24 giờ.)

      Xin lưu ý rằng nội dung chỉnh sửa này không thể hiện sự thay đổi trong hành vi thực tế của API.

    • Tài liệu về báo cáo kênh đã được cập nhật để lưu ý rằng báo cáo kênh hiện không chứa các chỉ số về thu nhập hoặc hiệu suất quảng cáo. Do đó, phạm vi https://www.googleapis.com/auth/yt-analytics-monetary.readonly hiện không cấp quyền truy cập vào dữ liệu tiền tệ trong báo cáo kênh.

    • Phương diện operatingSystem hỗ trợ 3 giá trị phương diện mới:
      • FIREFOX
      • REALMEDIA
      • TIZEN

Ngày 8 tháng 2 năm 2017

YouTube Analytics API hiện hỗ trợ tham số include-historical-channel-data không bắt buộc. Xin lưu ý rằng tham số này chỉ phù hợp khi truy xuất báo cáo của chủ sở hữu nội dung.

Tham số này cho phép chủ sở hữu nội dung cho biết rằng phản hồi của API phải bao gồm dữ liệu về thời gian xem và số lượt xem của kênh trong khoảng thời gian trước khi kênh được liên kết với chủ sở hữu nội dung. Giá trị mặc định của tham số này là false, nghĩa là theo mặc định, phản hồi của API chỉ bao gồm dữ liệu về thời gian xem và số lượt xem kể từ thời điểm kênh được liên kết với chủ sở hữu nội dung.

Các quy tắc này cũng áp dụng nếu yêu cầu API truy xuất dữ liệu cho nhiều kênh:

  • Nếu giá trị tham số là false, thì dữ liệu về thời gian xem và số lượt xem được trả về cho một kênh bất kỳ sẽ dựa trên ngày kênh đó được liên kết với chủ sở hữu nội dung.

    Bạn cần lưu ý rằng các kênh khác nhau có thể đã được liên kết với một chủ sở hữu nội dung vào những ngày khác nhau. Nếu yêu cầu API đang truy xuất dữ liệu cho nhiều kênh và giá trị tham số là false, thì phản hồi của API sẽ chứa dữ liệu về thời gian xem và số lượt xem dựa trên ngày liên kết của từng kênh tương ứng.
  • Nếu giá trị tham số là true, thì phản hồi sẽ trả về dữ liệu về thời gian xem và số lượt xem cho tất cả các kênh dựa trên ngày bắt đầu và ngày kết thúc được chỉ định trong yêu cầu API.

Ngày 15 tháng 12 năm 2016

Các báo cáo sau đây của YouTube Reporting API không còn được hỗ trợ và đã bị xoá khỏi tài liệu. Mỗi báo cáo đều có phiên bản mới hơn. (Thông báo ngừng sử dụng các báo cáo này được đưa ra vào ngày 15 tháng 9 năm 2016.)

Danh sách các loại báo cáo hiện tại trong tài liệu tham khảo API cũng đã được cập nhật.

Ngày 11 tháng 11 năm 2016

Bản cập nhật này có những thay đổi sau:

API Báo cáo của YouTube hỗ trợ 3 báo cáo mới về màn hình kết thúc cũng như các phương diện và chỉ số mới cho những báo cáo đó. Báo cáo này cung cấp số liệu thống kê về số lượt hiển thị và lượt nhấp cho màn hình kết thúc xuất hiện sau khi video dừng phát.

  • Báo cáo về màn hình kết thúc

  • Kích thước màn hình kết thúc

    • end_screen_element_type: Loại thành phần màn hình kết thúc liên kết với số liệu thống kê.
    • end_screen_element_id: Mã nhận dạng mà YouTube dùng để xác định riêng biệt thành phần màn hình kết thúc.

  • Các chỉ số về màn hình kết thúc

    Lưu ý: Dữ liệu cho các chỉ số về màn hình kết thúc được cung cấp từ ngày 1 tháng 5 năm 2016.

    • Trung tâm trợ giúp của YouTube có thông tin chi tiết hơn về cách thêm màn hình kết thúc vào video.

  • Các báo cáo sau đây không còn được hỗ trợ và đã bị xoá khỏi tài liệu. Mỗi báo cáo đều có phiên bản mới hơn. (Thông báo ngừng sử dụng các báo cáo này được đưa ra vào ngày 22 tháng 6 năm 2016.)

Ngày 8 tháng 11 năm 2016

Bản cập nhật này có những thay đổi sau đối với YouTube Analytics API:

  • Các chỉ số trong danh sách sau đây hoàn toàn không được dùng nữa và không còn được hỗ trợ. Như đã thông báo vào ngày 10 tháng 8 năm 2016, các chỉ số mới tham chiếu đến cùng một dữ liệu đã được hỗ trợ. Bảng dưới đây cho biết tên chỉ số không còn được dùng và tên chỉ số mới:

    Chỉ số không dùng nữa Chỉ số mới
    adEarnings estimatedAdRevenue
    impressionBasedCpm cpm
    impressions adImpressions
    redPartnerRevenue estimatedRedPartnerRevenue

Ngày 27 tháng 10 năm 2016

YouTube hiện tự động tạo một bộ báo cáo doanh thu từ quảng cáo do hệ thống quản lý cho những chủ sở hữu nội dung có quyền truy cập vào các báo cáo tương ứng trong phần Báo cáo của YouTube Studio. Các báo cáo API mới do hệ thống quản lý được thiết kế để cung cấp quyền truy cập có lập trình vào dữ liệu cũng có trong các báo cáo có thể tải xuống theo cách thủ công trong YouTube Studio.

Tổng quan về báo cáo do hệ thống quản lý cung cấp thông tin tổng quan ngắn gọn về các báo cáo mới và giải thích quy trình truy xuất các báo cáo đó thông qua API. Quy trình này hơi khác so với quy trình truy xuất báo cáo hàng loạt cho YouTube Analytics vì đối tác không cần lên lịch cho các công việc tạo báo cáo.

Thuộc tính id của tài nguyên reportType đã được cập nhật để bao gồm danh sách các báo cáo do hệ thống quản lý mà bạn có thể truy cập thông qua API:

  • Doanh thu hằng tháng từ quảng cáo trên mỗi video trên toàn thế giới
  • Doanh thu hằng ngày từ quảng cáo trên mỗi video theo quốc gia
  • Doanh thu hằng tháng từ quảng cáo trên toàn cầu cho mỗi tài sản
  • Doanh thu hằng ngày từ quảng cáo trên mỗi tài sản theo quốc gia
  • Thông báo xác nhận quyền sở hữu (báo cáo này không chứa dữ liệu về doanh thu)

Ngày 27 tháng 9 năm 2016

Lưu ý: Đây là thông báo ngừng cung cấp.

Chỉ số uniques của YouTube Analytics API không còn được dùng nữa. Đây không phải là chỉ số chính và sẽ được hỗ trợ cho đến ngày 31 tháng 10 năm 2016.

Ngày 15 tháng 9 năm 2016

Bản cập nhật này bao gồm những thay đổi sau đây đối với API Báo cáo YouTube:

  • API này hỗ trợ hai chỉ số mới liên quan đến lượng người xem YouTube Red:

  • API này hỗ trợ các phiên bản mới của 20 báo cáo. Tất cả phiên bản mới đều hỗ trợ các chỉ số red_views và red_watch_time_minutes mới.

    Đối với mỗi báo cáo, mã loại báo cáo mới sẽ có giá trị cao hơn mã loại báo cáo cũ một đơn vị. (Các phiên bản cũ của những báo cáo này hiện không còn được dùng nữa, như mô tả ở phần sau trong nhật ký sửa đổi này.) Ví dụ: báo cáo channel_basic_a1 hiện không còn được dùng nữa và đã được thay thế bằng báo cáo channel_basic_a2.

    Danh sách sau đây xác định mã loại báo cáo mới:

  • Lưu ý: Đây là thông báo ngừng cung cấp.

    Xin lưu ý rằng nếu đã có công việc để tạo bất kỳ phiên bản cũ nào của các báo cáo nêu trên, thì bạn cần tạo công việc mới cho các báo cáo đã đổi tên. Cùng với việc phát hành các phiên bản báo cáo mới, các phiên bản báo cáo sau đây đã ngừng hoạt động:

    • channel_basic_a1
    • channel_province_a1
    • channel_playback_location_a1
    • channel_traffic_source_a1
    • channel_device_os_a1
    • channel_subtitles_a1
    • channel_combined_a1
    • content_owner_basic_a2
    • content_owner_province_a1
    • content_owner_playback_location_a1
    • content_owner_traffic_source_a1
    • content_owner_device_os_a1
    • content_owner_subtitles_a1
    • content_owner_combined_a1
    • content_owner_asset_basic_a1
    • content_owner_asset_province_a1
    • content_owner_asset_playback_location_a1
    • content_owner_asset_traffic_source_a1
    • content_owner_asset_device_os_a1
    • content_owner_asset_combined_a1

    Nếu có lệnh cho bất kỳ báo cáo nào trong số đó, bạn không nên mong đợi YouTube tạo báo cáo mới cho những lệnh đó sau ngày 15 tháng 12 năm 2016. Các báo cáo đã tạo vẫn sẽ được cung cấp trong vòng 180 ngày kể từ thời điểm tạo.

Ngày 19 tháng 8 năm 2016

Bản cập nhật này bao gồm thay đổi sau đây đối với YouTube Reporting API:

  • Báo cáo content_owner_basic_a1 đã hoàn toàn ngừng hoạt động và bị xoá khỏi tài liệu. YouTube sẽ không tạo báo cáo mới thuộc loại đó nữa, nhưng những báo cáo đã được tạo vẫn sẽ được cung cấp trong vòng 180 ngày kể từ thời điểm tạo.

    Báo cáo content_owner_basic_a1 được thay thế bằng báo cáo content_owner_basic_a2 như đã giải thích trong mục nhật ký sửa đổi ngày 19 tháng 5 năm 2016.

Ngày 11 tháng 8 năm 2016

Bản cập nhật này có những thay đổi sau:

  • Điều khoản dịch vụ mới được công bố của Các dịch vụ API YouTube ("Điều khoản cập nhật") được thảo luận chi tiết trên Blog dành cho nhà phát triển và kỹ sư YouTube, cung cấp nhiều nội dung cập nhật cho Điều khoản dịch vụ hiện tại. Ngoài Điều khoản cập nhật sẽ có hiệu lực từ ngày 10 tháng 2 năm 2017, nội dung cập nhật này còn bao gồm một số tài liệu hỗ trợ để giải thích các chính sách mà nhà phát triển phải tuân thủ.

    Bộ tài liệu mới đầy đủ được mô tả trong nhật ký sửa đổi của Điều khoản mới. Ngoài ra, những thay đổi trong tương lai đối với Điều khoản cập nhật hoặc các tài liệu hỗ trợ đó cũng sẽ được giải thích trong nhật ký sửa đổi đó. Bạn có thể đăng ký nguồn cấp dữ liệu RSS liệt kê các thay đổi trong nhật ký sửa đổi đó thông qua một đường liên kết trong tài liệu đó.

Ngày 10 tháng 8 năm 2016

Bản cập nhật này bao gồm những thay đổi sau:

  • YouTube Analytics API (Truy vấn có mục tiêu)

    • Lưu ý: Đây là thông báo ngừng cung cấp.

      Các chỉ số trong bảng sau đây sẽ không được dùng nữa. Đồng thời, chúng tôi cũng ra mắt các chỉ số mới liên quan đến cùng một dữ liệu. Trên thực tế, điều này có nghĩa là các chỉ số cũ sẽ được đổi tên, mặc dù YouTube Analytics API sẽ hỗ trợ cả hai tên chỉ số cho đến ngày ngừng hoạt động được nêu trong bảng.

      Tên chỉ số cũ Tên chỉ số mới Ngày hỗ trợ
      earnings estimatedRevenue Ngày 10 tháng 8 năm 2017
      adEarnings estimatedAdRevenue Ngày 4 tháng 11 năm 2016
      redPartnerRevenue estimatedRedPartnerRevenue Ngày 4 tháng 11 năm 2016
      impressionBasedCpm cpm Ngày 4 tháng 11 năm 2016
      impressions adImpressions Ngày 4 tháng 11 năm 2016

      Xin lưu ý rằng chỉ số earnings là một chỉ số cốt lõi, nên sẽ được hỗ trợ trong một năm kể từ ngày thông báo này được đưa ra. Các chỉ số khác không phải là chỉ số chính sẽ được hỗ trợ trong 3 tháng, cho đến ngày 4 tháng 11 năm 2016.

      Ví dụ: cho đến ngày 4 tháng 11 năm 2016, một yêu cầu API có thể chỉ định chỉ số impressionBasedCpm, chỉ số cpm hoặc cả hai. Tuy nhiên, sau ngày đó, chúng tôi sẽ chỉ hỗ trợ chỉ số cpm.

    • Phương diện insightTrafficSourceType hỗ trợ hai giá trị phương diện mới:
      • CAMPAIGN_CARD: Nguồn lưu lượng truy cập này chỉ được hỗ trợ cho báo cáo của chủ sở hữu nội dung. Chỉ số này cho biết lượt xem bắt nguồn từ những video do người dùng tải lên và đã được xác nhận quyền sở hữu, đồng thời được chủ sở hữu nội dung dùng để quảng bá nội dung được xem.
      • END_SCREEN: Dữ liệu liên quan đến những lượt xem bắt nguồn từ màn hình kết thúc của một video khác.

      Đối với cả hai nguồn lưu lượng truy cập mới, bạn cũng có thể truy xuất báo cáo traffic source detail. Trong cả hai trường hợp, phương diện insightTrafficSourceDetail xác định video đã giới thiệu người xem.

    • Phương diện adType hiện hỗ trợ giá trị auctionBumperInstream, tức là quảng cáo dạng video không thể bỏ qua, dài tối đa 6 giây và phát trước khi người dùng có thể xem video.

  • YouTube Reporting API (Báo cáo hàng loạt)

    • Phương diện traffic_source_type hiện hỗ trợ các giá trị sau:
      • 19: Nguồn lưu lượng truy cập này chỉ được hỗ trợ cho báo cáo của chủ sở hữu nội dung. Giá trị này cho biết lượt xem bắt nguồn từ những video do người dùng tải lên và đã được xác nhận quyền sở hữu, đồng thời được chủ sở hữu nội dung dùng để quảng bá nội dung được xem.
      • 20: Dữ liệu liên quan đến những lượt xem bắt nguồn từ màn hình kết thúc của một video khác.

      Đối với cả hai nguồn lưu lượng truy cập mới, phương diện traffic_source_detail xác định video đã giới thiệu người xem.

    • Danh sách chỉ số cốt lõi của API đã được điều chỉnh để đưa estimated_partner_revenue vào danh sách chỉ số cốt lõi và xoá earnings khỏi danh sách đó. (Chỉ số earnings chưa từng được hỗ trợ trong API YouTube Reporting.)

    • Phương diện ad_type hiện hỗ trợ giá trị 19, tức là quảng cáo đệm. Đây là quảng cáo dạng video không thể bỏ qua, có thời lượng tối đa 6 giây và phát trước khi người dùng có thể xem video.

Ngày 18 tháng 7 năm 2016

Bản cập nhật này bao gồm những thay đổi sau:

  • YouTube Analytics API (Truy vấn có mục tiêu)

    • Danh sách các chỉ số được hỗ trợ cho báo cáo kênh sau đây đã được cập nhật để bao gồm các chỉ số về thẻ. Trên thực tế, tính năng hỗ trợ cho các chỉ số của thẻ trong những báo cáo này đã được thêm vào ngày 28 tháng 6 năm 2016 và mục nhật ký sửa đổi cho ngày đó giải thích chi tiết hơn về thay đổi này. Các báo cáo này bao gồm:
      • Hoạt động cơ bản của người dùng ở các tiểu bang của Hoa Kỳ
      • Hoạt động của người dùng ở các tiểu bang của Hoa Kỳ trong những khoảng thời gian cụ thể
      • Hoạt động của người dùng theo tỉnh
      • Hoạt động của người dùng theo trạng thái đăng ký
      • Hoạt động của người dùng theo trạng thái đăng ký cho các tỉnh
      • Video hàng đầu theo tiểu bang
      • Những video hàng đầu đối với người xem đã đăng ký hoặc chưa đăng ký

    • Danh sách bộ lọc đã được điều chỉnh cho cả báo cáo khả năng giữ chân người xem của kênh và báo cáo khả năng giữ chân người xem của chủ sở hữu nội dung để cho thấy rằng bộ lọc video là bắt buộc và bộ lọc group không được hỗ trợ.

      Trước đây, tài liệu cho cả hai báo cáo đều nêu không chính xác rằng bạn có thể truy xuất báo cáo bằng một trong hai bộ lọc đó hoặc không sử dụng bộ lọc nào.

  • YouTube Reporting API (Báo cáo hàng loạt)

    • Trong phần Tổng quan về API, phần giải thích cách truy xuất URL tải báo cáo xuống đã được chỉnh sửa để nêu rõ rằng YouTube có tạo báo cáo có thể tải xuống cho những ngày không có dữ liệu. Những báo cáo đó có chứa một hàng tiêu đề nhưng không chứa dữ liệu bổ sung. Thông tin này đã được cập nhật trong phần Đặc điểm báo cáo của cùng tài liệu này vào ngày 12 tháng 4 năm 2016.
    • Danh sách phương diện trong báo cáo content_owner_asset_cards_a1 đã được điều chỉnh để cho thấy rằng báo cáo sử dụng phương diện card_id. Trước đây, tài liệu này liệt kê không chính xác tên phương diện là card_title.

Ngày 28 tháng 6 năm 2016

Tài liệu về API YouTube Analytics đã được cập nhật để phản ánh việc hỗ trợ chỉ số thẻ trong nhiều báo cáo về kênh và chủ sở hữu nội dung. Các chỉ số mới được hỗ trợ là:

Các chỉ số này được hỗ trợ trong những loại báo cáo sau:

Ngày 22 tháng 6 năm 2016

Bản cập nhật này bao gồm những thay đổi sau đây đối với API YouTube Reporting. Thay đổi đầu tiên liên quan đến API nói chung, còn những thay đổi còn lại chỉ ảnh hưởng đến báo cáo của chủ sở hữu nội dung:

  • Mục Đặc điểm của báo cáo trong phần tổng quan về API đã được cập nhật để làm rõ rằng báo cáo được cung cấp thông qua API trong vòng 180 ngày kể từ thời điểm tạo.

    Trước đây, tài liệu nêu rõ rằng báo cáo được cung cấp trong khoảng thời gian tối đa 180 ngày trước ngày gửi yêu cầu API. Mặc dù về mặt kỹ thuật thì điều này cũng đúng, nhưng văn bản gốc, nói một cách nhẹ nhàng nhất, là khá khó hiểu.

  • API này hỗ trợ các phiên bản mới của 3 báo cáo. Hai trong số các báo cáo đó cũng có các chỉ số mới và được đổi tên:

    • Báo cáo content_owner_ad_rates_a1 là phiên bản mới của báo cáo content_owner_ad_performance_a1. Báo cáo mới được đổi tên giống hệt với phiên bản trước.

    • Hai báo cáo có phiên bản mới đã được đổi tên:

      • Phiên bản mới của báo cáo content_owner_estimated_earnings_a1 có tên là content_owner_estimated_revenue_a1.
      • Phiên bản mới của báo cáo content_owner_asset_estimated_earnings_a1 có tên là content_owner_asset_estimated_revenue_a1.

      Cả hai báo cáo mới được đổi tên đều khác với các báo cáo trước đó theo những cách sau:

    Xin lưu ý rằng nếu đã có lệnh tạo bất kỳ phiên bản cũ nào của các báo cáo này, thì bạn cần tạo lệnh mới cho các báo cáo đã đổi tên. Cùng với việc phát hành các phiên bản báo cáo mới, báo cáo content_owner_ad_performance_a1, content_owner_estimated_earnings_a1 và content_owner_asset_estimated_earnings_a1 đã ngừng hoạt động.

    Nếu có công việc cho bất kỳ báo cáo nào trong số đó, bạn không nên mong đợi YouTube tạo báo cáo mới cho những công việc đó sau ngày 22 tháng 9 năm 2016. Các báo cáo đã tạo vẫn sẽ được cung cấp trong vòng 180 ngày kể từ thời điểm tạo.

  • Định nghĩa về thuộc tính id của tài nguyên reportType đã được cập nhật để phản ánh nhóm báo cáo hiện có.

  • Tên của hai chỉ số đã được sửa trong tài liệu để khớp với tên xuất hiện trong báo cáo. Đây hoàn toàn là một nội dung chỉnh sửa tài liệu và không phản ánh thay đổi trong nội dung báo cáo thực tế:

    • Tên của chỉ số estimated_partner_adsense_revenue đã được cập nhật thành estimated_partner_ad_sense_revenue. Tuy nhiên, xin lưu ý rằng chỉ số này chỉ xuất hiện trong hai báo cáo sẽ ngừng hoạt động trong bản cập nhật này. Như đã mô tả ở trên, chỉ số này đã được đổi tên thành estimated_partner_ad_auction_revenue trong các phiên bản mới hơn của những báo cáo đó.
    • Tên của chỉ số estimated_partner_doubleclick_revenue đã được cập nhật thành estimated_partner_double_click_revenue. Xin lưu ý một lần nữa rằng chỉ số này chỉ xuất hiện trong hai báo cáo sẽ ngừng hoạt động trong bản cập nhật này. Như đã mô tả ở trên, chỉ số này đã được đổi tên thành estimated_partner_ad_reserved_revenue trong các phiên bản mới hơn của những báo cáo đó.

  • Tài liệu về phương diện cho Reporting API đã được cập nhật để không còn liệt kê các thuộc tính elapsed_video_time_percentage và audience_retention_type. Các phương diện này hiện không được hỗ trợ trong bất kỳ báo cáo nào có sẵn thông qua API.

Ngày 19 tháng 5 năm 2016

Bản cập nhật này bao gồm những thay đổi sau đây đối với API Báo cáo YouTube:

  • API này hỗ trợ phiên bản mới của báo cáo hoạt động của người dùng dành cho chủ sở hữu nội dung. Mã loại báo cáo cho báo cáo mới là content_owner_basic_a2. Không giống như phiên bản trước của báo cáo, content_owner_basic_a1, phiên bản mới hỗ trợ các chỉ số likes và dislikes.

    Nếu đã có một công việc để tạo báo cáo content_owner_basic_a1, bạn vẫn cần tạo một công việc mới cho báo cáo content_owner_basic_a2. YouTube không tự động di chuyển chủ sở hữu nội dung sang phiên bản báo cáo mới hoặc tự động tạo công việc để tạo phiên bản báo cáo mới. Trong một số trường hợp triển khai, sự xuất hiện của một công việc mới, không mong muốn có thể là một thay đổi có thể gây lỗi.

    Cùng với việc phát hành báo cáo mới, báo cáo content_owner_basic_a1 đã bị ngừng sử dụng. Nếu có một công việc cho báo cáo đó, bạn không nên mong đợi YouTube tạo báo cáo mới cho công việc đó sau ngày 19 tháng 8 năm 2016. Các báo cáo đã tạo vẫn sẽ được cung cấp trong vòng 180 ngày kể từ thời điểm tạo.

  • Các tài nguyên reportType, job và report đều hỗ trợ một thuộc tính mới giúp xác định xem tài nguyên được liên kết có đại diện cho một loại báo cáo không dùng nữa hay không:

    • Thuộc tính deprecateTime của tài nguyên reportType chỉ định ngày và giờ mà loại báo cáo sẽ ngừng hoạt động. Thuộc tính này chỉ có giá trị đối với những báo cáo đã được thông báo là không dùng nữa và giá trị này thể hiện ngày mà YouTube sẽ ngừng tạo báo cáo thuộc loại đó.

      Sau khi thông báo ngừng sử dụng một loại báo cáo, YouTube sẽ tiếp tục tạo báo cáo thuộc loại đó trong 3 tháng nữa. Ví dụ: bản cập nhật này vào ngày 19 tháng 5 năm 2016 thông báo về việc ngừng sử dụng báo cáo content_owner_basic_a1. Do đó, deprecateTime cho loại báo cáo đó chỉ định thời gian vào ngày 19 tháng 8 năm 2016, sau đó YouTube sẽ ngừng tạo báo cáo thuộc loại đó.

    • Thuộc tính expireTime của tài nguyên job chỉ định ngày và giờ mà công việc đã hết hạn hoặc sẽ hết hạn. Thuộc tính này có giá trị nếu loại báo cáo liên kết với công việc đã ngừng hoạt động hoặc nếu báo cáo được tạo cho công việc không được tải xuống trong một khoảng thời gian dài. Ngày này đánh dấu thời điểm YouTube không còn tạo báo cáo mới cho công việc này nữa.

    • Thuộc tính jobExpireTime của tài nguyên report chỉ định ngày và giờ mà công việc liên kết với báo cáo đã hết hạn hoặc sẽ hết hạn. Thuộc tính này chứa cùng giá trị với thuộc tính expireTime trong tài nguyên job, như mô tả trong mục trước của danh sách này.

  • Phương thức jobs.create hiện trả về mã phản hồi HTTP 400 (Bad Request) nếu bạn cố gắng tạo một công việc cho một báo cáo không dùng nữa. Ngoài ra, tài liệu về phương thức này hiện liệt kê một số lý do khác khiến yêu cầu API không thành công.

Ngày 12 tháng 4 năm 2016

Bản cập nhật này có những thay đổi sau đây và tất cả đều chỉ ảnh hưởng đến YouTube Reporting API:

  • YouTube hiện tạo dữ liệu trong khoảng thời gian 180 ngày trước thời điểm một công việc báo cáo được lên lịch lần đầu tiên. Trước đây, Reporting API không cung cấp dữ liệu trong quá khứ. Thay đổi này ảnh hưởng đến tất cả công việc, kể cả những công việc được tạo trước thông báo này.

    Báo cáo trước đây sẽ được đăng ngay khi có sẵn, mặc dù phải mất khoảng một tháng thì tất cả dữ liệu trước đây mới được đăng cho một công việc. Vì vậy, một tháng sau khi lên lịch cho một công việc báo cáo, bạn sẽ có quyền truy cập vào dữ liệu của khoảng 7 tháng. (Tất cả dữ liệu trước đây về các công việc được tạo trước thông báo này phải được đăng trong vòng một tháng kể từ ng��y thông báo.)

    Xin lưu ý rằng dữ liệu trong quá khứ chỉ có từ ngày 1 tháng 7 năm 2015. Do đó, những công việc được tạo trước ngày 28 tháng 12 năm 2015 sẽ có dữ liệu trong quá khứ dưới 180 ngày.

    Tất cả những thay đổi này đều được giải thích trong phần dữ liệu trong quá khứ mới của bài viết Tổng quan về Reporting API.

  • Phần đặc điểm của báo cáo trong thông tin tổng quan về API báo cáo của YouTube đã được cập nhật những thay đổi sau:

    • Tài liệu hiện nêu rõ rằng báo cáo sẽ được cung cấp trong 180 ngày sau khi được tạo, do đó, ứng dụng API có thể tải báo cáo xuống. Trước đây, tài liệu nêu rõ rằng báo cáo có sẵn trong khoảng thời gian tối đa 6 tháng trước ngày gửi yêu cầu API.

    • Tài liệu đã được cập nhật để phản ánh việc API hiện tạo báo cáo có thể tải xuống cho những ngày không có dữ liệu. Những báo cáo đó sẽ chứa các hàng tiêu đề nhưng không chứa dữ liệu bổ sung.

  • API Báo cáo của YouTube sẽ sớm hỗ trợ một nhóm báo cáo được tạo tự động và do hệ thống quản lý, trong đó có chứa dữ liệu về doanh thu từ quảng cáo hoặc dữ liệu về doanh thu từ gói thuê bao YouTube Red. Những chủ sở hữu nội dung có thể truy cập vào báo cáo doanh thu có thể tải xuống theo cách thủ công trong YouTube Studio sẽ có thể xem các báo cáo này. Do đó, chức năng API mới sẽ cung cấp quyền truy cập có lập trình vào dữ liệu đó.

    Sau đây là những thay đổi về API mà chúng tôi đang thông báo để chuẩn bị cho việc ra mắt báo cáo do hệ thống quản lý:

    • Thuộc tính systemManaged mới của tài nguyên job cho biết liệu tài nguyên đó có mô tả một công việc tạo báo cáo do hệ thống quản lý hay không. YouTube tự động tạo báo cáo do hệ thống quản lý cho chủ sở hữu nội dung trên YouTube và chủ sở hữu nội dung không thể sửa đổi hoặc xoá các công việc tạo ra những báo cáo đó.

    • Tham số includeSystemManaged mới của phương thức jobs.list cho biết liệu phản hồi của API có nên bao gồm các công việc cho báo cáo do hệ thống quản lý hay không. Giá trị mặc định của tham số là false.

    • Tham số startTimeAtOrAfter mới của phương thức jobs.reports.list cho biết rằng phản hồi của API chỉ được chứa báo cáo nếu dữ liệu sớm nhất trong báo cáo là vào hoặc sau ngày đã chỉ định. Tương tự, tham số startTimeBefore cho biết rằng phản hồi của API chỉ được chứa báo cáo nếu dữ liệu sớm nhất trong báo cáo là trước ngày đã chỉ định.

      Không giống như tham số createdAfter của phương thức (liên quan đến thời điểm tạo báo cáo), các tham số mới liên quan đến dữ liệu trong báo cáo.

    • Thuộc tính systemManaged mới của tài nguyên reportType cho biết liệu tài nguyên đó có mô tả một báo cáo do hệ thống quản lý hay không.

    • Tham số includeSystemManaged mới của phương thức reportTypes.list cho biết liệu phản hồi của API có nên bao gồm các báo cáo do hệ thống quản lý hay không. Giá trị mặc định của tham số là false.

Ngày 28 tháng 3 năm 2016

API Báo cáo của YouTube và YouTube Analytics API hiện trả về số liệu thống kê về lượt xem cho một số dịch vụ chia sẻ khác.

  • Trong API Báo cáo của YouTube, phương diện sharing_service hỗ trợ các giá trị mới sau:
    • 82: Hộp thoại hoạt động của hệ thống iOS
    • 83: Hộp thư đến của Google
    • 84: Android Messenger
  • Trong YouTube Analytics API, phương diện sharingService hỗ trợ các giá trị mới sau đây:
    • ANDROID_MESSENGER: Android Messenger
    • INBOX: Google Inbox
    • IOS_SYSTEM_ACTIVITY_DIALOG: Hộp thoại hoạt động của hệ thống iOS

Ngày 16 tháng 3 năm 2016

Bản cập nhật này có những thay đổi sau đây, ảnh hưởng đến cả API Báo cáo của YouTube và YouTube Analytics API:

YouTube Reporting API

  • Phương diện playback_location_type hỗ trợ hai giá trị phương diện mới:
    • 7: Dữ liệu liên quan đến những lượt xem diễn ra trên trang chủ YouTube hoặc màn hình chính, trong 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.
    • 8: Dữ liệu liên quan đến những lượt xem diễn ra ngay trên trang kết quả tìm kiếm của YouTube.
  • Phương diện traffic_source_type hiện hỗ trợ 18 làm giá trị phương diện. Giá trị này cho biết lượt xem video bắt nguồn từ một trang liệt kê tất cả video trong danh sách phát. Nguồn này khác với loại nguồn 14, cho biết rằng lượt xem xảy ra khi video được phát trong một danh sách phát.

YouTube Analytics API

  • Phương diện insightPlaybackLocationType hỗ trợ hai giá trị phương diện mới:
    • BROWSE: Dữ liệu liên quan đến những lượt xem diễn ra trên trang chủ YouTube hoặc màn hình chính, trong 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.
    • SEARCH: Dữ liệu liên quan đến những lượt xem diễn ra trực tiếp trên trang kết quả tìm kiếm của YouTube.
  • Phương diện insightTrafficSourceType hiện hỗ trợ YT_PLAYLIST_PAGE làm giá trị phương diện. Giá trị này cho biết lượt xem video bắt nguồn từ một trang liệt kê tất cả video trong danh sách phát. Nguồn này khác với loại nguồn PLAYLIST, cho biết rằng lượt xem xảy ra khi video đang được phát trong một danh sách phát.

Ngày 8 tháng 2 năm 2016

Danh sách các chỉ số được hỗ trợ cho YouTube Analytics API đã được cập nhật để các chỉ số về thẻ không còn được liệt kê là chỉ số được hỗ trợ cho API đó. (Không có báo cáo nào của API đó được ghi nhận là hỗ trợ bất kỳ chỉ số nào của thẻ.)

Xin lưu ý rằng bạn vẫn có thể truy xuất các chỉ số về thẻ bằng API Báo cáo của YouTube. API này hỗ trợ các chỉ số đó cho nhiều báo cáo về kênh và chủ sở hữu nội dung.

Ngày 6 tháng 1 năm 2016

Giờ đây, cả API Báo cáo của YouTube và YouTube Analytics API đều xác định cụ thể những lượt xem diễn ra thông qua thiết bị Chromecast.

  • Trong API Báo cáo YouTube, phương diện operating_system sử dụng giá trị 21 để xác định những lượt xem diễn ra qua Chromecast.
  • Trong API YouTube Analytics, phương diện operatingSystem sử dụng giá trị CHROMECAST để xác định những lượt xem diễn ra qua Chromecast.

Ngày 21 tháng 12 năm 2015

Trong tài liệu, tên của các chỉ số annotation_clickable_impressions và annotation_closable_impressions đã được cập nhật để khớp với tên được trả về trong báo cáo. Trước đây, tên được ghi lại là clickable_annotation_impressions và closable_annotation_impressions.

Ngày 18 tháng 12 năm 2015

Luật của Liên minh Châu Âu (EU) yêu cầu bạn phải công bố một số thông tin nhất định và nhận được sự đồng ý của người dùng cuối ở EU. Do đó, đối với người dùng cuối ở Liên minh Châu Âu, bạn phải tuân thủ Chính sách về sự đồng ý của người dùng ở Liên minh Châu Âu. Chúng tôi đã thêm thông báo về yêu cầu này vào Điều khoản dịch vụ của API YouTube.

Ngày 15 tháng 12 năm 2015

Bản cập nhật này có những thay đổi sau đây và tất cả đều ảnh hưởng đến YouTube Analytics API:

  • YouTube Analytics API hiện hỗ trợ 3 phương diện mới về thông tin phát. Bạn có thể sử dụng các phương diện này trong nhiều báo cáo về kênh và chủ sở hữu nội dung:

    • liveOrOnDemand: Phương diện này cho biết liệu dữ liệu trong báo cáo có mô tả hoạt động của người dùng diễn ra trong một sự kiện phát sóng trực tiếp hay không.
    • subscribedStatus: Phương diện này cho biết các chỉ số về hoạt động của người dùng trong 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.
    • youtubeProduct: Phương diện này xác định tài sản YouTube nơi diễn ra hoạt động của người dùng. Các giá trị có thể bao gồm trang web YouTube chính (hoặc ứng dụng YouTube), YouTube Gaming và YouTube Kids.

    Tài liệu đã được cập nhật để xác định các báo cáo chi tiết mới về lượt phát dành cho kênh và chủ sở hữu nội dung. Ngoài ra, nhiều báo cáo khác cũng đã được cập nhật để lưu ý rằng bạn có thể sử dụng một hoặc nhiều phương diện này làm phương di��n và/hoặc bộ lọc trong các báo cáo đó.

  • Định dạng của các bảng giải thích báo cáo đã thay đổi để giúp bạn dễ dàng xác định các kiểu kết hợp hợp lệ giữa phương diện, chỉ số và bộ lọc có thể dùng để truy xuất từng báo cáo. Bảng sau đây giải thích báo cáo "Loại thiết bị" cho các kênh, cho thấy định dạng mới:

    Thuộc tính Giá trị
    Phương diện:
    Bắt buộc deviceType
    Sử dụng 0 trở lên day, liveOrOnDemand, subscribedStatus, youtubeProduct
    Chỉ số:
    Sử dụng 1 hoặc nhiều views, estimatedMinutesWatched
    Bộ lọc:
    Sử dụng 0 hoặc 1 country, province, continent, subContinent
    Sử dụng 0 hoặc 1 video, nhóm
    Sử dụng 0 trở lên operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

    Thuật ngữ mô tả các trường bắt buộc và không bắt buộc được giải thích trong tài liệu về báo cáo kênh và báo cáo chủ sở hữu nội dung.

  • Giờ đây, YouTube Analytics API sẽ tự động loại bỏ những thực thể mà người dùng API không thể truy xuất dữ liệu từ các bộ lọc hỗ trợ nhiều giá trị (video, playlist và channel). Trước đây, máy chủ API sẽ chỉ trả về lỗi nếu người dùng API không thể truy cập vào dữ liệu của ít nhất một trong các mục được chỉ định.

    Ví dụ: giả sử người dùng gửi một yêu cầu API, trong đó bộ lọc video liệt kê 20 mã video. Người dùng sở hữu 18 video. Tuy nhiên, một mã video xác định một video thuộc sở hữu của một kênh khác và một mã khác xác định một video đã bị xoá nên không còn tồn tại. Trong trường hợp này, thay vì trả về lỗi, máy chủ API hiện sẽ bỏ qua hai video mà người dùng không thể truy cập và phản hồi của API sẽ chứa dữ liệu cho 18 video mà người dùng API sở hữu.

  • Nếu bạn yêu cầu dữ liệu cho một group trống trong YouTube Analytics, thì API hiện sẽ trả về một tập dữ liệu trống thay vì lỗi.

  • Phương thức groupItems.insert của YouTube Analytics API hiện trả về lỗi không được phép (mã phản hồi HTTP 403) nếu bạn cố gắng thêm một th��c thể vào một nhóm nhưng không có quyền truy cập vào thực thể đó. Trước đây, API cho phép bạn thêm pháp nhân vào nhóm, nhưng sau đó trả về lỗi không được uỷ quyền khi bạn cố gắng truy xuất dữ liệu báo cáo cho nhóm đó.

  • Phương thức groups.list của YouTube Analytics API hiện hỗ trợ tính năng phân trang. Nếu phản hồi của API không chứa tất cả các nhóm hiện có, thì tham số nextPageToken của phản hồi sẽ chỉ định một mã thông báo có thể dùng để truy xuất trang kết quả tiếp theo. Đặt tham số pageToken của phương thức thành giá trị đó để truy xuất thêm kết quả.

Ngày 10 tháng 11 năm 2015

Bản cập nhật này có những thay đổi sau:

Ngày 29 tháng 10 năm 2015

Bản cập nhật này có những thay đổi sau:

  • Tài liệu về phương diện date của YouTube Reporting API đã được chỉnh sửa để phản ánh rằng ngày tham chiếu đến khoảng thời gian 24 giờ bắt đầu từ 12:00 sáng theo giờ Thái Bình Dương (UTC-8). Trước đây, tài liệu này nêu rõ rằng ngày bắt đầu lúc 12:00 sáng (GMT).

    Ngoài ra, tài liệu về YouTube Analytics API đã được cập nhật để lưu ý rằng tất cả phương diện liên quan đến ngày (day, 7DayTotals, 30DayTotals và month) đều đề cập đến ngày bắt đầu từ 12:00 giờ sáng theo giờ Thái Bình Dương (UTC-8).

  • Phương thức jobs.reports.list() của YouTube Reporting API hiện hỗ trợ tham số truy vấn createdAfter. Nếu được chỉ định, tham số này cho biết rằng phản h��i của API chỉ nên liệt kê các báo cáo được tạo sau ngày và giờ đã chỉ định, bao gồm cả các báo cáo mới có dữ liệu được điền sẵn. Xin lưu ý rằng giá trị tham số liên quan đến thời điểm tạo báo cáo chứ không phải ngày liên quan đến dữ liệu được trả về.

    Giá trị tham số là dấu thời gian theo định dạng RFC3339 UTC "Zulu", chính xác đến micrô giây. Ví dụ: "2015-10-02T15:01:23.045678Z"

    Các phương pháp hay nhất về YouTube Reporting API cũng đã được cập nhật để giải thích cách bạn có thể sử dụng tham số createdAfter để tránh xử lý lặp lại cùng một báo cáo.

  • Định nghĩa về thuộc tính createTime của tài nguyên job và các thuộc tính startTime, endTime và createTime của tài nguyên report đều đã được sửa để lưu ý rằng các giá trị thuộc tính chính xác đến micrô giây, chứ không phải nano giây. Ngoài ra, tất cả định nghĩa hiện đều phản ánh chính xác rằng giá trị thuộc tính là dấu thời gian.

Ngày 8 tháng 10 năm 2015

Bản cập nhật này có những thay đổi sau:

  • Tài liệu về phương diện sharingService của YouTube Analytics API đã được cập nhật để thêm danh sách các giá trị có thể có của phương diện này. Danh sách này bao gồm một số dịch vụ mới được hỗ trợ.

    Định nghĩa về phương diện sharing_service của API Báo cáo YouTube cũng đã được cập nhật để liệt kê các giá trị được hỗ trợ mới. Các giá trị enum lớn hơn 59 là các giá trị mới trong danh sách.

Ngày 24 tháng 9 năm 2015

B���n cập nhật này có những thay đổi sau:

  • API Báo cáo mới của YouTube truy xuất hàng loạt báo cáo dữ liệu chứa dữ liệu trong YouTube Analytics của một kênh hoặc chủ sở hữu nội dung. Định dạng này được thiết kế cho các ứng dụng có thể nhập tập dữ liệu lớn và cung cấp các công cụ để lọc, sắp xếp và khai thác dữ liệu đó.

    Mỗi báo cáo của API Báo cáo của YouTube đều chứa một tập hợp phương diện và chỉ số được xác định trước. (Báo cáo của YouTube Analytics API cũng sử dụng các chỉ số và phương diện.) Trong báo cáo, mỗi hàng dữ liệu có một tổ hợp giá trị phương diện riêng biệt. Bạn có thể tổng hợp dữ liệu trên các hàng dựa trên giá trị phương diện để tính toán chỉ số cho từng video, quốc gia, video trực tiếp, người dùng đã đăng ký, v.v.

    Bạn có thể sử dụng API này để lên lịch cho các công việc báo cáo, trong đó mỗi công việc xác định một báo cáo mà YouTube cần tạo. Sau khi bạn thiết lập một công việc, YouTube sẽ tạo một báo cáo hằng ngày mà bạn có thể tải xuống không đồng bộ. Mỗi báo cáo chứa dữ liệu cho một khoảng thời gian 24 giờ riêng biệt.

  • Mặc dù là hai API khác nhau, nhưng cả YouTube Analytics API và API Báo cáo của YouTube đều cho phép nhà phát triển truy xuất dữ liệu trong YouTube Analytics. Vì cả hai API đều cung cấp quyền truy cập vào các tập dữ liệu tương tự nhau, nên tài liệu cho hai API này được xuất bản dưới dạng một bộ tài liệu duy nhất.

    • Thẻ Hướng dẫn trong bộ tài liệu chứa thông tin chung cho cả hai API, bao gồm cả hướng dẫn uỷ quyền cho các yêu cầu API.
    • Thẻ Báo cáo hàng loạt chứa tài liệu tham khảo và nội dung khác dành riêng cho API Báo cáo của YouTube.
    • Thẻ Truy vấn có mục tiêu chứa tài liệu tham khảo và nội dung khác dành riêng cho YouTube Analytics API.
    • Thẻ Samples (Mẫu) liệt kê các mã mẫu có sẵn cho một trong hai API.
    • Thẻ Công cụ liệt kê các tài nguyên bổ sung có sẵn để giúp nhà phát triển triển khai một trong hai API.

Ngày 20 tháng 8 năm 2015

Bản cập nhật này có những thay đổi sau:

  • Tài liệu về API đã được tái cấu trúc để giúp bạn dễ hiểu hơn về API. Do đó, những thay đổi này không mô tả các tính năng mới:

    • Tài liệu hiện có một trang liệt kê tất cả báo cáo kênh hiện có và một trang khác liệt kê tất cả báo cáo của chủ sở hữu nội dung hiện có. Trước đây, tài liệu này có các trang riêng cho báo cáo video trên kênh, báo cáo danh sách phát trên kênh, v.v.

    • Tổng quan về mô hình dữ liệu mới nhằm giới thiệu rõ ràng hơn về cách hoạt động của API. Cụ thể, tài liệu này cố gắng giải thích rõ hơn cách YouTube sử dụng các chỉ số, phương diện và bộ lọc để tính toán giá trị báo cáo.

    • Phương thức reports.query của API (bạn dùng để truy xuất báo cáo) hiện được ghi lại riêng. Thông tin trên trang đó trước đây nằm trên một số trang khác. Trang mới được thiết kế để giúp bạn dễ dàng xác định thông tin cần gửi để truy xuất báo cáo.

Ngày 22 tháng 7 năm 2015

Bản cập nhật này có một số thay đổi và tất cả đều chỉ áp dụng cho chủ sở hữu nội dung:

  • Chỉ số adEarnings mới bao gồm tổng thu nhập ước tính (doanh thu ròng) từ tất cả các nguồn quảng cáo do Google bán. Đây không phải là chỉ số chính. API này hỗ trợ chỉ số adEarnings cho mọi báo cáo đã hỗ trợ chỉ số earnings.

    Ngoài ra, định nghĩa về chỉ số earnings đã được điều chỉnh để phản ánh thực tế rằng giá trị của chỉ số này bao gồm tổng thu nhập ước tính từ tất cả các nguồn quảng cáo do Google bán cũng như từ các nguồn không phải quảng cáo. Trước đây, định nghĩa này cho biết không chính xác rằng chỉ số này chỉ bao gồm thu nhập từ các nguồn quảng cáo.

  • Chỉ số primaryAdGrossRevenue không còn được dùng nữa. Thay vào đó, hãy sử dụng chỉ số grossRevenue để truy xuất dữ liệu doanh thu.

  • Ngoài chỉ số primaryAdGrossRevenue không còn được dùng nữa, báo cáo hiệu suất quảng cáo không còn hỗ trợ các chỉ số monetizedPlaybacks và playbackBasedCpm. Tuy nhiên, một số báo cáo video vẫn hỗ trợ các chỉ số đó.

Ngày 1 tháng 6 năm 2015

Bản cập nhật này có những thay đổi sau:

  • API hiện hỗ trợ hai chỉ số mới cho báo cáo video, videosAddedToPlaylists và videosRemovedFromPlaylists. Danh sách báo cáo video cho kênh và chủ sở hữu nội dung đều đã được cập nhật để xác định những báo cáo hỗ trợ các chỉ số mới.

    • videosAddedToPlaylists – Số lần các video trong phạm vi truy vấn được thêm vào danh sách phát bất kỳ trên YouTube. Những video này có thể đã được thêm vào danh sách phát của chủ sở hữu video hoặc danh sách phát của các kênh khác.
    • videosRemovedFromPlaylists – Số lần video trong phạm vi truy vấn bị xoá khỏi danh sách phát bất kỳ trên YouTube. Video có thể đã bị xoá khỏi danh sách phát của chủ sở hữu video hoặc khỏi danh sách phát của các kênh khác.

    Cả hai chỉ số này đều bao gồm các danh sách phát mặc định như danh sách phát "Xem sau". Tuy nhiên, các chỉ số này không tính những danh sách phát mà video được tự động thêm vào, chẳng hạn như danh sách phát video tải lên của một kênh hoặc nhật ký xem của người dùng. Cũng xin lưu ý rằng các chỉ số này phản ánh số lượng tuyệt đối của các mục được thêm và xoá. Vì vậy, nếu người dùng thêm một video vào danh sách phát, sau đó xoá video đó rồi thêm lại, thì các chỉ số sẽ cho biết video đó đã được thêm vào hai danh sách phát và bị xoá khỏi một danh sách phát.

    Dữ liệu cho các chỉ số này có sẵn từ ngày 1 tháng 10 năm 2014.

Ngày 31 tháng 3 năm 2015

Bản cập nhật này có những thay đổi sau:

  • Cả hai chỉ số favoritesAdded và favoritesRemoved đều không còn được dùng nữa kể từ ngày thông báo này được đưa ra. Cả hai chỉ số này đều là chỉ số cốt lõi và tuân theo Chính sách về việc ngừng cung cấp được nêu trong điều khoản dịch vụ.

Ngày 16 tháng 3 năm 2015

Bản cập nhật này có những thay đổi sau:

  • Tham số currency mới cho phép bạn truy xuất các chỉ số thu nhập bằng một đơn vị tiền tệ khác với đô la Mỹ (USD). Nếu bạn đặt tham số này, thì API sẽ chuyển đổi các giá trị cho các chỉ số earnings, grossRevenue, playbackBasedCpm và impressionBasedCpm sang đơn vị tiền tệ được chỉ định. Giá trị được trả về là giá trị ước tính được tính bằng tỷ giá hối đoái thay đổi hằng ngày.

    Giá trị tham số là mã tiền tệ gồm 3 chữ cái theo tiêu chuẩn ISO 4217. Giá trị mặc định là USD. Định nghĩa tham số chứa danh sách các mã tiền tệ được hỗ trợ.

Ngày 25 tháng 2 năm 2015

Bản cập nhật này có những thay đổi sau:

  • API này hiện hỗ trợ khả năng tạo và quản lý các nhóm trong YouTube Analytics, cũng như khả năng truy xuất dữ liệu báo cáo cho các nhóm đó.

    • Tạo và quản lý nhóm

      Bản cập nhật này giới thiệu các tài nguyên group và groupItem để tạo và quản lý nhóm.

      • Tài nguyên group đại diện cho một nhóm Analytics, một tập hợp tuỳ chỉnh gồm tối đa 200 kênh, video, danh sách phát hoặc tài sản. API này hỗ trợ các phương thức list, insert, update và delete cho tài nguyên này.
      • Tài nguyên groupItem đại diện cho một mục trong nhóm Analytics. API này hỗ trợ các phương thức list, insert và delete cho tài nguyên này.

      Ví dụ: bạn có thể tạo một nhóm bằng phương thức groups.insert, sau đó thêm các mục vào nhóm đó bằng phương thức groupItems.insert.

    • Truy xuất dữ liệu báo cáo cho một nhóm

      Tài liệu về phương diện đã được cập nhật để bao gồm phương diện group. Bạn có thể dùng phương diện này làm bộ lọc cho nhiều báo cáo kênh và báo cáo của chủ sở hữu nội dung. Khi bạn sử dụng bộ lọc group, API sẽ trả về dữ liệu cho tất cả các mục trong nhóm đó. Xin lưu ý rằng API hiện không hỗ trợ khả năng tạo báo cáo cho nhóm thành phần.

    Hãy xem Trung tâm trợ giúp của YouTube để biết thêm thông tin về nhóm trong YouTube Analytics.

Ngày 13 tháng 2 năm 2015

Bản cập nhật này có những thay đổi sau:

  • API này không còn hỗ trợ phương diện show.

Ngày 28 tháng 8 năm 2014

Bản cập nhật này có những thay đổi sau:

  • Giờ đây, API hỗ trợ khả năng chỉ định nhiều giá trị cho các phương diện video, playlist, channel và show khi các phương diện đó được dùng làm bộ lọc. Để chỉ định nhiều giá trị, 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, kênh hoặc chương trình mà phản hồi của API cần lọc. Giá trị tham số có thể chỉ định tối đa 200 mã nhận dạng.

    Nếu chỉ định nhiều giá trị cho cùng một bộ lọc, bạn cũng có thể thêm bộ lọc đó vào danh sách phương diện mà bạn chỉ định cho yêu cầu. Điều này đúng ngay cả khi bộ lọc không được liệt kê là phương diện được hỗ trợ cho một báo cáo cụ thể. Nếu bạn thêm bộ lọc vào danh sách phương diện, thì API cũng sẽ sử dụng các giá trị bộ lọc để nhóm kết quả.

    Hãy xem định nghĩa về tham số filters để biết thông tin chi tiết đầy đủ về chức năng này.

Ngày 16 tháng 7 năm 2014

Bản cập nhật này có những thay đổi sau:

  • Giờ đây, khi truy xuất báo cáo kênh, bạn có thể truy xuất dữ liệu cho kênh của người dùng đã xác thực bằng cách đặt giá trị của tham số ids thành channel==MINE. (Bạn cũng có thể đặt tham số ids thành channel==CHANNEL_ID để truy xuất dữ liệu cho kênh được chỉ định.)

  • API này hiện hỗ trợ báo cáo danh sách phát, trong đó có số liệu thống kê liên quan đến số lượt xem video trong danh sách phát. Báo cáo danh sách phát được cung cấp cho kênh và chủ sở hữu nội dung.

    Tất cả báo cáo về danh sách phát đều hỗ trợ các chỉ số views và estimatedMinutesWatched, một số báo cáo cũng hỗ trợ chỉ số averageViewDuration.

    Ngoài ra, tất cả báo cáo về danh sách phát đều hỗ trợ các chỉ số mới sau đây. Xin lưu ý rằng mỗi chỉ số này chỉ phản ánh số lượt xem danh sách phát trên web.

    • playlistStarts: Số lần người xem phát lại một danh sách phát.
    • viewsPerPlaylistStart: Số lượt xem video trung bình mỗi khi một danh sách phát được bắt đầu.
    • averageTimeInPlaylist: Thời lượng trung bình ước tính (tính bằng phút) mà người xem đã xem các video trong một danh sách phát sau khi danh sách phát đó được phát.

    Mọi yêu cầu truy xuất báo cáo danh sách phát đều phải sử dụng bộ lọc isCurated và bộ lọc này phải được đặt thành 1 (isCurated==1).

  • API này hiện hỗ trợ báo cáo khả năng giữ chân người xem. Báo cáo này đo lường khả năng giữ chân khán giả của một video. Phương diện elapsedVideoTimeRatio mới của báo cáo đo lường thời lượng video đã trôi qua cho các giá trị chỉ số tương ứng:

    • Chỉ số audienceWatchRatio xác định tỷ lệ tuyệt đối của số người xem video tại thời điểm nhất định trong video. Tỷ lệ này được tính bằng cách so sánh số lần một đoạn video được xem với tổng số lượt xem của video đó.

      Xin lưu ý rằng một phần của video có thể được xem nhiều lần (hoặc không được xem) trong một lượt xem video nhất định. Ví dụ: nếu người dùng tua lại và xem cùng một đoạn video nhiều lần, thì tỷ lệ tuyệt đối cho đoạn video đó có thể lớn hơn 1.

    • Chỉ số relativeRetentionPerformance cho biết mức độ hiệu quả của video trong việc giữ chân người xem trong các lượt phát, so với tất cả các video trên YouTube có thời lượng tương tự. Giá trị 0 cho biết video giữ chân người xem kém hơn mọi video khác có thời lượng tương tự, còn giá trị 1 cho biết video giữ chân người xem tốt hơn mọi video khác có thời lượng tương tự. Giá trị trung vị là 0,5 cho biết một nửa số video có thời lượng tương tự giữ chân người xem tốt hơn, còn một nửa giữ chân người xem kém hơn.

    Bạn cũng có thể sử dụng bộ lọc audienceType để báo cáo chỉ trả về dữ liệu liên quan đến lượt xem tự nhiên, lượt xem từ quảng cáo TrueView trong luồng phát hoặc lượt xem từ quảng cáo TrueView trong hiển thị. (Lượt xem tự nhiên là kết quả trực tiếp từ hành động của người dùng, chẳng hạn như tìm kiếm video hoặc nhấp vào video đề xuất.)

  • API này hỗ trợ một số chỉ số mới liên quan đến chú thích. Bạn có thể truy xuất các chỉ số được liệt kê bên dưới bằng bất kỳ báo cáo nào trước đây hỗ trợ chỉ số annotationClickThroughRate và annotationCloseRate.

    Tất cả các chỉ số mới đều là chỉ số chính và tuân theo Chính sách về việc ngừng cung cấp. Tuy nhiên, xin lưu ý rằng dữ liệu cho các chỉ số mới sẽ có từ ngày 16 tháng 7 năm 2013. (Dữ liệu cho các chỉ số annotationClickThroughRate và annotationCloseRate có sẵn từ ngày 10 tháng 6 năm 2012.)

  • GOOGLE_SEARCH không còn được báo cáo dưới dạng một giá trị riêng biệt cho phương diện insightTrafficSourceType. Thay vào đó, lượt giới thiệu từ kết quả tìm kiếm trên Google hiện được phân bổ cho loại nguồn lưu lượng truy cập EXT_URL. Do đó, bạn cũng không thể truy xuất báo cáo insightTrafficSourceDetail đặt bộ lọc insightTrafficSourceType thành GOOGLE_SEARCH nữa.

Ngày 31 tháng 1 năm 2014

Bản cập nhật này có những thay đổi sau:

Ngày 16 tháng 1 năm 2014

Bản cập nhật này có những thay đổi sau:

  • Tài liệu yêu cầu mẫu đã được thiết kế lại để nhóm các ví dụ thành các danh mục, sử dụng định dạng thẻ tương tự như định dạng mới phát hành gần đây cho báo cáo kênh và báo cáo chủ sở hữu nội dung. Trong thiết kế mới, các ví dụ được nhóm thành các danh mục sau:

    • Số liệu thống kê cơ bản
    • Dựa trên thời gian
    • Địa lý
    • Vị trí phát
    • Nguồn lưu lượng truy cập
    • Thiết bị/Hệ điều hành
    • Nhân khẩu học
    • Xã hội
    • Thu nhập/Quảng cáo (chỉ dành cho báo cáo của chủ sở hữu nội dung)

  • Tài liệu yêu cầu mẫu hiện có thêm các ví dụ mới về cách truy xuất dữ liệu theo tỉnh trong báo cáo kênh hoặc báo cáo của chủ sở hữu nội dung.

    • Các chỉ số theo tỉnh cho các tiểu bang của Hoa Kỳ và Washington D.C.: Báo cáo này truy xuất thông tin chi tiết theo từng tỉnh về số lượt xem và các số liệu thống kê khác cho video của một kênh. Dữ liệu này bao gồm các tiểu bang của Hoa Kỳ và Washington D.C. Ví dụ này sử dụng phương diện province và tham số filters để hạn chế phản hồi chỉ bao gồm kết quả cho Hoa Kỳ.

    • 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ề nhóm tuổi và giới tính của những người xem ở California đã xem video của một kênh hoặc nội dung mà chủ sở hữu nội dung đã xác nhận quyền sở hữu (đối với báo cáo của chủ sở hữu nội dung). Ví dụ này sử dụng tham số filters để đảm bảo phản hồi chỉ bao gồm dữ liệu cho một tỉnh cụ thể.

  • Định nghĩa về phương diện province đã được cập nhật để lưu ý rằng khi province được đưa vào giá trị tham số dimensions, thì yêu cầu cũng phải hạn chế dữ liệu ở Hoa Kỳ bằng cách đưa country==US vào giá trị tham số filters.

Ngày 6 tháng 1 năm 2014

Bản cập nhật này có những thay đổi sau:

  • Tài liệu liệt kê các báo cáo được hỗ trợ về kênh và chủ sở hữu nội dung đã được thiết kế lại. Thay vì cung cấp một bảng liệt kê tất cả báo cáo có thể có, mỗi tài liệu sẽ nhóm các báo cáo thành các danh mục:

    • Số liệu thống kê cơ bản
    • Dựa trên thời gian
    • Địa lý
    • Vị trí phát
    • Nguồn lưu lượng truy cập
    • Thiết bị/Hệ điều hành
    • Nhân khẩu học
    • Xã hội
    • Video hàng đầu

    Mỗi tài liệu hiển thị các danh mục này dưới dạng danh sách thẻ và bạn có thể nhấp vào bất kỳ thẻ nào để xem các báo cáo được hỗ trợ trong danh mục đó.

  • API này hiện hỗ trợ 3 phương diện địa lý mới: province, continent và subContinent.

    • Phương diện province cho phép bạn truy xuất số liệu thống kê cho các tiểu bang của Hoa Kỳ và cho Đặc khu Columbia. API này hỗ trợ hai cách sử dụng cho phương diện này:

      • API này hỗ trợ hai báo cáo phân tích số liệu thống kê theo từng tiểu bang. Cả hai báo cáo này đều được cung cấp cho kênh và chủ sở hữu nội dung.

        • Báo cáo số liệu thống kê cơ bản cung cấp một số số liệu thống kê, bao gồm số lượt xem và số phút xem ước tính.
        • Báo cáo dựa trên thời gian cung cấp cùng một số liệu thống kê, nhưng tổng hợp dữ liệu hằng ngày, 7 ngày, 30 ngày hoặc hằng tháng.

      • Bạn có thể sử dụng tham số truy vấn filters để giới hạn báo cáo chỉ chứa số liệu thống kê cho một tiểu bang cụ thể. Một số báo cáo hỗ trợ loại bộ lọc này, bao gồm báo cáo địa lý, báo cáo vị trí phát, báo cáo nguồn lưu lượng truy cập, báo cáo thiết bị, báo cáo hệ điều hành, báo cáo nhân khẩu học và báo cáo video hàng đầu.

    • Phương diện continent chỉ định mã khu vực thống kê của Liên hợp quốc (LHQ) để xác định một lục địa. Bạn chỉ có thể sử dụng phương diện này làm bộ lọc.

    • Phương diện subContinent chỉ định mã khu vực thống kê của Liên Hợp Quốc (UN) để xác định một tiểu vùng của một lục địa. Bạn cũng chỉ có thể sử dụng phương diện này làm bộ lọc.

      Vì mỗi tiểu vùng chỉ liên kết với một lục địa, nên bạn không cần sử dụng bộ lọc continent khi đang sử dụng bộ lọc subContinent. (Trên thực tế, API sẽ trả về lỗi nếu một yêu cầu sử dụng cả hai phương diện.)

  • Tài liệu đã được chỉnh sửa để phương diện insightTrafficSourceDetail không bao gồm giá trị insightTrafficSourceType PROMOTED làm giá trị bộ lọc hợp lệ.

Ngày 30 tháng 9 năm 2013

Bản cập nhật này có những thay đổi sau:

  • YouTube Analytics API hiện phải tuân theo Chính sách về việc ngừng cung cấp được mô tả trong Điều khoản dịch vụ. Tuy nhiên, các phương diện và chỉ số không cốt lõi của API không thuộc phạm vi điều chỉnh của Chính sách về việc ngừng cung cấp. Các trang phương diện và chỉ số đã được cập nhật để liệt kê các phương diện và chỉ số chính. Ngoài ra, định nghĩa trên các trang đó cũng đã được cập nhật để xác định rõ ràng các phương diện và chỉ số cốt lõi.

  • API này hiện hỗ trợ EXTERNAL_APP làm giá trị cho phương diện insightPlaybackLocationType. Cùng với bản cập nhật này, kể từ ngày 10 tháng 9 năm 2013, các lượt phát không còn được phân loại là lượt phát MOBILE, mặc dù các lượt phát trên thiết bị di động diễn ra trước ngày đó vẫn sẽ được phân loại theo giá trị đó.

    Với nội dung cập nhật này, các lượt phát trên thiết bị di động hiện được phân loại là lượt phát trên WATCH, EMBEDDED hoặc EXTERNAL_APP, tuỳ thuộc vào loại ứng dụng mà lượt phát diễn ra.

  • API này hiện hỗ trợ PLAYLIST làm giá trị cho phương diện insightTrafficSourceType. Giá trị này cho biết lượt xem video được giới thiệu từ một danh sách phát. Trước đây, những lượt xem này sẽ được phân loại bằng danh mục YT_OTHER_PAGE của phương diện.

Ngày 16 tháng 7 năm 2013

Bản cập nhật này có những thay đổi sau:

  • API hiện hỗ trợ khả năng sắp xếp báo cáo theo nhiều phương diện và chỉ số. Tài liệu về yêu cầu mẫu có một ví dụ mới, Sắp xếp yêu cầu theo nhiều phương diện/chỉ số, minh hoạ chức năng này. Yêu cầu này truy xuất dữ liệu nguồn lưu lượng truy cập và có giá trị tham số sort là day,-views. Kết quả được sắp xếp theo trình tự thời gian, nhưng trong tập kết quả của mỗi ngày, hàng đầu tiên 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, hàng thứ hai chứa dữ liệu về nguồn tạo ra số lượt xem cao thứ hai, v.v.

  • API này hiện hỗ trợ hai phương diện mới là deviceType và operatingSystem. Bạn có thể dùng hai phương diện này để truy xuất dữ liệu về những thiết bị mà người xem dùng để xem video của bạn. API này hỗ trợ các báo cáo sử dụng một hoặc cả hai phương diện.

    • Báo cáo deviceType cho phép bạn truy xuất số lượt xem và thời gian xem ước tính cho nhiều loại thiết bị, bao gồm máy tính, thiết bị di động và máy tính bảng. Bạn cũng có thể sử dụng bộ lọc operatingSystem để giới hạn báo cáo loại thiết bị chỉ chứa số liệu thống kê cho các thiết bị chạy một hệ điều hành cụ thể, chẳng hạn như Android hoặc iOS.

    • Báo cáo operatingSystem cho phép bạn truy xuất số lượt xem và thời gian xem ước tính cho nhiều hệ điều hành, chẳng hạn như Android, iOS, Linux và các hệ điều hành khác. Bạn cũng có thể sử dụng bộ lọc deviceType để giới hạn báo cáo hệ điều hành chỉ chứa số liệu thống kê cho một loại thiết bị cụ thể, chẳng hạn như thiết bị di động hoặc máy tính bảng.

    Báo cáo mới về loại thiết bị và hệ điều hành được cung cấp cho kênh và chủ sở hữu nội dung.

  • Tài liệu yêu cầu mẫu đã được cập nhật để bao gồm 3 báo cáo thiết bị cho kênh và 3 báo cáo thiết bị cho chủ sở hữu nội dung.

  • Phương diện insightPlaybackLocationType có thể trả về giá trị YT_OTHER, giúp xác định những lượt xem không được phân loại bằng một trong các giá trị khác của phương diện.

Ngày 23 tháng 5 năm 2013

Bản cập nhật này có những thay đổi sau:

Ngày 10 tháng 5 năm 2013

Bản cập nhật này có những thay đổi sau:

Ngày 6 tháng 5 năm 2013

Bản cập nhật này có những thay đổi sau:

  • Giờ đây, API hỗ trợ khả năng truy xuất các chỉ số về thời gian xem (estimatedMinutesWatched, averageViewDuration và averageViewPercentage) cùng với các chỉ số khác, bao gồm cả chỉ số về lượt xem, chỉ số tương tác, chỉ số về thu nhập và chỉ số hiệu suất quảng cáo.

    Danh sách báo cáo kênh và báo cáo của chủ sở hữu nội dung hiện có đã được cập nhật để phản ánh thay đổi này. (Các danh sách này hiện đã ngắn hơn vì bạn có thể truy xuất các chỉ số về thời gian xem trong các báo cáo khác được liệt kê.)

    Tài liệu Yêu cầu API mẫu cũng đã được cập nhật.

  • Những báo cáo sử dụng phương diện insightPlaybackLocationDetail và insightTrafficSourceDetail đã được cải thiện theo những cách sau:

    • Các phương thức này hiện hỗ trợ bộ lọc country không bắt buộc.

    • Giờ đây, chủ sở hữu nội dung có thể truy xuất các báo cáo này bằng cách sử dụng bất kỳ tổ hợp filter mới nào sau đây. Xin lưu ý rằng tất cả các tổ hợp này cũng hỗ trợ bộ lọc country không bắt buộc.

      • Thông tin chi tiết về vị trí phát

        • channel,insightPlaybackLocationType==EMBEDDED
        • show,insightPlaybackLocationType==EMBEDDED
        • claimedStatus,insightPlaybackLocationType==EMBEDDED
        • uploaderType,insightPlaybackLocationType==EMBEDDED
        • uploaderType,claimedStatus,insightPlaybackLocationType==EMBEDDED

      • Thông tin chi tiết về nguồn lưu lượng truy cập

        • channel,insightTrafficSourceType
        • show,insightTrafficSourceType
        • claimedStatus,insightTrafficSourceType
        • uploaderType,insightTrafficSourceType
        • uploaderType,claimedStatus,insightTrafficSourceType

Ngày 3 tháng 5 năm 2013

Bản cập nhật này có những thay đổi sau:

  • Tài liệu Yêu cầu API mẫu mới cung cấp các ví dụ minh hoạ cách truy xuất nhiều loại báo cáo bằng YouTube Analytics API. Mỗi ví dụ đều có nội dung mô tả ngắn gọn về báo cáo mà yêu cầu truy xuất, sau đó cho thấy các phương diện, chỉ số, bộ lọc và tham số sắp xếp cho yêu cầu đó.

  • Phương diện insightTrafficSourceType hiện hỗ trợ SUBSCRIBER dưới dạng một giá trị hợp lệ. Giá trị này xác định số 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 dựa trên nguồn lưu lượng truy cập này, thì trường insightTrafficSourceDetail sẽ chỉ định trang chủ hoặc trang khác đã giới thiệu lượt xem.

Ngày 28 tháng 3 năm 2013

Bản cập nhật này có những thay đổi sau:

Ngày 21 tháng 3 năm 2013

Bản cập nhật này có những thay đổi sau:

  • API này hiện hỗ trợ các chỉ số về thu nhập và hiệu suất quảng cáo, cũng như các báo cáo mới về hiệu suất quảng cáo. Chỉ những đối tác nội dung trên YouTube tham gia Chương trình Đối tác YouTube mới có thể xem các chỉ số và báo cáo.

    • Các báo cáo mới được hỗ trợ này cung cấp các chỉ số hiệu suất quảng cáo dựa trên lượt phát và chỉ số hiệu suất quảng cáo dựa trên lượt hiển thị. Hãy xem tài liệu về báo cáo của chủ sở hữu nội dung để biết thêm thông tin về báo cáo hiệu suất quảng cáo.

    • Các chỉ số mới được hỗ trợ được liệt kê dưới đây. Danh sách báo cáo của chủ sở hữu nội dung đã được cập nhật để xác định những báo cáo (bao gồm cả hai báo cáo mới) hỗ trợ các chỉ số này.

      • earnings – Tổng thu nhập ước tính từ tất cả các nguồn quảng cáo do Google bán.
      • grossRevenue – Tổng doanh thu ước tính từ Google hoặc các đối tác DoubleClick.
      • primaryAdGrossRevenue – Tổng doanh thu ước tính, được tổng hợp và phân loại theo loại quảng cáo chính cho các lượt phát video mà báo cáo đề cập, từ Google hoặc các đối tác DoubleClick.
      • monetizedPlaybacks – Số lượt phát có ít nhất một lượt hiển thị quảng cáo.
      • playbackBasedCpm – Tổng doanh thu ước tính trên mỗi nghìn lượt phát.
      • impressions – Số lượt hiển thị quảng cáo đã xác minh được phân phát.
      • impressionBasedCpm – Tổng doanh thu ước tính trên mỗi nghìn lượt hiển thị quảng cáo.

      Lưu ý: Hãy xem định nghĩa về chỉ số để biết thông tin chi tiết đầy đủ.

    • Mọi yêu cầu truy xuất thu nhập hoặc chỉ số hiệu suất quảng cáo đều phải gửi mã thông báo uỷ quyền cấp quyền truy cập bằng phạm vi https://www.googleapis.com/auth/yt-analytics-monetary.readonly mới.

  • Tài liệu về API đã được sắp xếp lại để giải thích các loại báo cáo khác nhau trên các trang riêng biệt. Do đó, hiện có các trang riêng giải thích về các loại báo cáo kênh và báo cáo của chủ sở hữu nội dung.

Ngày 4 tháng 2 năm 2013

Bản cập nhật này có những thay đổi sau:

  • Hướng dẫn tham khảo của API hiện có phần ví dụ, bao gồm các mã mẫu minh hoạ cách gọi API bằng thư viện ứng dụng Java, JavaScript, Python và Ruby. Mã mẫu JavaScript này giống với mã được thảo luận chi tiết trong tài liệu về ứng dụng mẫu.

Ngày 14 tháng 11 năm 2012

Bản cập nhật này có những thay đổi sau:

  • Hướng dẫn tham khảo API hiện có APIs Explorer, cho phép bạn gọi API, xem yêu cầu API và truy xuất dữ liệu thực trong phản hồi.

  • API này hỗ trợ một số báo cáo mới cho cả kênh và chủ sở hữu nội dung, như mô tả dưới đây. Mỗi báo cáo đều có dạng báo cáo kênh hoặc báo cáo chủ sở hữu nội dung. Các trang phương diện và chỉ số cũng đã được cập nhật tương ứng.

    • Báo cáo vị trí phát cho biết số lượt xem video trên các loại trang hoặc ứng dụng khác nhau.

    • Báo cáo chi tiết về vị trí phát cho biết những trình phát được nhúng đã tạo ra nhiều lượt xem nhất cho một video cụ thể. Báo cáo này cung cấp thông tin chi tiết hơn so với báo cáo vị trí phát bằng cách xác định các URL liên kết với những trình phát được nhúng hàng đầu.

    • Báo cáo nguồn lưu lượng truy cập xác định số lượt xem video bắt nguồn từ các loại nguồn giới thiệu khác nhau.

    • Báo cáo chi tiết về nguồn lưu lượng truy cập xác định những nguồn 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ể. Ví dụ: báo cáo này có thể cho bạn biết những video có liên quan đã thu hút nhiều lưu lượng truy cập nhất đến một video cụ thể. Báo cáo này được hỗ trợ cho một số nguồn lưu lượng truy cập.

    • Báo cáo thời gian xem cung cấp thông tin về thời lượng khán giả xem nội dung của bạn. Báo cáo có thể tổng hợp dữ liệu cho một khung thời gian cụ thể (ngày, 7 ngày trước, 30 ngày trước, v.v.) hoặc quốc gia. Nếu một báo cáo tổng hợp dữ liệu theo ngày hoặc quốc gia, thì báo cáo đó cũng có thể chỉ định thời lượng trung bình của mỗi lượt xem video cũng như tỷ lệ phần trăm trung bình mà người dùng xem mỗi video.

Ngày 2 tháng 10 năm 2012

Bản cập nhật này có những thay đổi sau:

  • YouTube Analytics API hiện đã được cung cấp cho tất cả nhà phát triển. Bạn có thể kích hoạt API cho dự án của mình mà không cần yêu cầu quyền truy cập trước, từ bảng điều khiển Dịch vụ trong APIs console.

  • Phần Bắt đầu mới trình bày các điều kiện tiên quyết và các bước cơ bản để xây dựng một ứng dụng sử dụng YouTube Analytics API.

Ngày 12 tháng 9 năm 2012

Bản cập nhật này có những thay đổi sau:

  • Mục mới tìm hiểu về mức sử dụng hạn mức cung cấp các nguyên tắc để tối ưu hoá mức sử dụng hạn mức API. Máy chủ API tính toán chi phí truy vấn cho mỗi yêu cầu và chi phí đó được khấu trừ vào hạn mức sử dụng API của bạn. Vì các loại báo cáo khác nhau có thể có chi phí truy vấn rất khác nhau, nên bạn cần lên kế hoạch sử dụng hạn mức một cách hiệu quả và ứng dụng của bạn chỉ nên yêu cầu các chỉ số và dữ liệu mà ứng dụng thực sự cần.

  • Mục phương diện thời gian đã được cập nhật để giải thích rằng các phương diện đó cho biết báo cáo Analytics phải tổng hợp dữ liệu dựa trên một khoảng thời gian. API này hiện hỗ trợ các phương diện thời gian bổ sung sau:

    • 7DayTotals – Dữ liệu trong báo cáo sẽ được tổng hợp để mỗi hàng chứa dữ liệu trong khoảng thời gian 7 ngày.
    • 30DayTotals – Dữ liệu trong báo cáo sẽ được tổng hợp để mỗi hàng chứa dữ liệu trong khoảng thời gian 30 ngày.
    • month – Dữ liệu trong báo cáo sẽ được tổng hợp theo tháng dương lịch.

    Tương tự, mục báo cáo có sẵn đã được cập nhật để phản ánh việc API hỗ trợ các báo cáo sử dụng những phương diện này.

  • Mục phương diện của pháp nhân báo cáo đã được cập nhật để lưu ý rằ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 này (video, channel hoặc show) hoặc một tổ hợp được hỗ trợ của phương diện claimedStatus và uploaderType.

  • API hiện hỗ trợ hai lựa chọn sắp xếp mới cho báo cáo video hàng đầu. Những báo cáo này được cung cấp dưới dạng báo cáo kênh hoặc báo cáo của chủ sở hữu nội dung, chứa các chỉ số (lượt xem, bình luận, lượt thích, v.v.) theo từng quốc gia và phân tích các chỉ số đó theo video. Giờ đây, bạn có thể sắp xếp các báo cáo này dựa trên số người dùng đã đăng ký hoặc huỷ đăng ký kênh trên trang xem video.

  • Định nghĩa về chỉ số subscribersGained và subscribersLost đã được cập nhật để giải thích rằng một kênh có thể tăng hoặc giảm số người đăng ký ở một số nơi, bao gồm cả trang xem video, trang kênh và phần hướng dẫn xuất hiện trên trang chủ YouTube. Khi xuất hiện trong báo cáo dành riêng cho video, các chỉ số này chỉ bao gồm số liệu thống kê trên trang xem của video được chỉ định.