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 trong YouTube Analytics, mặc dù theo những cách khác nhau. Đăng ký nhận nhật ký thay đổi này. Đăng ký

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

YouTube Reporting API hiện hỗ trợ Phiên bản 1.1 của báo cáo thông tin tham khảo hằng tuần dành 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 sẽ đượ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 và độ trễ của dữ liệu: 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 được xử lý đầy đủ gần nhất và đề xuất phương thức videos.list của YouTube Data API để xem số liệu thống kê theo thời gian thực về video.

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

  • Cá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 lưu ý tư vấn vào phần 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 YouTube Reporting API để 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ữ lại số lượng chỉ số tổng hợp cho các tài nguyên đã bị xoá và để biểu thị các sự kiện ở cấp kênh.

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

YouTube sẽ áp dụng phương pháp tính lượt xem công khai cho tất cả các đị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 kiếm tiền và phần lớn các chỉ số hiệu suất chính sẽ không bị ảnh hưởng vì vẫn dựa trên các chỉ số về mức độ 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 những 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 điều kiện tham gia Chương trình Đối tác YouTube 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 quả nội dung của bạn trên YouTube.

Chỉ số Trạng thái Trigger Vùng sử dụng
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, giữ con trỏ lên trên và nhấp/nhấn để phát). Số lượt xem công khai tiêu chuẩn.
Lượt xem được thực hiện Không thay đổi Nội dung phát tiếp tục 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, phần lớn 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ỏ xuất hiện mà không cần tương tác hoặc tự động phát. Đo lường mức độ hiển thị và bao bì ở 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 Các chỉ số của YouTube Analytics API và Các chỉ số của YouTube Reporting API.

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

Chúng tôi đã cập nhật tài liệu về API YouTube Analytics (Truy vấn có mục tiêu) để xoá báo cáo Hoạt động của người dùng theo thành phố dành 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 (YouTube Reporting API) 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 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.

  • Kênh có thể xem báo cáo channel_reach_basic_a1 và channel_reach_combined_a1.
  • Chủ sở hữu nội dung có thể xem báo cáo content_owner_reach_basic_a1 và content_owner_reach_combined_a1.

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

Việc ngừng sử dụng báo cáo theo 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 những thay đổi về số lượt xem video Shorts sẽ vẫn có sẵn cho đến thời điểm đó, ngoại trừ Báo cáo về quyền sở hữu phiên bản 1.0 (content_owner_active_claims_a1) và Báo cáo về quyền sở hữu phiên bản 1.1 (content_owner_active_claims_a2) sẽ vẫn 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, Bulk Reports API sẽ được cập nhật trong lần thay đổi mới về số lượt xem video Shorts. Chúng tôi đã thực hiện những thay đổi sau:

  • Chúng tôi đã tạo phiên bản báo cáo mới cho từng báo cáo có chứa lượt xem (chiếm phần lớn trong số các báo cáo). Mỗi phiên bản báo cáo chịu ảnh hưởng đều tăng thêm một, chẳng hạn như từ phiên bản a2 lên phiên bản a3.
  • Đối với video Shorts, từ nay, số lượt xem 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 phương pháp tính số lượt xem trước đây.

Những thay đổi này sẽ có hiệu lực kể từ ngày 30 tháng 6 năm 2025 đối với Bulk Reports API. 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ó sẵn 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 các 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 gián đoạn 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 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 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 về video
Tên báo cáo Phiên bản 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 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 dành cho chủ sở hữu nội dung – Báo cáo về tài sản
Tên báo cáo Phiên bản 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 dành cho chủ sở hữu nội dung – Báo cáo Shorts (Không phải âm nhạc)
Tên báo cáo Phiên bản 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 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 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 dành cho chủ sở hữu nội dung – Báo cáo về tài sản
Tên báo cáo Phiên bản 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 Cụm từ tìm kiếm có mục tiêu sẽ được cập nhật trong lần thay đổi mới về số lượt xem video Shorts:

  • Đối với video Shorts, views sẽ là số lần một video Shorts bắt đầu phát hoặc phát lại.
  • Một chỉ số mới, engagedViews, sẽ phản ánh phương pháp đếm lượt xem trước đây. engagedViews sẽ xuất hiện trong tất cả cá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 Targeted Queries API. Hãy nhớ điều chỉnh các truy vấn 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 Bulk Reports API.

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 đã ngừng hoạt động đối với 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 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 API và API Báo cáo của YouTube:

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. Từ nay, 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

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 với 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.
  • Một chỉ số mới là engagedViews sẽ được cung cấp và phản ánh phương pháp đếm 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ố lượt xem và lượt xem có chủ đích mới cập nhật.

Hệ thống sẽ cập nhật Cụm từ tìm kiếm được nhắm mục tiêu muộn nhất vào ngày 30 tháng 4 và cập nhật Báo cáo hàng loạ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 dựa trên phương pháp cũ. Số lượt xem video Shorts và số lượt xem kênh sẽ không khớp với số liệu phân tích trong Studio.

Ngoài ra, việc ngừng sử dụng báo cáo Yêu cầu bồi thường hằng ngày (Phiên bản 1.0) như đã thông báo trước đó đã bị hoãn lại.

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

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 sử dụng.

Báo cáo Đơn khiếu kiện hằng ngày (Phiên bản 1.0) không còn được cung cấp cho đối tác nữa. Ứng dụng này sẽ không còn được hỗ trợ kể từ ngày 30 tháng 4 năm 2025. Định nghĩa của báo cáo đó cũng được cập nhật cho phù hợp. Hãy sử dụng báo cáo mới nhất về Yêu cầu bản quyền hằng ngày.

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

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

Tài liệu về API YouTube Analytics (Cụm từ tìm kiếm được nhắm đến) đã đượ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 trả về lỗi nếu tích của số 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ố lượng hàng mà một yêu cầu trả về, hãy chia truy vấ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 nguyên tắc, bạn nên sử 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 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

YouTube Analytics API (Truy vấn có mục tiêu) có một số điểm 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 mà chúng tôi đã thông báo vào ngày 19 tháng 1 năm 2024.

Mục nhập nhật ký sửa đổi sau đây cung cấp gần như cùng một thông tin với mục nhập từ 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 sử dụng.

    Phương diện isCurated không được dùng nữa đối với báo cáo danh sách phát của chủ sở hữu nội dung. Sau ngày 31 tháng 12 năm 2024, phiên bản này sẽ không còn được hỗ trợ nữa. Định nghĩa của phương diện đó cũng đã được cập nhật.

    Để 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 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, các chức năng API sau đây sẽ 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 của kênh mới.
    • Các chỉ số redViews và estimatedRedMinutesWatched không còn được hỗ trợ cho báo cáo danh sách phát trên kênh mới nữa. Những chỉ số này chưa có trong YouTube Studio. Do đó, thay đổi này 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 nữa. Các bộ lọc này chưa có trong YouTube Studio, vì vậy, 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 về danh sách phát trong tài liệu báo cáo dành cho chủ sở hữu nội dung đã được cập nhật để giải thích kỹ lưỡng hơn về các loại chỉ số được hỗ trợ cho báo cáo về danh sách phát:

    • Số liệu tổng hợp về video cung cấp số liệu về hoạt động của người dùng và số 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, đồng thời danh sách phát đó cũng thuộc quyền sở hữu của chủ sở hữu nội dung đó. Các chỉ số tổng hợp về video 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 độ gắn bó trong bối cảnh trang danh sách phát. Các chỉ số này cũng bao gồm dữ liệu về lượt xem của những video không thuộc 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 danh sách phát.

  • Các chỉ số trong danh sách phát mới sau đây đượ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ề các 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ó 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à một chỉ số tổng hợp về video, cho biết tổng số lần video trong danh sách phát của chủ sở hữu nội dung đượ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 được tổng hợp chỉ bao gồm lượt xem của những video thuộc quyền sở hữu của chủ sở hữu nội dung có liên kết với kênh sở hữu danh sách phát.

      Trong những báo cáo 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ố đó tính 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 về danh sách phát, tài liệu 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 dựa trên thời gian để xem ví dụ.

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

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

  • Lưu ý: Đây là thông báo ngừng sử dụng.

    Phương diện isCurated đã ngừng hoạt động đối với báo cáo kênh. Sau ngày 30 tháng 6 năm 2024, phiên bản này sẽ không còn được hỗ trợ nữa. Định nghĩa của phương diện đó cũng đã được cập nhật.

    Để 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 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, các chức năng API sau đây sẽ 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 của kênh mới.
    • Các chỉ số redViews và estimatedRedMinutesWatched không còn được hỗ trợ cho báo cáo danh sách phát trên kênh mới nữa. Những chỉ số này chưa có trong YouTube Studio. Do đó, thay đổi này 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 nữa. Các bộ lọc này chưa có trong YouTube Studio, vì vậy, 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 về danh sách phát trong tài liệu báo cáo về kênh đã được cập nhật để giải thích kỹ lưỡng hơn về các loại chỉ số được hỗ trợ cho báo cáo về danh sách phát:

    • Số liệu tổng hợp về video cung cấp số liệu về hoạt động của người dùng và số 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, đồng thời kênh đó cũng là chủ sở hữu của danh sách phát. Các chỉ số tổng hợp về video 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 độ gắn bó trong bối cảnh trang danh sách phát. Các chỉ số này cũng bao gồm dữ liệu về lượt xem của những video không thuộc 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 danh sách phát.

  • Các chỉ số mới sau đây về tương tác trong danh sách phát được hỗ trợ cho báo cáo danh sách phát của kênh. Các chỉ số này hiện 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ề các 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ó 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 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à một chỉ số tổng hợp về video, 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 được tổng hợp chỉ bao gồm lượt xem của những video thuộc về kênh sở hữu danh sách phát.

      Trong những báo cáo 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ố đó tính 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 về danh sách phát, tài liệu báo cáo về 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 dựa trên thời gian để xem ví dụ.

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

YouTube Analytics API (Truy vấn có mục tiêu) đã được cập nhật để hợp nhất 2 giá trị phương diện insightTrafficSourceType. Trước đây, phương diện này phân biệt giữa những video được phát trong danh sách phát (PLAYLIST) và những 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). Kể từ nay, 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

YouTube Analytics API (Truy vấn có mục tiêu) hỗ trợ 2 phương diện mới và 1 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 có phương diện city mới. Phương diện này xác định thông tin ước tính của YouTube về thành phố 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 được liên kết với 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ó ví dụ cho cả hai phương diện mới.

  • Nội dung tham chiếu đến 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

Cả API YouTube Analytics (Truy vấn được nhắm 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ị chi tiết mới về nguồn lưu lượng truy cập:

  • Trong API 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ì bạn có thể đặt giá trị insightTrafficSourceDetail thành podcasts. Giá trị này cho biết lưu lượng truy cập được giới thiệu từ trang đích của Podcast.
  • Trong YouTube Reporting API (Báo cáo hàng loạt), nếu giá trị của phương diện traffic_source_type là 3, thì bạn có thể đặt giá trị traffic_source_detail thành podcasts. Giá trị này cho biết lưu lượng truy cập được giới thiệu từ trang đích của Podcasts.

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 trở đi. Đây có thể là một thay đổi không tương thích ngược trong quá trình triển khai API của bạn. Theo phần Các thay đổi không tương thích ngược trong Điều khoản dịch vụ của YouTube API Services, chúng tôi sẽ thông báo về thay đổi này 6 tháng trước khi thay đổi có hiệu lực. Vui lòng cập nhật việc triển khai API trước ngày 11 tháng 8 năm 2022 để đảm bảo quá trình chuyển đổi sang bộ giá trị mới diễn ra suôn sẻ.

Sau đây là những thay đổi cụ thể sẽ được thực hiện:

  • Trong YouTube Analytics API (Truy vấn có mục tiêu), phương diện gender hiện hỗ trợ 2 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

Kể từ ngày 13 tháng 12 năm 2021, chúng tôi đã cập nhật 2 chỉ số để loại trừ lưu lượng truy cập từ đoạn video lặp lại. Thay đổi này ảnh hưởng đến cả API YouTube Analytics (Truy vấn được nhắm 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

YouTube Reporting API (Báo cáo hàng loạt) 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 lượt xem bắt nguồn từ tính năng Chuyển hướng trực tiếp:

  • 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 chỉ định mã nhận dạng kênh mà người xem được giới thiệu đến.

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

Cả YouTube Analytics API (Truy vấn được nhắm mục tiêu) và YouTube Reporting API (Báo cáo hàng loạt) đều hỗ trợ một giá trị mới cho phương diện nguồn lưu lượng truy cập. Giá trị này cho biết 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 API YouTube Analytics (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 YouTube Reporting API) sẽ 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 2 thay đổi ảnh hưởng đến YouTube Analytics API (Truy vấn có mục tiêu):

  • Kích thước tối đa của một nhóm báo cáo 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 được áp dụng khi truy xuất dữ liệu của YouTube Analytics. Tham số này hỗ trợ khả năng chỉ định nhiều giá trị cho 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

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à 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ó của 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.

Thông báo về việc phân chia giá trị mới 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 2 danh mục:

  • uploaded_push – Số lượt xem có được từ thông báo đẩy gửi đến người đăng ký khi video được tải lên
  • uploaded_other – Số lượt xem đế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 cho người đăng ký khi video được tải lên.

Các giá trị này được trả về cho khoảng 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 thể hiện bản thân thông báo mà là các nguồn lưu lượng truy cập mang lại một số lượt xem 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 3 lượt xem là do 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 YouTube Analytics API (Truy vấn có mục tiêu):

  • Lưu ý: Đây là thông báo ngừng sử dụng.

    YouTube sẽ ngừng hỗ trợ 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. Vào hoặc sau ngày đó, các lần thử 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 tổng hợp 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 và chia cho tổng số lượt xem trong khoảng thời gian đó để tính được viewerPercentage cho toàn bộ khoảng thời gian.
    • Hệ thống 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 toán các 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 API (Truy vấn có mục tiêu):

  • Vì API phiên bản 1 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 nội dung tham khảo đế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 API (Truy vấn có mục tiêu):

  • API phiên bản 1 hiện không được dùng nữa. Nếu chưa thực hiện, vui lòng cập nhật ứng dụng API để sử dụng phiên bản 2 của API này 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ụ. Hãy 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 cung cấp này được thông báo lần đầu 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 YouTube Analytics API (Truy vấn có mục tiêu):

  • Mục ẩn danh dữ liệu mới 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.

  • Chúng tôi đã cập nhật tài liệu về báo cáo kênh và báo cáo chủ sở hữu nội dung để 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 nữa.

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 API (Truy vấn có mục tiêu):

  • Yêu cầu về phạm vi đối với các phương thức sau đã thay đổi:
    • Các 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.
    • Các yêu cầu đối với phương thức groupItems.list phải có quyền truy cập vào một trong hai:
      • 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 API (Truy vấn có mục tiêu):

  • Phần Tổng quan về API có một phần mới là các chỉ số tổng hợp và mục đã xoá. Phần này giải thích cách các phản hồi 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.
  • Phần 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 các phản hồi của YouTube Analytics API. Như đã nêu trong Chính sách dành cho nhà phát triển của Dịch vụ API YouTube (mục III.E.4.b đến III.E.4.d), các ứng dụng API phải xoá hoặc làm mới siêu dữ liệu tài nguyên đã 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 từ 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 bổ sung) 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 có 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 180 ngày kể từ thời điểm được tạo. Để tránh nhầm lẫn, 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 dữ liệu trong quá khứ có thời gian lưu trữ hơn 30 ngày thông qua API. Bạn cũng sẽ không thể truy cập vào tất cả các báo cáo khác có thời gian tạo cách đây hơn 60 ngày. Do đó, tài liệu hiện nêu rõ rằng các báo cáo được tạo trước khi thay đổi chính sách sẽ có sẵn trong tối đa 180 ngày.

    • Sau khi có 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 có thay đổi này, 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 cho 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 Dịch vụ API YouTube (mục III.E.4.b đến III.E.4.d), các ứng dụng API phải xoá hoặc làm mới siêu dữ liệu tài nguyên đã lưu trữ từ API đó sau 30 ngày.

  • Phần Đặ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 có chứa dữ liệu cho một 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 báo cáo được tạo.

  • Phần dữ liệu trong quá khứ trong phần tổng quan về API đã được cập nhật để lưu ý rằng khi bạn lên lịch cho một lệnh 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 này nêu rõ rằng có thể mất đến 30 ngày để các báo cáo đó xuất hiện.

  • Phần dữ liệu bổ sung trong phần 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

YouTube Analytics API (Truy vấn có mục tiêu) phiên bản 2 (v2) hiện đã được phát hành 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 v2 gần giống với API v1. Tuy nhiên, bạn có thể 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ể, những tên tham số có dấu gạch ngang, chẳng hạn như end-date trong API phiên bản 1, sẽ sử dụng kiểu chữ lạc đà (endDate) thay vì dấu gạch ngang 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 quy tắc đặt tên kiểu lạc đà cho tên tham số.
    • API phiên bản 2 không hỗ trợ các yêu cầu hàng loạt được gửi đến điểm cuối HTTP hàng loạt toàn cầu của Google (www.googleapis.com/batch). Nếu đang gửi các yêu cầu hàng loạt 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 nữa.
    • API phiên bản 2 không cung cấp một điểm cuối hàng loạt hỗ trợ các lô bao gồm các yêu cầu đối với 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ỉ dành riêng cho YouTube Analytics API vì Google đang ngừng sử dụng điểm cuối lô toàn cầu 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 này được hỗ trợ trong API phiên bản 1. Xin lưu ý rằng việc ngừng cung cấp này không dành riêng cho YouTube Analytics API.

  • Lưu ý: Đây là thông báo ngừng sử dụng.

    API phiên bản 1 (v1) hiện không được dùng nữa và sẽ được hỗ trợ cho đế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 đó, vui lòng nhớ nâng cấp lên API phiên bản 2 chậm nhất vào ngày 31 tháng 10 năm 2018 để tránh bị gián đoạn khả năng 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 API (Truy vấn có mục tiêu):

  • 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ụ của 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ó các thay đổi sau:

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

    • Giờ đây, phương diện operating_system (xác định hệ thống phần mềm của thiết bị mà trên đó lượt xem đã xảy ra) 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ó 2 thay đổi liên quan đến YouTube Reporting API:

  • 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 API. Mặc dù ứng dụng của bạn sẽ cần thêm thời gian CPU để giải nén các phản hồi API, nhưng lợi ích của việc sử dụng í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á bằng 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 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 sự thay đổi về chức năng hoặc hành vi của API. Cụ thể, những giá trị sau đây đã thay đổi:

    • Các giá trị cho phương diện age_group sử dụng chữ 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 ngang. Do đó, các giá trị như age13-17 và age18-24 đã được sửa thành AGE_13_17 và AGE_18_24.
    • Các giá trị cho phương diện gender sử dụng chữ cái viết 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 YouTube Analytics API. (Đồng thời, API này đã thêm tính năng hỗ trợ cho một chỉ số mới có tên là estimatedRevenue, cung cấp cùng một dữ liệu.)

Vì earnings là một chỉ số cốt lõi, 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, sau khi khoảng thời gian một năm đó kết thúc, chỉ số earnings sẽ không còn được hỗ trợ nữa. Do đó, các yêu cầu API chỉ định chỉ số earnings hiện 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 càng sớm càng tốt.

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ó các 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 thực tế rằng các 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ả các chỉ số đượ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à các giá trị cho tất cả chỉ số được yêu cầu chỉ có sẵn cho đế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 vẫn đúng ngay cả khi dữ liệu của một số chỉ số được yêu cầu có sẵn cho ngày 4 tháng 7 năm 2017.)

    • Hiện tại, phương diện adType hỗ trợ giá trị reservedBumperInstream. Giá trị này đề cập đến 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 khán giả xem video. Định dạng quảng cáo này giống với quảng cáo auctionBumperInstream, nhưng loại quảng cáo này đượ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 dạng video siêu ngắn đượ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 khán giả 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 dạng video siêu ngắn được bán theo hình thức đấu giá thay vì đặt trước.

    • Các tác vụ báo cáo cho những báo cáo sau đây của YouTube Reporting API đã 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

      Chúng tôi đã thông báo rằng các loại báo cáo này sẽ ngừng hoạt động vào ngày 15 tháng 9 năm 2016 và sau ngày 15 tháng 12 năm 2016, các báo cáo thuộc những loại báo cáo này sẽ không được tạo nữa. Các báo cáo được tạo trước đó vẫn có sẵn trong 180 ngày kể từ thời điểm tạo. Do đó, một số báo cáo có thể truy cập muộn nhất là 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 các tác vụ liên quan đến báo cáo cũng không cần thiết.

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

Tất cả các tác vụ báo cáo cho những báo cáo sau đây của YouTube Reporting API đều đã bị xoá:

  • content_owner_ad_performance_a1
  • content_owner_asset_estimated_earnings_a1
  • content_owner_estimated_earnings_a1

Những loại báo cáo này đã được thông báo là ngừng sử dụ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 những 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 đó vẫn có sẵn trong 180 ngày kể từ thời điểm tạo. Do đó, một số báo cáo có thể truy cập muộn nhất là 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 các tác vụ liên quan đến báo cáo cũng không cần thiết.

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

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

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

    • Phương diện sharing_service (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 việc 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

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

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

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

  • YouTube Analytics API hỗ trợ chỉ số redViews và estimatedRedMinutesWatched. Cả hai chỉ số này đều liên quan đến số người xem YouTube Red. Trên thực tế, API này đã hỗ trợ các chỉ số này trong một thời gian và YouTube Reporting API đã hỗ trợ cả hai chỉ số này như thông báo vào ngày 15 tháng 9 năm 2016.

    • Chỉ số redViews cho biết số lần video được thành viên YouTube Red xem.
    • Chỉ số estimatedRedMinutesWatched cho biết số phút mà thành viên YouTube Red đã xem một video.

    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 để cho biết những báo cáo nào hỗ trợ 2 chỉ số mới này. Các chỉ số này được hỗ trợ trong mọi báo cáo đã hỗ trợ chỉ số views và estimatedMinutesWatched.

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

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

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

    • Chúng tôi đã chỉnh sửa định nghĩa của phương diện date để lưu ý rằng giá trị phương diện đề cập đến khoảng thời gian bắt đầu từ 00:00 giờ Thái Bình Dương và kết thúc lúc 23:59 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 điều chỉnh đồng hồ sớm hơn sẽ đại diện cho khoảng thời gian 23 giờ và ngày điều chỉnh đồng hồ muộn hơn sẽ đạ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 mỗi ngày biểu thị 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 điều chỉnh này không thể hiện sự thay đổi trong hành vi thực tế của API.

    • Hiện tại, 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 đã xảy ra) 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 đều đã 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ó thể truy cập trong 180 ngày kể từ thời điểm tạo. Do đó, một số báo cáo có thể truy cập muộn nhất là vào 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 các tác vụ liên quan đến báo cáo cũng không cần thiết.

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

    • Chúng tôi đã chỉnh sửa nội dung mô tả về các phương diện liên quan đến time periods để lưu ý rằng giá trị phương diện đề cập đến khoảng thời gian bắt đầu từ 00:00 giờ Thái Bình Dương và kết thúc lúc 23:59 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 điều chỉnh đồng hồ sớm hơn sẽ đại diện cho khoảng thời gian 23 giờ và ngày điều chỉnh đồng hồ muộn hơn sẽ đạ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 phải là khoảng thời gian 24 giờ.)

      Xin lưu ý rằng nội dung điều chỉnh 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 về 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ỉ liên quan 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 API phải bao gồm dữ liệu về thời gian xem và số lượt xem của các kênh trong khoảng thời gian trước khi các kênh đó được liên kết với chủ sở hữu nội dung. Giá trị tham số mặc định là false. Điều này có nghĩa là theo mặc định, phản hồi API chỉ bao gồm dữ liệu về thời gian xem và số lượt xem kể từ thời điểm các 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 mà kênh đó được liên kết với chủ sở hữu nội dung.

    Điều quan trọng cần nhớ là 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 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 của 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. Đã có phiên bản mới hơn của từng báo cáo. (Thông báo về việc không dùng nữa đối với những 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ó các thay đổi sau:

YouTube Reporting API 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 đó. Các 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 ngừng phát.

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 liên quan đế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 dùng nữa 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

Giờ đây, YouTube 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 mục Báo cáo của YouTube Studio. Các báo cáo API do hệ thống quản lý mới được thiết kế để cung cấp quyền truy cập theo chương trình vào dữ liệu có trong các báo cáo có thể tải xuống theo cách thủ công của Creator 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 tác vụ để 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 từ quảng cáo hằng tháng 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 từ quảng cáo hằng tháng trên toàn thế giới cho mỗi tài sản
  • Doanh thu quảng cáo hằng ngày theo từng quốc gia trên mỗi tài sản
  • 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 sử dụng.

Chỉ số uniques của API YouTube Analytics 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 hết 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 có những thay đổi sau đây đối với YouTube Reporting API:

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

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

  • Báo cáo content_owner_basic_a1 đã hoàn toàn không được dùng nữa 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, mặc dù các báo cáo đã được tạo vẫn sẽ có hiệu lực trong 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ư được 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ó các thay đổi sau:

  • Điều khoản dịch vụ mới của Các dịch vụ API YouTube ("Điều khoản mới cập nhật") được công bố và thảo luận chi tiết trên Blog kỹ thuật và phát triển của YouTube, cung cấp một loạt 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 mới 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úp 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 mới 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ý nhận 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 sử dụng.

      Các chỉ số trong bảng sau đây sẽ không được dùng nữa. Đồng thời, các chỉ số mới liên quan đến cùng một dữ liệu cũng đang được ra mắ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 earnings là một chỉ số cốt lõi, nên chỉ số này 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 hết 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ỉ số cpm sẽ được hỗ trợ.

    • Phương diện insightTrafficSourceType hỗ trợ 2 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 số lượt xem đến từ những video đã được xác nhận quyền sở hữu do người dùng tải lên mà 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 số 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 đều xác định video mà người xem được giới thiệu đến.

    • Hiện tại, phương diện adType hỗ trợ giá trị auctionBumperInstream. Giá trị này đề cập đến 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 khán giả 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. Chỉ số này cho biết số lượt xem đến từ những video đã được xác nhận quyền sở hữu do người dùng tải lên mà 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 số 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 mà người xem được giới thiệu đến.

    • Danh sách chỉ số chính của API đã được điều chỉnh để liệt kê estimated_partner_revenue là chỉ số chính và xoá earnings khỏi danh sách đó. (Chỉ số earnings chưa bao giờ được hỗ trợ trong YouTube Reporting API.)

    • Hiện tại, phương diện ad_type hỗ trợ giá trị 19. Giá trị này đề cập đến quảng cáo đệm (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 khán giả 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)

    • Chúng tôi đã cập nhật danh sách các chỉ số được hỗ trợ cho báo cáo kênh sau đây để bổ sung các chỉ số về thẻ. Trên thực tế, chúng tôi đã thêm tính năng hỗ trợ chỉ số thẻ vào các báo cáo này từ ngày 28 tháng 6 năm 2016 và mục nhập 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 là:
      • 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 tại 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ý đối với các tỉnh
      • Các video hàng đầu theo tiểu bang
      • Video hàng đầu dành cho 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 tỷ lệ giữ chân khán giả của kênh và báo cáo tỷ lệ giữ chân khán giả của chủ sở hữu nội dung để phản ánh 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 này đề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 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 xuống của báo cáo đã được 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ó một hàng tiêu đề nhưng không có dữ liệu bổ sung. Thông tin này đã được cập nhật trong phần Đặc điểm của báo cáo của cùng một tài liệu 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 để phản ánh rằng báo cáo này sử dụng phương diện card_id. Trước đây, tài liệu này đã liệt kê 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ợ các chỉ số về thẻ trong nhiều báo cáo kênh và chủ sở hữu nội dung. Các chỉ số mới được hỗ trợ là: