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 đề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 ký nhật ký thay đổi này. Đăng ký

Ngày 6/5/2024

YouTube Analytics (Truy vấn được nhắm mục tiêu) hỗ trợ ba báo cáo mới cho kênh:

Ngoài ra, thẻ Đối tượng Chúng tôi đã cải thiện báo cáo Tỷ lệ giữ chân người dùng để hỗ trợ ba chỉ số mới:

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

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

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

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

    isCurated không được dùng nữa trong báo cáo danh sách phát của chủ sở hữu nội dung. 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 bạn xoá isCurated Bạn cũng phải cập nhật mã của mình để truy xuất chỉ số playlistViews thay cho chỉ số views chỉ dành cho báo cáo danh sách phát. Do views vẫn được hỗ trợ cho báo cáo danh sách phát, mặc dù với một ý nghĩa khác, API sẽ vẫn 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 là không còn được hỗ trợ trong các báo cáo mới:

    • Các bộ lọc vị trí, chẳng hạn như continent và subcontinent thì không được hỗ trợ cho báo cáo danh sách phát trên kênh mới.
    • Chỉ số redViews và estimatedRedMinutesWatched không còn tồn tại nữa được hỗ trợ cho báo cáo danh sách phát trên kênh mới. Những chỉ số này không có trong YouTube Studio, vì vậy, thay đổi này điều chỉnh chức năng 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 tồn tại nữa được hỗ trợ làm bộ lọc cho báo cáo danh sách phát trên kênh. Các bộ lọc này chưa áp dụng cho YouTube Studio nên thay đổi này để điều chỉnh chức năng của API cho phù hợp với chức năng có trong ứng dụng Studio.

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

    • Các chỉ số video tổng hợp cung cấp các chỉ số về lượt hiển thị và hoạt động của người dùng được tổng hợp cho tất cả các video trong danh sách phát của chủ sở hữu nội dung 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 là chỉ được hỗ trợ cho các 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 và mức độ tương tác của người dùng trong ngữ cảnh của trang danh sách phát. Các chỉ số này bao gồm cả dữ liệu về cũng sẽ bao gồm lượt xem của các video không thuộc sở hữu của bạn trong danh sách phát. chỉ khi những lượt xem đó xảy ra trong ngữ cảnh danh sách phát.
    • Các chỉ số được hỗ trợ của danh sách phát xác định các chỉ số video tổng hợp 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 đối với 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 các báo cáo không sử dụng phương diện isCurated. Xem tài liệu về chỉ số để định nghĩa của từng chỉ số:

  • Hành vi của views bây giờ 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:

    • Khi một yêu cầu bao gồm phương diện isCurated, Chỉ số views là một 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 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ố số lượt người xem đã xem video trong danh sách phát của chủ sở hữu nội dung, bất kể lượt xem trong bối cảnh danh sách phát. Tổng số được tổng hợp chỉ bao gồm số lượt xem của 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, việc không sử dụng phương diện isCurated, Chỉ số playlistViews cho biết số lần video được xem trong ngữ cảnh danh sách phát. Chỉ số đó tính lượt xem cho tất cả video trong danh sách phát, bất kể kênh sở hữu chúng là gì.

  • Đối với mỗi báo cáo danh sách phát, báo cáo của chủ sở hữu nội dung tài liệu hiện bao gồm các bảng hiển thị các chỉ số được hỗ trợ cho báo cáo đó, tuỳ thuộc vào liệu yêu cầu API có bao gồm phương diện isCurated hay không. 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

API (Truy vấn được nhắm mục tiêu) của YouTube Analytics có một số nội dung cập nhật liên quan đến danh sách phát trên kênh . 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 vài chỉ số mới và đã được cập nhật:

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

    isCurated đã bị ngừng sử 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ừ sau ngày 30 tháng 6 năm 2024. Định nghĩa của phương diện đó đã được cập nhật tương ứng.

    Để duy trì khả năng tương thích ngược khi bạn xoá isCurated Bạn cũng phải cập nhật mã của mình để truy xuất chỉ số playlistViews thay cho chỉ số views chỉ dành cho báo cáo danh sách phát. Do views vẫn được hỗ trợ cho báo cáo danh sách phát, mặc dù với một ý nghĩa khác, API sẽ vẫn 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 là không còn được hỗ trợ trong các báo cáo mới:

    • Các bộ lọc vị trí, chẳng hạn như continent và subcontinent thì không được hỗ trợ cho báo cáo danh sách phát trên kênh mới.
    • Chỉ số redViews và estimatedRedMinutesWatched không còn tồn tại nữa được hỗ trợ cho báo cáo danh sách phát trên kênh mới. Những chỉ số này không có trong YouTube Studio, vì vậy, thay đổi này điều chỉnh chức năng 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 tồn tại nữa được hỗ trợ làm bộ lọc cho báo cáo danh sách phát trên kênh. Các bộ lọc này chưa áp dụng cho YouTube Studio nên thay đổi này để điều chỉnh chức năng của API cho phù hợp với chức năng có trong ứng dụng Studio.

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

    • Các chỉ số video tổng hợp cung cấp các chỉ số về lượt hiển thị và hoạt động của người dùng được tổng hợp cho tất cả các video trong các danh sách phát của kênh cũng thuộc quyền sở hữu của kênh đó. Các chỉ số video tổng hợp là chỉ được hỗ trợ cho các 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 và mức độ tương tác của người dùng trong ngữ cảnh của trang danh sách phát. Các chỉ số này bao gồm cả dữ liệu về cũng sẽ bao gồm lượt xem của các video không thuộc sở hữu của bạn trong danh sách phát. chỉ khi những lượt xem đó xảy ra trong ngữ cảnh danh sách phát.
    • Các chỉ số được hỗ trợ của danh sách phát xác định các chỉ số video tổng hợp 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ề 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 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 isCurated phương diện. Xem tài liệu về chỉ số để định nghĩa của từng chỉ số:

  • Hành vi của views bây giờ 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:

    • Khi một yêu cầu bao gồm phương diện isCurated, Chỉ số views là một 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ố số lần video trong danh sách phát của kênh đã được xem, bất kể lượt xem trong bối cảnh danh sách phát. Tổng số được tổng hợp chỉ bao gồm số lượt xem của các 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, việc không sử dụng phương diện isCurated, Chỉ số playlistViews cho biết số lần video được xem trong ngữ cảnh danh sách phát. Chỉ số đó tính lượt xem cho tất cả video trong danh sách phát, bất kể kênh sở hữu chúng là gì.

  • Đối với mỗi báo cáo danh sách phát, báo cáo kênh tài liệu hiện bao gồm các bảng hiển thị các chỉ số được hỗ trợ cho báo cáo đó, tuỳ thuộc vào liệu yêu cầu API có bao gồm phương diện isCurated hay không. 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

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

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

YouTube Analytics (Truy vấn được nhắm 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 city mới phương diện này xác định ước tính của YouTube về thành phố nơi hoạt động của người dùng diễn ra.

  • creatorContentType mới phương diện xác định loại nội dung trên YouTube được liên kết với hoạt động của người dùng chỉ số trong hàng dữ liệu. Các giá trị được hỗ trợ: 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 chủ sở hữu nội dung và kênh.

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

  • Các tham chiếu đến phương diện 7DayTotals và 30DayTotals đã được đã 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 2019.

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

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

  • Trong API YouTube Analytics API (Truy vấn được nhắm mục tiêu), nếu insightTrafficSourceType giá trị của phương diện là SUBSCRIBER, thì phương diện 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 cho podcast.
  • Trong API Báo cáo (Báo cáo hàng loạt) của YouTube, nếu traffic_source_type giá trị của phương diện là 3, thì phương diện 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 cho 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 vào hoặc sau tháng 8 Ngày 11 tháng 1 năm 2022. Đâ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. Để phù hợp với Lùi Phần thay đổi không tương thích trong Điều khoản dịch vụ của Dịch vụ API YouTube. Thay đổi này được thông báo sáu tháng trước khi có hiệu lực. Vui lòng cập nhật phương thứ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ẻ.

Những thay đổi cụ thể đang được thực hiện là:

  • Trong API (Truy vấn được nhắm mục tiêu) của YouTube Analytics, Hiện có gender phương diện hỗ trợ hai giá trị: female và male. Từ ngày 11 tháng 8 năm 2022 trở đi, phương diện sẽ hỗ trợ 3 giá trị: female, male và user_specified.
  • Trong API Báo cáo (Báo cáo hàng loạt) của YouTube, Hiện có gender phương diện hỗ trợ 3 giá trị: FEMALE, MALE và GENDER_OTHER. Từ ngày 11 tháng 8 năm 2022, nhóm 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ừ đoạn video lặp lại lưu lượng truy cập kể từ Ngày 13 tháng 12 năm 2021. Thay đổi này ảnh hưởng đến cả API (Truy vấn được nhắm mục tiêu) của YouTube Analytics và API Báo cáo (Báo cáo hàng loạt) của YouTube.

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

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

  • Trong API Báo cáo (Báo cáo hàng loạt) của YouTube, traffic_source_type kích thước hỗ trợ giá trị 28.

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

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

API này của 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) hỗ trợ giá trị thứ nguyê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 vuốt dọc trong phần xem video ngắn trên YouTube:

  • Trong API (Truy vấn được nhắm mục tiêu) của YouTube Analytics, insightTrafficSourceType kích thước hỗ trợ giá trị SHORTS.
  • Trong API Báo cáo (Báo cáo hàng loạt) của YouTube, traffic_source_type kích thước hỗ trợ giá trị 24.

Phương diện chi tiết nguồn lưu lượng truy cập — insightTrafficSourceDetail trong API YouTube Analytics hoặc traffic_source_detail trong API Báo cáo của YouTube — không được điền sẵn dữ liệu 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

Trong lần cập nhật này, có hai thay đổi ảnh hưởng đến API (Truy vấn được nhắm mục tiêu) của YouTube Analytics:

  • Kích thước tối đa của một báo cáo trong YouTube Analytics group đã tăng từ 200 lên 500 thực thể.
  • của phương thức reports.query filters xác định danh sách các bộ lọc nên được áp dụng khi truy xuất YouTube Analytics . Tham số này hỗ trợ khả năng chỉ định nhiều giá trị cho video, playlist, và channel bộ lọc, và số lượng mã nhận dạng tối đa có thể được 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 nhắm 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 nguồn lưu lượng truy cập có thể có cho thông báo sẽ thay đổi. Trong truy vấn được nhắm mục tiêu, các thông báo được báo cáo là insightTrafficSourceType=NOTIFICATION. Trong báo cáo hàng loạt, các thông báo được báo cáo là traffic_source_type=17.

Các giá trị mới phân tách thông báo liên quan đến video được 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 bắt nguồn từ thông báo đẩy gửi đến số người đăng ký khi video được tải lên
  • uploaded_other – Lượt xem bắt nguồn từ thông báo không đẩy, chẳng hạn như email hoặc thông báo trong hộp thư đến, được gửi đến người đăng ký khi 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/1/2020 (ngày 13 tháng 1 năm 2020).

Ngoài ra, xin lưu ý rằng các giá trị này không thể hiện bản thân thông báo, mà thể hiện lưu lượng truy cập giúp tăng số lượt xem nhất định trên YouTube. Ví dụ: nếu một hàng trong báo cáo biểu thị views=3, traffic_source_type=17 (NOTIFICATION) và traffic_source_detail=uploaded_push, hàng này cho biết rằng có 3 chế độ xem có được do người xem nhấp vào thông báo đẩy được gửi đ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 nhắm mục tiêu):

  • Lưu ý: Đây là thông báo về việc 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. Kể từ ngày đó, hệ thống sẽ trả về một lỗi khi cố gắng truy xuất báo cáo bằng phương diện 7DayTotals hoặc 30DayTotals.

    Xin lưu ý rằng người dùng có thể tái tạo một số dữ liệu cho những phương diện này bằng cách truy vấn thông qua 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ụ:

    • Số lượt xem trong khoảng thời gian bảy ngày có thể được tính bằng cách tổng hợp số lượt xem từ mỗi ngày trong khoảng thời gian đó.
    • Tỷ lệ phần trăm của người xem trong khoảng thời gian 7 ngày có thể được tính bằng cách nhân số lượt xem đã xuất hiện mỗi ngày với tỷ lệ phần trăm của người xem của ngày đó để biết được 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ộ thời gian rồi chia cho tổng số lượt xem trong khoảng thời gian đó để tính tỷ lệ phần trăm người xem trong toàn bộ thời gian.
    • Số người xem riêng biệt trong khoảng thời gian 7 ngày không thể tính được vì cùng một người xem có thể được tính thành một người xem riêng biệt vào các 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 theo lịch trong khi phương diện 30DayTotals tính toán khoảng thời gian 30 ngày dựa trên ngày bắt đầu và ngày kết thú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 API YouTube Analytics (Truy vấn được nhắm mục tiêu):

  • 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á thông tin tham chiếu đến phiên bản đó, bao gồm cả thông báo về việc ngừng sử dụ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 API YouTube Analytics (Truy vấn được nhắm mục tiêu):

  • Phiên bản 1 của API này hiện đã không được dùng nữa. Vui lòng cập nhật các ứ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 nếu bạn chưa thực hiện 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 cho việc ngừng sử dụng này được thông báo ban đầ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 API YouTube Analytics (Truy vấn được nhắm mục tiêu):

  • Phần ẩ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 đáp ứng một ngưỡng nhất định. Điều này có thể xảy ra trong nhiều trường hợp. Trong 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 hạn chế trong một khoảng thời gian nhất định,

      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ó các giá trị không đáp ứng ngưỡng nhất định.

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

  • Tài liệu trong báo cáo kênh và báo cáo của chủ sở hữu nội dung đã được cập nhật để phản ánh thực tế là chỉ số redViews và estimatedRedMinutesWatched không còn được hỗ trợ cho báo cáo 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 đây đối với API YouTube Analytics (Truy vấn được nhắm mục tiêu):

  • Yêu cầu về phạm vi cho 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:
      • https://www.googleapis.com/auth/youtubephạm vi
        hoặc
      • https://www.googleapis.com/auth/youtube.readonly phạm vi
        và
        phạm vi https://www.googleapis.com/auth/yt-analytics.readonly

      Tùy chọn đầu tiên sử dụng một phạm vi, là phạm vi đọc-ghi, trong khi tùy 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 đây đối với API YouTube Analytics (Truy vấn được nhắm mục tiêu):

  • Tổng quan về API có một phần mới là tổng hợp các chỉ số và các mục đã xoá, giải thích cách phản hồi của API xử lý dữ liệu liên quan đến tài nguyên đã xoá, chẳng hạn như video, danh sách phát hoặc kênh.
  • Chúng tôi đã cập nhật phần các phương pháp hay nhất trong phần Tổng quan về API để 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 những tài nguyên được xác định trong các 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 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 được lưu trữ của 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 (Báo cáo hàng loạt) của YouTube:

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

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

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

    • Sau khi thay đổi, khi bạn lên lịch 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 gian công việc đã lên lịch. Trước khi có sự 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 các báo cáo trong khoảng thời gian 180 ngày trước thời gian lên lịch cho công việc đó.

  • Chúng tôi đã cập nhật phần các phương pháp hay 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 những 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 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 được lưu trữ của API đó sau 30 ngày.

  • Chúng tôi đã cập nhật phần Đặc điểm báo cáo để lưu ý rằng mặc dù dữ liệu báo cáo không được lọc, nhưng các báo cáo chứa dữ liệu trong hoặc sau ngày 1 tháng 6 năm 2018 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ị xóa ít nhất 30 ngày trước ngày tạo báo cáo.

  • Chúng tôi đã cập nhật mục dữ liệu trong quá khứ trong mục tổng quan về API để 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 trước đây thường được đăng trong vòng vài ngày. Trước đây, tài liệu nêu rõ rằng có thể mất đến 30 ngày để các báo cáo đó hiển thị.

  • Mục dữ liệu bổ sung của tổng quan về API đã được cập nhật để xác định rõ hơn dữ liệu bổ sung là tập dữ liệu thay thế tập đã 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 nhắm mục tiêu) (phiên bản 2) hiện đã ra mắt công khai. Danh sách sau đây xác định các thay đổi đối với 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 phải cập nhật mã của mình để phản ánh các thay đổi được liệt kê dưới đây. Tất cả những thay đổi này đượ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 này đã 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ập nhật tên. Cụ thể, tên tham số có chứa dấu gạch nối, như end-date trong API phiên bản 1 hãy sử dụng kiểu viết lạc đà (endDate) thay vì dấu gạch nối trong API v2. Thay đổi này làm cho tên tham số nhất quán trên toàn bộ API vì phương thức tạo và quản lý các nhóm của API đã sử dụng cách viết hoa camel 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 theo lô HTTP chung của Google (www.googleapis.com/batch). Nếu đang gửi 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 v2:

    • 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 đ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 đến các phương thức khác nhau của cùng một API.) Việc ngừng sử dụng này không chỉ liên quan đến API YouTube Analytics vì Google sẽ 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 v2 không hỗ trợ giao thức JSON-RPC được hỗ trợ trong API phiên bản 1. Xin nhắc lại rằng việc ngừng sử dụng này không chỉ ảnh hưởng đến API YouTube Analytics.

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

    Phiên bản 1 của API (v1) hiện không được dùng nữa và sẽ được hỗ trợ cho đến ngày 31 tháng 10 năm 2018. Tất cả các yêu cầu đối với API phiên bản 1 sẽ ngừng hoạt động sau ngày đó. Vì vậy, hãy nhớ nâng cấp lên API v2 muộn nhất vào 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 này.

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

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

  • Báo cáo nhân khẩu học của người xem, trong đó 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, không còn hỗ trợ phương diện youtubeProduct dùng để 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:

  • API Báo cáo của YouTube (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ị có lượt xem xuất hiện, hiện hỗ trợ giá trị sau:
      • 25: KaiOS

  • YouTube Analytics API (Cụm từ tìm kiếm được nhắm 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ợ nén gzip cho các yêu cầu tải báo cáo xuống. Xin lưu ý rằng các loại yêu cầu API khác không hỗ trợ chức năng nén gzip. Việc bật tính năng nén gzip sẽ làm giảm băng thông cần thiết cho mỗi phản hồi API. Đồng thời, mặc dù ứng dụng sẽ cần thêm thời gian của CPU để giải nén các phản hồi 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 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ề các phương diện age group và gender đã được chỉnh sửa để thể hiện các giá trị thực tế mà API trả về cho các phương diện đó. Lưu ý rằng đây là nội dung sửa đổi theo tài liệu và không phản ánh thay đổi về chức năng hay hành vi của API. Cụ thể là các giá trị sau đã thay đổi:

    • Các giá trị của phương diện age_group sử dụng chữ hoa, chứa dấu gạch dưới giữa từ AGE và 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 sửa thành AGE_13_17 và AGE_18_24 tương ứng.
    • Giá trị của phương diện gender sử dụng chữ 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 cũng hỗ trợ thêm 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à chỉ số chính nên chúng tôi đã hỗ trợ chỉ số này trong một năm kể từ ngày thông báo. Tuy nhiên, hiện tại, khoảng thời gian một năm đó đã kết thúc, do đó, 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 của mình để 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 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 (Cụm từ tìm kiếm được nhắm mục tiêu)

    • Tài liệu về API đã được cập nhật để phản ánh thực tế là 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ả chỉ số được truy vấn đều có sẵn.

      Ví dụ: nếu 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ả các chỉ số được yêu cầu chỉ có sẵn đến hết ngày 3 tháng 7 năm 2017, thì đó sẽ là ngày cuối cùng 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à một 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 có thể xem video. Định dạng quảng cáo giống với quảng cáo auctionBumperInstream, nhưng loại quảng cáo này đề cập đến những quảng cáo được bán theo hình thức đặt trước chứ không phải đấu giá.

  • API Báo cáo của YouTube (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 phương thức đặt trước. Quảng cáo đệm 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 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 trên phiên đấu giá thay vì trên cơ sở đặt trước.

    • Công việc báo cáo cho các 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

      Các loại báo cáo này được thông báo là không dùng nữa kể từ ngày 15 tháng 9 năm 2016 và hệ thống không còn tạo báo cá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 180 ngày kể từ thời điểm tạo. Do đó, chúng tôi vẫn có thể truy cập một số báo cáo 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 tồn tại nữa nên công việc 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ông việc báo cáo cho các báo cáo sau đây của YouTube Reporting API đã 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à không dùng nữa kể từ ngày 22 tháng 6 năm 2016 và hệ thống không còn tạo báo cá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 180 ngày kể từ thời điểm tạo. Do đó, chúng tôi vẫn có thể truy cập một số báo cáo 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 tồn tại nữa nên công việc 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ó những thay đổi sau:

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

    • Phương diện sharing_service xác định dịch vụ dùng để chia sẻ video, hiện hỗ trợ các giá trị sau:

      • 85: YouTube Music
      • 86: YouTube Trò chơi
      • 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õ ràng hơn giá trị này với giá trị 73 (Câu chuyện Kakao). 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 (Cụm từ tìm kiếm được nhắm 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, 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 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ó 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:

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

    • Định nghĩa của phương diện date đã được sửa đổi để lưu ý rằng giá trị phương diện đề cập đến khoảng thời gian bắt đầu từ 12 giờ sáng theo giờ Thái Bình Dương và kết thúc lúc 11:59 đêm. 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 sẽ là UTC-7 hoặc UTC-8.

      Mặc dù ngày thường biểu thị khoảng thời gian 24 giờ, nhưng ngày khi đồng hồ được điều chỉnh về phía trước biểu thị khoảng thời gian 23 giờ và ngày khi đồ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ờ duy nhất và giờ Thái Bình Dương luôn là giờ UTC-8.)

      Xin lưu ý rằng sự điều chỉnh này không thể hiện 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ị có lượt xem xuất hiện, hiện hỗ trợ các giá trị sau:
      • 22: Tizen
      • 23: Firefox
      • 24: RealMedia

    • Tất cả công việc 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. Tuy nhiên, các báo cáo content_owner_basic_a1 được tạo trước đó vẫn tồn tại trong 180 ngày kể từ thời điểm tạo báo cáo. Do đó, chúng tôi vẫn có thể truy cập một số báo cáo muộn nhất 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 tồn tại nữa nên công việc liên quan đến báo cáo cũng không cần thiết.

  • YouTube Analytics API (Cụm từ tìm kiếm được nhắm mục tiêu)

    • Nội dung mô tả về các phương diện liên quan đến time periods đã được sửa đổi để lưu ý rằng giá trị phương diện đề cập đến khoảng thời gian bắt đầu từ 0 giờ sáng theo giờ Thái Bình Dương và kết thúc lúc 11:59 đêm. 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 sẽ là UTC-7 hoặc UTC-8.

      Mặc dù ngày thường biểu thị khoảng thời gian 24 giờ, nhưng ngày khi đồng hồ được điều chỉnh về phía trước biểu thị khoảng thời gian 23 giờ và ngày khi đồ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ằ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 sự điều chỉnh này không thể hiện 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). Lưu ý rằng thông số này chỉ liên quan khi truy xuất báo cáo của chủ sở hữu nội dung.

Thông 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 nên bao gồm các kênh thời gian xem và lượt xem dữ liệu 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ị thông số mặc định là false, nghĩa là theo mặc định, phản hồi của API chỉ bao gồm dữ liệu thời gian xem và lượt xem từ thời điểm các kênh được liên kết với chủ sở hữu nội dung.

Những 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ị thông số là false thì dữ liệu thời gian xem và lượt xem mà hệ thống trả về cho một kênh cụ thể sẽ dựa trên ngày liên kết kênh đó với chủ sở hữu nội dung.

    Bạn cần nhớ rằng nhiều kênh có thể đã 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à lượt xem dựa trên ngày liên kết cho 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 lượt xem và thời gian 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. Đã có phiên bản mới hơn của mỗi báo cáo. (Thông báo về việc 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ợ ba báo cáo màn hình kết thúc mới 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à số lượt nhấp cho những màn hình kết thúc xuất hiện sau khi video ngừng phát.

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

      • Báo cáo màn hình kết thúc cho video trên kênh chứa số liệu thống kê cho tất cả video của một kênh.
      • Báo cáo màn hình kết thúc cho video của chủ sở hữu nội dung chứa số liệu thống kê cho video trên bất kỳ kênh nào của chủ sở hữu nội dung.
      • Báo cáo màn hình kết thúc cho thành phần của chủ sở hữu nội dung chứa số liệu thống kê về các tài sản được liên kết với các video mà sau đó màn hình kết thúc hiển thị.

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

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

    • Chỉ số màn hình kết thúc

      Lưu ý: Chỉ số màn hình kết thúc có dữ liệu kể 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ủa bạn.

    • Các báo cáo sau đây không còn được hỗ trợ nữa và đã bị xoá khỏi tài liệu. Đã có phiên bản mới hơn của mỗi báo cáo. (Thông báo về việc ngừng cung cấp 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 đây đối với API YouTube Analytics:

    • 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ợ nữa. 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 dữ liệu đã được hỗ trợ. Bảng bên dưới hiển thị tên chỉ số không 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

    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 mới về API 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ác báo cáo này 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 báo cáo 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 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 qua API:

    • Doanh thu quảng cáo trên mỗi video trên toàn thế giới, hằng tháng
    • Doanh thu quảng cáo hằng ngày theo quốc gia trên mỗi video
    • Doanh thu quảng cáo trên mỗi tài sản trên toàn thế giới, hằng tháng
    • Doanh thu quảng cáo hằng ngày theo 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 về việc ngừng sử dụng.

    Chỉ số uniques của API YouTube Analytics đã ngừng hoạt động. Đâ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 về YouTube Reporting API:

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

      • red_views: Số lần các thành viên YouTube Red xem một video.
      • red_watch_time_minutes: Số phút mà các thành viên YouTube Red đã xem một video.

    • 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ợ chỉ số red_views và red_watch_time_minutes mới.

      Đối với mỗi báo cáo, số trong mã loại báo cáo mới nhiều hơn một số so với mã loại báo cáo cũ. (Phiên bản cũ của các báo cáo này hiện không còn được dùng nữa như được mô tả ở phần sau trong lịch sử sửa đổi này.) Ví dụ: báo cáo channel_basic_a1 hiện không được dùng nữa và được thay thế bằng báo cáo channel_basic_a2.

      Các 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 về việc ngừng sử dụng.

      Lưu ý rằng nếu bạn đã có công việc để tạo bất kỳ phiên bản cũ hơn nào của các báo cáo được liệt kê ở trên, bạn cần phải tạo công việc mới cho các báo cáo đã được đổ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 không còn được dùng nữa:

      • 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 bạn có việc làm cho bất kỳ báo cáo nào trong số đó, thì có thể sau ngày 15 tháng 12 năm 2016, YouTube sẽ tạo báo cáo mới cho các việc làm đó. Các báo cáo đã tạo sẽ vẫn được cung cấp trong 180 ngày kể từ ngày tạo.

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

    Bản cập nhật này có thay đổi sau đây về API Báo cáo của YouTube:

    • Báo cáo content_owner_basic_a1 hiện không còn đượ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 sẽ vẫn có sẵn trong 180 ngày kể từ khi được tạo.

      Thay thế của báo cáo content_owner_basic_a1 là báo cáo content_owner_basic_a2 như đã giải thích trong mục nhật ký sửa đổi vào 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 xuất bản của Dịch vụ API YouTube ("Điều khoản mới") được thảo luận chi tiết trên Blog Nhà phát triển và Kỹ thuật của YouTube, cung cấp một loạt nội dung cập nhật phong phú cho Điều khoản dịch vụ hiện tại. Ngoài Điều khoản đã cập nhật có hiệu lực từ ngày 10 tháng 2 năm 2017, bản 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ủ.

      Toàn bộ tài liệu mới được mô tả trong nhật ký sửa đổi trong các Đ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ý nhận thông tin về các thay đổi liên quan đến danh sách nguồn cấp dữ liệu RSS 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 (Cụm từ tìm kiếm được nhắm mục tiêu)

      • Lưu ý: Đây là thông báo về việc 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, chúng tôi cũng đang ra mắt các chỉ số mới dựa trê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 khi các ngày ngừng sử dụ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ố chính nên sẽ được hỗ trợ trong một năm kể từ ngày đưa ra thông báo này. 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, 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. Thẻ này cho biết số lượt xem bắt nguồn từ các video do người dùng tải lên và được xác nhận quyền sở hữu mà chủ sở hữu nội dung đã dùng để quảng cáo nội dung đã xem.
        • END_SCREEN: Dữ liệu liên quan đến các 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à từ đó người xem được giới thiệu.

      • Phương diện adType hiện hỗ trợ giá trị auctionBumperInstream, tức là một 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 có thể xem video.

    • API Báo cáo của YouTube (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. Thẻ này cho biết số lượt xem bắt nguồn từ các video do người dùng tải lên và được xác nhận quyền sở hữu mà chủ sở hữu nội dung đã dùng để quảng cáo nội dung đã xem.
        • 20: Dữ liệu liên quan đến các 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à từ đó người xem được giới thiệu.

      • Danh sách chỉ số chính của API đã được chỉnh sửa để liệt kê estimated_partner_revenue làm chỉ số chính và xoá earnings khỏi danh sách đó. (Chỉ số earnings chưa từng được hỗ trợ trong API Báo cáo của YouTube.)

      • Phương diện ad_type hiện hỗ trợ giá trị 19 đề cập đến quảng cáo đệm. Đây là những 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 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 (Cụm từ tìm kiếm được nhắm mục tiêu)

      • Danh sách các chỉ số được hỗ trợ cho các báo cáo kênh sau đây đã được cập nhật để thêm các chỉ số thẻ. Chúng tôi thực sự đã thêm hỗ trợ cho các chỉ số thẻ trong các báo cáo này vào ngày 28 tháng 6 năm 2016. Mục nhập lịch sử sửa đổi cho ngày đó giải thích thay đổi chi tiết hơn. 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 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
        • Những video thu hút nhiều người xem đã đăng ký hoặc chưa đăng ký nhất

      • Chúng tôi đã điều chỉnh danh sách bộ lọc cho cả báo cáo tỷ lệ giữ chân người xem của kênh và báo cáo tỷ lệ giữ chân người xem 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 đã trình bày không chính xác rằng có thể truy xuất báo cáo bằng cách sử dụng một trong hai bộ lọc đó hoặc không sử dụng bộ lọc nào.

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

      • Trong phần Tổng quan về API, chúng tôi đã sửa phần giải thích cách truy xuất URL tải xuống của báo cáo để 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 đó chứa hàng tiêu đề nhưng không chứa thêm dữ liệu. Thông tin này đã được cập nhật trong mục Đặ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 chỉnh sửa để 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 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ợ các chỉ số thẻ trong nhiều báo cáo của kênh và chủ sở hữu nội dung. Sau đây là các chỉ số mới được hỗ trợ:

    Chỉ số này được hỗ trợ trong các loại báo cáo sau:

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

    Bản cập nhật này có những thay đổi sau đây về API Báo cáo của YouTube. 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:

    • Chúng tôi đã cập nhật mục Đặc điểm báo cáo trong tổng quan về API để làm rõ rằng các báo cáo sẽ được cung cấp thông qua API trong 180 ngày kể từ thời điểm tạo báo cáo.

      Trước đây, tài liệu nêu rõ rằng các báo cáo có sẵn 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ì văn bản gốc 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ố những báo cáo đó cũng chứa các chỉ số mới và chỉ số đượ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 đổi tên giống với báo cáo 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 đây:

      Lưu ý rằng nếu bạn đã có công việc để tạo bất kỳ phiên bản cũ hơn nào của những báo cáo này, bạn cần phải tạo công việc mới cho các báo cáo đã được đổ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 báo cáo content_owner_ad_performance_a1, content_owner_estimated_earnings_a1 và content_owner_asset_estimated_earnings_a1 không còn được dùng nữa.

      Nếu bạn có việc làm cho bất kỳ báo cáo nào trong số các báo cáo đó, thì có thể sau ngày 22 tháng 9 năm 2016, YouTube sẽ tạo báo cáo mới cho các việc làm đó. Các báo cáo đã tạo sẽ vẫn được cung cấp trong 180 ngày kể từ ngày 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 tập hợp các báo cáo hiện có.

    • Tên của 2 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 chỉ là một bản sửa lỗi liên quan đến tài liệu và không phản ánh thay đổi về 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, lưu ý rằng chỉ số này chỉ xuất hiện trong 2 báo cáo không được dùng nữa cùng với 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 các 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 nhắc lại rằng chỉ số này chỉ xuất hiện trong 2 báo cáo không còn được dù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 các báo cáo đó.

    • Tài liệu về phương diện cho API Báo cáo đã đượ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 nữa. Hiện không có báo cáo nào có sẵn thông qua API hỗ trợ các phương diện này.

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

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

    • 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ó 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 hay 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, ngoài dự kiến có thể là sự thay đổi có thể gây lỗi.

      Cùng với việc phát hành báo cáo mới này, báo cáo content_owner_basic_a1 đã ngừng hoạt động. Nếu bạn có một công việc cho báo cáo đó, thì sau ngày 19 tháng 8 năm 2016, YouTube sẽ không tạo báo cáo mới cho công việc đó. Các báo cáo đã tạo sẽ vẫn được cung cấp trong 180 ngày kể từ ngày 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 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ẽ không được dùng nữa. Thuộc tính này chỉ có giá trị cho các 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 YouTube ngừng tạo báo cáo thuộc loại đó.

        Sau khi một loại báo cáo được thông báo là không dùng nữa, YouTube sẽ tạo các báo cáo thuộc loại đó trong ba 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 sẽ thông báo về việc không dùng báo cáo content_owner_basic_a1 nữa. Do đó, deprecateTime cho loại báo cáo đó chỉ định thời điểm là ngày 19 tháng 8 năm 2016. Sau thời điểm đó, YouTube sẽ ngừng tạo báo cáo thuộc loại đó.

      • 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 quan đến công việc không được dùng nữa hoặc nếu các 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 mà sau đó YouTube không tạo báo cáo mới cho công việc đó 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ả ở mục trước trong danh sách này.

    • Phương thức jobs.create hiện sẽ trả về một 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ực hiện được.

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

    Bản cập nhật này có các thay đổi sau đây, tất cả đều chỉ ảnh hưởng đến API Báo cáo của YouTube:

    • Giờ đây, YouTube tạo dữ liệu cho khoảng thời gian 180 ngày trước thời điểm lên lịch công việc báo cáo lần đầu tiên. Trước đây, API Báo cáo không phân phối bất kỳ dữ liệu trong quá khứ nào. Thay đổi này sẽ ảnh hưởng đến tất cả việc làm, bao gồm cả những công việc được tạo trước khi có thông báo này.

      Báo cáo trong quá khứ được đăng ngay khi có sẵn, mặc dù phải mất khoảng một tháng để tất cả dữ liệu trong quá khứ được đăng cho một công việc. Vì vậy, một tháng sau khi lên lịch công việc báo cáo, bạn sẽ có quyền truy cập vào dữ liệu trong khoảng 7 tháng. (Bạn phải đăng tất cả dữ liệu trong quá khứ về các việc làm được tạo trước khi có thông báo này trong vòng một tháng kể từ khi có 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 đó, các việc làm được tạo trước ngày 28 tháng 12 năm 2015 sẽ có dưới 180 ngày dữ liệu lịch sử.

      Những thay đổi này đều được giải thích trong phần dữ liệu trong quá khứ mới trên trang tổng quan về API Báo cáo.

    • Chúng tôi đã cập nhật phần đặc điểm báo cáo trong phần tổng quan về API Báo cáo của YouTube để bổ sung những thay đổi sau:

      • Giờ đây, tài liệu nêu rõ rằng các báo cáo sẽ có sẵn trong khoảng thời gian 180 ngày sau khi được tạo, do đó, các ứng dụng API có thể tải xuống. Trước đây, tài liệu nêu rõ rằng các 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 thực tế là 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. Các báo cáo đó sẽ chứa các hàng tiêu đề nhưng sẽ không chứa thêm dữ liệu.

    • API Báo cáo của YouTube sắp hỗ trợ một bộ báo cáo được hệ thống quản lý tự động, chứa dữ liệu về doanh thu từ quảng cáo hoặc dữ liệu doanh thu từ gói thuê bao YouTube Premium. Báo cáo này sẽ được cung cấp cho 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. 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 đó.

      Những thay đổi sau đây về API hiện đang được công bố để 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ả 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 các báo cáo do hệ thống quản lý cho chủ sở hữu nội dung YouTube và chủ sở hữu nội dung không thể sửa đổi hoặc xóa các công việc tạo ra các 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ó bao gồm các công việc trong báo cáo do hệ thống quản lý hay không. Giá trị mặc định của tham số này 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ỉ nên chứa các báo cáo nếu dữ liệu sớm nhất trong báo cáo trùng hoặc sau ngày được chỉ định. Tương tự, tham số startTimeBefore cho biết rằng phản hồi của API chỉ nên chứa các báo cáo nếu dữ liệu sớm nhất trong báo cáo là trước ngày được chỉ định.

        Không giống như thông số createdAfter của phương thức liên quan đến thời gian tạo báo cáo, các thông 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 tài nguyên này 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ó 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ố này là false.

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

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

    • 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 API YouTube Analytics, phương diện sharingService hỗ trợ các giá trị mới sau:
      • ANDROID_MESSENGER: Android Messenger
      • INBOX: Hộp thư đến của Google
      • 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ững thay đổi này ảnh hưởng đến cả API Báo cáo của YouTube và API của YouTube Analytics:

    API Báo cáo của YouTube

    • 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 lượt xem diễn ra trên trang chủ hoặc màn hình chính của YouTube, trong trang Kênh đăng ký của người dùng hoặc trong một tính năng duyệt web khác trên 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 rằng 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 số lượt xem xảy ra khi video đang được phát trong danh sách phát).

    API Analytics của YouTube

    • Phương diện insightPlaybackLocationType hỗ trợ hai giá trị phương diện mới:
      • BROWSE: Dữ liệu liên quan đến lượt xem diễn ra trên trang chủ hoặc màn hình chính của YouTube, trong trang Kênh đăng ký của người dùng hoặc trong một tính năng duyệt web khác trên YouTube.
      • SEARCH: 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 insightTrafficSourceType hiện hỗ trợ YT_PLAYLIST_PAGE làm giá trị phương diện. Giá trị này cho biết rằng 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 số lượt xem xảy ra khi video đang được phát trong 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 API YouTube Analytics đã được cập nhật để chỉ số thẻ không còn là chỉ số được hỗ trợ cho API đó nữa. (Không có báo cáo nào của API đó được ghi nhận là hỗ trợ bất kỳ chỉ số thẻ nào.)

    Xin lưu ý rằng bạn vẫn có thể truy xuất chỉ số thẻ bằng cách sử dụ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 của 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à API YouTube Analytics đều có thể xác định cụ thể những lượt xem xuất hiện qua thiết bị Chromecast.

    • Trong API Báo cáo của 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 đang được trả về trong báo cáo. Trước đây, các tên này được ghi nhận là clickable_annotation_impressions và closable_annotation_impressions.

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

    Luật pháp của Liên minh Châu Âu (EU) yêu cầu 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 ở Liên minh Châu Âu. 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 đã bổ sung 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ó các thay đổi sau đây, tất cả đều ảnh hưởng đến API YouTube Analytics:

    • YouTube Analytics API hiện hỗ trợ ba phương diện chi tiết mới về việc phát. Các phương diện này có thể được dùng trong nhiều báo cáo của chủ sở hữu nội dung và kênh:

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

      Tài liệu này được cập nhật để xác định các báo cáo chi tiết mới về việc phát video 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 cập nhật để lưu ý rằng bạn có thể tuỳ ý sử dụng một hoặc nhiều phương diện trong số 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 các báo cáo đã thay đổi để giúp bạn dễ dàng xác định các kiểu kết hợp phương diện, chỉ số và bộ lọc hợp lệ có thể dùng để truy xuất từng báo cáo. Bảng bên dưới giải thích "Loại thiết bị" báo cáo dành cho kênh, hiển thị định dạng mới:

      Nội dung
      Kích thước:
      Bắt buộc deviceType
      Sử dụng từ 0 trở lên ngày, liveOrOnDemand, subscribedStatus, youtubeProduct
      Chỉ số:
      Sử dụng 1 hoặc nhiều lượt xem, estimatedMinutesWatched
      Bộ lọc:
      Sử dụng 0 hoặc 1 quốc gia, tỉnh, châu lục, subContinent
      Sử dụng 0 hoặc 1 video, nhóm
      Sử dụng từ 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 cho báo cáo kênh và báo cáo của chủ sở hữu nội dung.

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

      Ví dụ: Giả sử một 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ã nhận dạng video xác định một video thuộc quyền sở hữu của một kênh khác, và một mã nhận dạng 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ề một lỗi, giờ đây máy chủ API sẽ bỏ hai video mà người dùng không thể truy cập và phản hồi của API chứa dữ liệu về 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 YouTube Analytics trống, thì API hiện sẽ trả về một tập dữ liệu trống thay vì một lỗi.

    • Giờ đây, phương thức groupItems.insert của YouTube Analytics API sẽ trả về lỗi (mã phản hồi HTTP 403) trái phép nếu bạn cố gắng thêm một thực thể vào một nhóm nhưng bạn không có quyền truy cập vào thực thể đó. Trước đây, API này lẽ ra đã cho phép bạn thêm thực thể vào nhóm, nhưng sau đó lại trả về một lỗi trái phép 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 API YouTube Analytics 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. Hãy đặt tham số pageToken của phương thức thành giá trị đó để truy xuất kết quả bổ sung.

    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 cho phương diện date của API Báo cáo YouTube đã được chỉnh sửa để phản ánh rằng những ngày đó tham chiếu đến khoảng thời gian 24 giờ, bắt đầu từ 12 giờ sáng theo giờ Thái Bình Dương (UTC-8). Trước đó, tài liệu nêu rằng ngày bắt đầu lúc 12:00 SA (giờ GMT).

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

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

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

      Chúng tôi cũng đã cập nhật các phương pháp hay nhất về API Báo cáo của YouTube để giải thích cách bạn có thể sử dụng thông số createdAfter để tránh phải xử lý cùng một báo cáo nhiều lần.

    • Tất cả định nghĩa của thuộc tính createTime của tài nguyên job cũng như các thuộc tính startTime, endTime và createTime của tài nguyên report đều đã được chỉnh 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ả các định nghĩa hiện đều phản ánh chính xác rằng giá trị của thuộc tính đều 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 API YouTube Analytics đã được cập nhật để bổ sung danh sách các giá trị phương diện có thể có. Danh sách này bao gồm một số dịch vụ mới được hỗ trợ.

      Định nghĩa của 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ị mới được hỗ trợ. Các giá trị enum lớn hơn 59 sẽ 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 của YouTube mới truy xuất các báo cáo dữ liệu hàng loạt chứa dữ liệu trong YouTube Analytics của một kênh hoặc chủ sở hữu nội dung. API 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 API Báo cáo của YouTube chứa một nhóm 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 một 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 nhiều 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, mỗi công việc xác định một báo cáo mà YouTube nên tạo. Sau khi bạn chuẩn bị công việc, YouTube sẽ tạo một báo cáo hằng ngày để bạn 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ờ duy nhất.

    • Tuy đây là hai API khác nhau, nhưng cả API YouTube Analytics và API Báo cáo của YouTube đều giúp nhà phát triển truy xuất dữ liệu của 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 đang đượ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 về cách 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 nhắm mục tiêu chứa tài liệu tham khảo và các nội dung khác dành riêng cho API YouTube Analytics.
      • Thẻ 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 sắp xếp lại nhằm mục đích giúp API dễ hiểu hơn. Do đó, những thay đổi này không mô tả các tính năng mới:

      • Tài liệu này 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 hiện có của chủ sở hữu nội dung. Trước đây, tài liệu có các trang riêng biệt 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 tìm cách giới thiệu rõ hơn về cách hoạt động của API này. 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ị trong báo cáo.

      • Phương thức reports.query của API mà bạn sử dụng để truy xuất báo cáo, hiện được ghi chép riêng. Thông tin trên trang đó trước đây đã có trên một số trang khác. Trang mới này được thiết kế để giúp bạn dễ dàng xác định thông tin cần gửi đ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 mà 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ố cốt lõi. 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 sửa lại để phản ánh thực tế là 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 chỉ ra 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 dùng nữa, báo cáo hiệu suất quảng cáo không còn hỗ trợ chỉ số monetizedPlaybacks và playbackBasedCpm nữa. Tuy nhiên, một số báo cáo video vẫn hỗ trợ những 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 là videosAddedToPlaylists và videosRemovedFromPlaylists. Danh sách các 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ợ chỉ số mới.

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

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

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

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

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

      Giá trị thông số là mã đơn vị tiền tệ gồm ba chữ cái theo ISO 4217. Giá trị mặc định là USD. Định nghĩa tham số chứa danh sách các mã đơn vị 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ợ tính năng tạo và quản lý các nhóm trong YouTube Analytics cũng như tính 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 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 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 để thê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 của tất cả các mặt hàng trong nhóm đó. Xin lưu ý rằng API này hiện không hỗ trợ tính năng tạo báo cáo cho nhóm thành phần.

      Truy cập vào Trung tâm trợ giúp của YouTube để biết thêm thông tin về các nhó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 không còn hỗ trợ phương diện show nữa.

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

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

    • API hiện 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 mã video, danh sách phát, kênh hoặc chương trình được phân tách bằng dấu phẩy mà phản hồi API sẽ được lọc ra. 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 tham số filters để biết toàn bộ thông tin chi tiết 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 vẫn có thể đặt tham số ids thành channel==CHANNEL_ID để truy xuất dữ liệu cho kênh cụ thể.)

    • API hiện hỗ trợ báo cáo danh sách phát, chứa số liệu thống kê có liên quan đến lượt xem video xảy ra trong ngữ cảnh của danh sách phát. Kênh và chủ sở hữu nội dung có thể sử dụng báo cáo danh sách phát.

      Tất cả báo cáo về danh sách phát đều hỗ trợ 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ả cá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ỉ thể hiện số lượt xem danh sách phát trên web.

      • playlistStarts: Số lần người xem bắt đầu phát một danh sách phát.
      • viewsPerPlaylistStart: Số lượt xem video trung bình xảy ra mỗi khi người dùng mở danh sách phát.
      • averageTimeInPlaylist: Khoảng thời gian trung bình ước tính (tính bằng phút) mà người dùng đã xem video trong danh sách phát sau khi danh sách phát bắt đầu 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. Bộ lọc này phải được đặt thành 1 (isCurated==1).

    • API hiện hỗ trợ báo cáo tỷ lệ giữ chân người xem. Báo cáo này đánh giá khả năng giữ chân người xem 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 về số người xem video tại một 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ượt xem của một phần video với tổng số lượt xem của video đó.

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

      • Chỉ số relativeRetentionPerformance cho biết khả năng giữ chân người xem của một video trong các lượt phát so với tất cả các video có thời lượng tương tự trên YouTube. Giá trị 0 cho biết video giữ chân người xem kém hơn bất kỳ video nào khác có thời lượng tương tự, trong khi giá trị 1 cho biết video giữ chân người xem tốt hơn bất kỳ video nào khác có thời lượng tương tự. Giá trị trung bình là 0,5 cho thấy một nửa số video có thời lượng tương tự giữ chân người xem hiệu quả hơn, còn một nửa số video 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 có liên quan đến lượt xem tự nhiên, lượt xem từ quảng cáo TrueView trong luồng 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ư lượt tìm kiếm video hoặc lượt 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 cùng với 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 thủ Chính sách về việc ngừng sử dụng. Tuy nhiên, xin lưu ý rằng các chỉ số mới có dữ liệu kể từ ngày 16 tháng 7 năm 2013. (Dữ liệu cho chỉ số annotationClickThroughRate và annotationCloseRate có sẵn kể 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 nữa. Thay vào đó, lượt giới thiệu từ kết quả tìm kiếm của 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ụ theo 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 của chủ sở hữu nội dung và kênh. Với 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 đã bao gồm các ví dụ mới để truy xuất dữ liệu cụ thể 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.

      • Chỉ số theo tỉnh cụ thể cho các tiểu bang của Hoa Kỳ và Washington D.C.: Báo cáo này truy xuất dữ liệu phân tích về số lượt xem và các số liệu thống kê khác theo từng tỉnh 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, đồng thời sử dụng tham số filters để hạn chế câu trả lời chỉ bao gồm kết quả tại 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 lấy 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 đã được xác nhận quyền sở hữu của chủ sở hữu nội dung (theo 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 câu trả lời chỉ chứa dữ liệu của một tỉnh cụ thể.

    • Chúng tôi đã cập nhật định nghĩa về phương diện province để lưu ý rằng khi province được đưa vào giá trị thông số dimensions, yêu cầu cũng phải giới hạn dữ liệu đối với Hoa Kỳ bằng cách thêm country==US vào giá trị thông 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:

    • Chúng tôi đã thiết kế lại các tài liệu liệt kê báo cáo kênh và báo cáo của chủ sở hữu nội dung được hỗ trợ. Thay vì cung cấp một bảng liệt kê tất cả cá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 các thẻ và bạn có thể nhấp vào thẻ bất kỳ để 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à Đặc khu Colombia. API hỗ trợ hai cách sử dụng cho phương diện này:

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

          • Báo cáo số liệu thống kê cốt lõi cung cấp một vài số liệu thống kê, bao gồm cả số lượt xem và số phút đã xem ước tính.
          • Báo cáo dựa trên thời gian cũng cung cấp số liệu thống kê tương tự 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 để hạn chế báo cáo chỉ chứa số liệu thống kê cho một trạng thái 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ột mã vùng thống kê của Liên Hợp Quốc (UN) xác định một châu lục. 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ột mã vùng 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 châu lục. 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ỉ được liên kết với một châu lục, nên bạn cũng không cần dùng bộ lọc continent khi 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:

    • API YouTube Analytics hiện phải tuân thủ Chính sách về việc ngừng cung cấp được nêu trong Điều khoản dịch vụ. Tuy nhiên, các phương diện không phải là phương diện chính và chỉ số không phải chính của API cũng không phải tuân theo 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 cập nhật để xác định rõ ràng các phương diện và chỉ số chính.

    • API này hiện hỗ trợ EXTERNAL_APP dưới dạng 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 lại 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 xảy ra trước ngày đó vẫn sẽ được phân loại với giá trị đó.

      Với bản 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 WATCH, EMBEDDED hoặc EXTERNAL_APP, tuỳ thuộc vào loại ứng dụng nơi lượt phát lại diễn ra.

    • API này hiện hỗ trợ PLAYLIST dưới dạng giá trị cho phương diện insightTrafficSourceType. Giá trị này cho biết lượt xem video đến từ danh sách phát. Trước đây, các 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 này 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 là Sắp xếp yêu cầu theo nhiều phương diện/chỉ số, thể hiện 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 thứ tự thời gian, nhưng trong nhóm kết quả cho mỗi ngày, hàng đầu tiên chứa dữ liệu cho 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 cho nguồn đã tạo ra số lượt xem cao nhất tiếp theo, v.v.

    • API này hiện hỗ trợ hai phương diện mới là deviceType và operatingSystem. Các phương diện này có thể dùng để truy xuất dữ liệu về các thiết bị mà người xem đang xem video của bạn. API này hỗ trợ những 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ể dùng bộ lọc operatingSystem để hạn chế 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 các hệ điều hành khác nhau, chẳng hạn như Android, iOS, Linux, v.v. Bạn cũng có thể sử dụng bộ lọc deviceType để hạn chế 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 về loại thiết bị và hệ điều hành mới có sẵn trên kênh và chủ sở hữu nội dung.

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

    • Phương diện insightPlaybackLocationType có thể trả về giá trị YT_OTHER, xác định các chế độ 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:

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

      Danh sách các 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. (Danh sách hiện tại thực sự ngắn hơn vì chỉ số thời gian xem có thể được truy xuất như một phần của các báo cáo được liệt kê khác.)

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

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

      • Chúng hiện hỗ trợ bộ lọc country không bắt buộc.

      • Chủ sở hữu nội dung hiện có thể truy xuất các báo cáo này bằng cách sử dụng bất kỳ cách kết hợp filter mới nào sau đây. Lưu ý rằng tất cả các kiểu kế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

        • Chi tiết 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 mới về Yêu cầu API mẫu 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ụ bao gồm một đoạn 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à thông số sắp xếp cho yêu cầu.

    • Phương diện insightTrafficSourceType hiện hỗ trợ SUBSCRIBER dưới dạng 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, trường insightTrafficSourceDetail sẽ chỉ định nguồn cấp dữ liệu trang chủ hoặc trang khác nơi lượt xem được giới thiệu.

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

      • Các báo cáo mới được hỗ trợ hỗ trợ 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ị. 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.

      • Dưới đây là danh sách các chỉ số mới được hỗ trợ. Danh sách báo cáo của chủ sở hữu nội dung đã được cập nhật để xác định báo cáo, bao gồm cả hai báo cáo mới có hỗ trợ các chỉ số này.

        • earnings – Tổng thu nhập ước tính từ tất cả nguồn quảng cáo mà Google đã bán.
        • grossRevenue – Tổng doanh thu ước tính từ các đối tác Google hoặ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 đối với các lượt phát lại video mà báo cáo đề cập, từ các đối tác của Google hoặc DoubleClick.
        • monetizedPlaybacks – Số lần phát lại có ít nhất một lần hiển thị quảng cáo.
        • playbackBasedCpm – Tổng doanh thu ước tính trên mỗi nghìn lần phát lại.
        • impressions – Số lần 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ần hiển thị quảng cáo.

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

      • 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 để các loại báo cáo khác nhau được giải thích trên các trang riêng biệt. Vì vậy, nay đã có các trang riêng giải thích các loại báo cáo về 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 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 chiếu 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 theo mô tả dưới đây. Mỗi báo cáo đượ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. 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 chỉ định số lượt xem video diễn ra trên các loại trang hoặc ứng dụng khác nhau.

      • Báo cáo chi tiết vị trí phát xác định các trình phát được nhúng tạo ra nhiều lượt xem nhất cho một video cụ thể. Báo cáo này cung cấp chế độ xem chi tiết hơn so với báo cáo vị trí phát bằng cách xác định URL được liên kết với các 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 đường liên kết giới thiệu khác nhau.

      • Báo cáo chi tiết nguồn lưu lượng truy cập xác định những đường liên kết giới thiệu tạo ra nhiều lượt xem nhất cho một video cụ thể và một loại nguồn lưu lượng truy cập được chỉ định. Ví dụ: báo cáo này có thể cho biết những video có liên quan mang lại nhiều lưu lượng truy cập nhất cho 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 cho biết lượng thời gian khán giả dành ra để xem nội dung của bạn. Các 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 báo cáo tổng hợp dữ liệu theo ngày hoặc theo 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 của mỗi video mà người dùng đã xem.

    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ả cá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 phải 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 để tạo 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:

    • Phần tìm hiểu về hạn mức sử dụng mới cung cấp các nguyên tắc để tối ưu hoá việc sử dụng hạn mức API. Máy chủ API sẽ tính toán chi phí truy vấn cho mỗi yêu cầu và chi phí đó sẽ được khấu trừ từ hạn mức sử dụng API của bạn. Do các loại báo cáo khác nhau có thể có chi phí truy vấn rất khác nhau, bạn nên lập 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.

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

      • 7DayTotals – Dữ liệu trong báo cáo sẽ được tổng hợp sao cho mỗi hàng đều có 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 sao cho mỗi hàng đều 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 hiện có đã được cập nhật để phản ánh hỗ trợ của API cho các báo cáo sử dụng các phương diện này.

    • Phần phương diện thực thể 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 những phương diện sau (video, channel hoặc show) hoặc kết hợp các phương diện claimedStatus và uploaderType được hỗ trợ.

    • API này hiện hỗ trợ 2 lựa chọn sắp xếp mới cho các 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 những 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ố lượng người dùng đã đăng ký hoặc huỷ đăng ký một kênh từ trang xem của 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ể thu hút hoặc mất người đăng ký ở một số vị trí, bao gồm cả trang xem video, trang kênh và hướng dẫn xuất hiện trên trang chủ YouTube. Khi các chỉ số này xuất hiện trong một báo cáo dành riêng cho video, chúng chỉ bao gồm số liệu thống kê từ trang xem của video cụ thể.