API Phát trực tiếp trên YouTube - Nhật ký sửa đổi

Trang này liệt kê các thay đổi đối với YouTube Live Streaming API và nội dung cập nhật trong tài liệu. Đăng ký nhận nhật ký thay đổi này. Đăng ký

Ngày 9 tháng 10 năm 2023

Chỉ để tham khảo, bạn có thể tìm thấy mã nhãn dán liên quan đến Super Stickers trong tệp CSV này. Các định nghĩa của thuộc tính snippet.superStickerDetails.superStickerMetadata.stickerId của tài nguyên liveChatMessage và thuộc tính snippet.superStickerMetadata.stickerId của tài nguyên superChatEvent đều đã được cập nhật để phản ánh thông tin này.

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

API hiện hỗ trợ một cách mới để chèn quảng cáo vào chương trình phát trực tiếp. Ngoài liveCuepoints cho phép bạn chèn điểm chèn quảng cáo vào sự kiện phát trực tiếp theo cách thủ công, YouTube hiện hỗ trợ một tính năng tự động chèn điểm chèn quảng cáo trong video vào sự kiện phát trực tiếp theo các khoảng thời gian cố định.

Nếu bật quảng cáo tự động, chủ sở hữu chương trình phát sóng có thể xem các khía cạnh sau đây của hành vi quảng cáo:

  • độ dài của khoảng thời gian giữa các điểm chèn quảng cáo trong video.
  • chiến lược lập lịch cho điểm tín hiệu quảng cáo. Bạn có thể chèn điểm tín hiệu đồng thời cho tất cả người xem hoặc thời điểm của điểm tín hiệu có thể khác nhau tuỳ theo người xem. Chiến lược thứ hai cho phép YouTube lên lịch điểm đánh dấu với tần suất cao hơn để người xem nhận được điểm đánh dấu khi họ đủ điều kiện.
  • khoảng thời gian mà quảng cáo trong video không xuất hiện. Đối với tính năng này, chủ sở hữu chương trình phát sóng chỉ định rằng tính năng chèn quảng cáo trong video sẽ bị tạm dừng cho đến một thời điểm cụ thể.

Tài liệu này phản ánh các thay đổi sau đây đối với API để hỗ trợ tính năng này:

  • Tài nguyên liveBroadcast hiện chứa một đối tượng monetizationDetails. Các trường của đối tượng cho biết liệu tính năng chèn quảng cáo tự động có được bật cho chương trình phát sóng hay không và chỉ định thêm thông tin để lên lịch điểm tín hiệu.
  • Tham số part của phương thức liveBroadcast.list hỗ trợ giá trị monetizationDetails.
  • Bạn có thể sử dụng phương thức update để tạm dừng việc chèn quảng cáo trong video trong một khoảng thời gian nhất định cho sự kiện phát trực tiếp. Giờ đây, tài liệu này cũng xác định một số lỗi có thể xảy ra khi cập nhật thông tin kiếm tiền cho một chương trình phát sóng trực tiếp.

Ngày 1 tháng 8 năm 2023

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

  • Phương thức liveBroadcasts.update không còn yêu cầu chỉ định giá trị cho các trường sau:

    • snippet.title
    • status.privacyStatus

    Việc bỏ qua các trường này khỏi yêu cầu sẽ không làm thay đổi các trường đó.

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

  • Phương thức liveBroadcasts.cuepoint mới cho phép mọi chủ sở hữu kênh đang chạy một chương trình phát sóng trực tiếp trên YouTube cũng có thể chèn điểm dừng vào chương trình phát sóng đó. Việc này có thể kích hoạt điểm chèn quảng cáo. Phương thức này thay thế phương thức liveCuepoints.insert vốn chỉ cho phép các đối tác nội dung của YouTube chèn điểm dừng vào các buổi phát sóng trực tiếp.

    Một số hướng dẫn đã được cập nhật để phản ánh việc phương thức mới này có sẵn hay không.

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

    Giờ đây, phương thức liveCuepoints.insert không được dùng nữa. Hỗ trợ cho phương thức liveCuepoints.insert sẽ bị xoá kể từ ngày 1 tháng 5 năm 2023. Thay vào đó, người dùng API nên cập nhật ứng dụng để gọi phương thức liveBroadcasts.cuepoint.

  • Tài liệu về phương thức liveBroadcasts.control đã bị xoá. Thông báo ngừng sử dụng phương thức đó đã được đăng vào tháng 9 năm 2020.

Ngày 1 tháng 10 năm 2022

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

  • Phương thức liveBroadcasts.update không còn yêu cầu chỉ định giá trị cho các trường sau:

    • contentDetails.enableContentEncryption
    • contentDetails.enableDvr
    • contentDetails.enableEmbed
    • contentDetails.recordFromStart
    • contentDetails.startWithSlate

    Việc bỏ qua các trường này khỏi yêu cầu sẽ không làm thay đổi các trường đó.

  • Xoá tài liệu về các trường liveBroadcast lỗi thời:

    • contentDetails.enableContentEncryption
    • contentDetails.startWithSlate

Ngày 1 tháng 4 năm 2022

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

  • Thuộc tính snippet.type hiện hỗ trợ hai giá trị mới:

    • membershipGiftingEvent
    • giftMembershipReceivedEvent

  • Thuộc tính snippet.membershipGiftingDetails mới của tài nguyên liveChatMessage và các thuộc tính con chứa thông tin về sự kiện Tặng gói thành viên. Tương tự, thuộc tính snippet.giftMembershipReceivedDetails mới và các thuộc tính con của thuộc tính này chứa thông tin về sự kiện Gift Membership Received (Đã nhận quà tặng gói thành viên).

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

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

  • Thuộc tính snippet.type hiện hỗ trợ hai giá trị mới:

    • newSponsorEvent
    • memberMilestoneChatEvent

  • Thuộc tính snippet.memberMilestoneChatDetails mới của tài nguyên liveChatMessage và các thuộc tính con của thuộc tính này chứa thông tin về sự kiện Tin nhắn ghi nhận cột mốc làm hội viên. Tương tự, thuộc tính snippet.newSponsorDetails mới và các phần tử con của thuộc tính này chứa thông tin về sự kiện Nhà tài trợ mới.

Ngày 1 tháng 12 năm 2020

Phương thức liveBroadcasts.transition của API hỗ trợ lỗi 403 (Forbidden) mới, cho biết rằng người dùng đã gửi quá nhiều yêu cầu trong một khung thời gian nhất định. Lý do lỗi là userRequestsExceedRateLimit.

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

  • Chúng tôi đã cập nhật định nghĩa của thuộc tính status.madeForKids của tài nguyên liveBroadcast để làm rõ rằng thuộc tính này chỉ có thể đọc. Điều này không phản ánh sự thay đổi trong chức năng của API.

    Để chỉ định một sự kiện phát trực tiếp là dành cho trẻ em, hãy đặt thuộc tính status.selfDeclaredMadeForKids thành true khi gọi phương thức liveBroadcasts.insert để tạo sự kiện phát trực tiếp.

  • Lưu ý: Thay đổi này bao gồm thông báo về việc ngừng sử dụng và thông tin cập nhật cho thông báo trước đó về việc ngừng sử dụng.

    Phương thức liveBroadcasts.control sẽ không được dùng nữa kể từ ngày 1 tháng 10 năm 2020. Sau ngày đó, tất cả lệnh gọi đến phương thức này sẽ trả về lỗi bị cấm (403) và sau đó, phương thức này sẽ bị xoá hoàn toàn. Ứng dụng vẫn có thể triển khai lịch phát sóng của riêng mình bằng cách thêm lớp phủ vào video được gửi đến máy chủ truyền dẫn của YouTube.

    Ngày ngừng sử dụng trong thông báo ngừng sử dụng được đưa ra vào ngày 16 tháng 4 năm 2020 (ban đầu dự kiến là ngày 1 tháng 9 năm 2020) đã được dời lại và hiện sẽ diễn ra vào hoặc sau ngày 1 tháng 10 năm 2020. Do đó, các tính năng có trong thông báo về việc ngừng sử dụng và phương thức liveBroadcasts.control sẽ cùng lúc không được dùng nữa.

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

Lưu ý: Đây là thông tin cập nhật cho thông báo trước đó về việc ngừng sử dụng.

Kể từ ngày 17 tháng 8 năm 2020, trường cdn.format của tài nguyên liveStream đã ngừng hoạt động từ tháng 4 năm 2016. Các yêu cầu vẫn sử dụng trường đó sẽ không thành công kể từ ngày đó.

Nếu mã của bạn vẫn sử dụng trường cdn.format, bạn phải cập nhật mã để chỉ định tốc độ khung hình và độ phân giải riêng biệt bằng cách sử dụng các thuộc tính cdn.frameRate và cdn.resolution.

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

Chúng tôi đã cập nhật hướng dẫn Phân phối nội dung phát trực tiếp trên YouTube qua HLS với một số thay đổi:

  • Thời lượng đề xuất cho một Phân đoạn nội dung nghe nhìn đã được cập nhật thành từ 1 đến 4 giây.
  • Một phần mới sẽ giải thích cách lấy URL truyền dẫn HLS qua YouTube Studio.
  • Hướng dẫn định dạng giá trị tham số file đã được chuyển sang phần mới là Hoàn tất URL truyền dẫn HLS. Các hướng dẫn này áp dụng bất kể URL truyền dẫn HLS được lấy từ API YouTube hay YouTube Creator Studio.

Ngoài ra, phần so sánh giao thức truyền dẫn mới liệt kê các giao thức truyền dẫn mà YouTube hỗ trợ, bộ mã hoá và giải mã được hỗ trợ cho từng giao thức, cũng như thông tin bổ sung về các trường hợp sử dụng phù hợp cho từng giao thức.

Ngày 16 tháng 4 năm 2020

Bản cập nhật này bao gồm một thuộc tính mới và thông báo về việc ngừng sử dụng:

  • Tài nguyên liveBroadcast hiện hỗ trợ thuộc tính contentDetails.enableAutoStop. Thuộc tính này cho biết liệu chương trình phát sóng có tự động dừng trong khoảng một phút sau khi chủ sở hữu kênh dừng phát trực tuyến video trên luồng video được liên kết hay không.

    Tài liệu về thời gian phát sóng đã được cập nhật để giải thích sự thay đổi của quy trình từng bước tạo và quản lý một sự kiện trực tiếp trên YouTube nếu bạn đặt thuộc tính contentDetails.enableAutoStart hoặc contentDetails.enableAutoStop thành true.

  • Lưu ý: Đây là thông báo về việc ngừng sử dụng. Những thay đổi này sẽ có hiệu lực kể từ ngày 1 tháng 9 năm 2020. Ngày thực tế mà các thay đổi có hiệu lực được gọi là ngày ngừng sử dụng.

    Bản cập nhật này giải thích về một thay đổi có thể gây lỗi. Chính sách này ảnh hưởng đến các ứng dụng API sử dụng tài nguyên liveStream và liveBroadcast mặc định của các kênh để phát trực tiếp nội dung trên YouTube. Cụ thể, mã thông báo truyền tin và mã luồng được liên kết với sự kiện phát và truyền tin liên tục sẽ không còn hoạt động để bắt đầu các tin truyền mới.

    Ứng dụng của bạn sẽ bị ảnh hưởng nếu có bất kỳ điều kiện nào sau đây:

    • Hàm này kiểm tra giá trị của thuộc tính isDefaultBroadcast của tài nguyên liveBroadcast. Thuộc tính này sẽ không được trả về sau ngày ngừng sử dụng.
    • Hàm này kiểm tra giá trị của thuộc tính isDefaultStream của tài nguyên liveStream. Thuộc tính này sẽ không được trả về sau ngày ngừng sử dụng.
    • Phương thức này gọi phương thức liveBroadcasts.list và đặt giá trị tham số broadcastType thành persistent hoặc all. Trong các thay đổi này, tham số này sẽ không được dùng nữa. Kể từ ngày ngừng sử dụng:
      • Nếu giá trị tham số broadcastType là persistent, thì phương thức liveBroadcasts.list sẽ không trả về kết quả nào.
      • Nếu giá trị tham số broadcastType là all, thì phương thức liveBroadcasts.list sẽ không trả về các thông báo truyền tin liên tục đã tồn tại trước thời điểm đó.

    Xin lưu ý rằng trong vài năm qua, YouTube đã tự động tạo một sự kiện phát trực tiếp và một sự kiện phát sóng mặc định cho một kênh khi kênh đó được bật tính năng phát trực tiếp. Sự kiện phát trực tiếp mặc định tồn tại vô thời hạn, không có thời gian bắt đầu hoặc kết thúc và không thể xoá được. Tương tự, thông báo truyền tin mặc định được coi là liên tục. Lớp này luôn tồn tại và không liên kết với một sự kiện cụ thể.

    Kể từ ngày ngừng sử dụng:

    • YouTube sẽ không tạo sự kiện trực tiếp và thông báo mặc định nữa. Thay vì dựa vào các tài nguyên mặc định, ứng dụng API cần có khả năng tạo và quản lý các tài nguyên liveBroadcast và liveStream cũng như liên kết các tài nguyên đó với nhau.
    • Nếu chương trình phát sóng mặc định và luồng phát trực tiếp mặc định của một kênh đang hoạt động, tức là kênh đó đang sử dụng các chương trình phát sóng đó cho một chương trình phát sóng trực tiếp tại thời điểm việc ngừng sử dụng có hiệu lực, thì chương trình phát sóng đang diễn ra sẽ không bị ảnh hưởng. Tuy nhiên, sau khi sự kiện phát trực tiếp đó kết thúc, kênh sẽ không thể sử dụng lại sự kiện phát trực tiếp và luồng mặc định.
    • Nếu chương trình phát sóng mặc định và luồng phát mặc định của một kênh không hoạt động, thì sau khi việc ngừng sử dụng có hiệu lực, YouTube sẽ bỏ qua các nỗ lực sử dụng các tài nguyên đó để phát video.

    Nếu ứng dụng của bạn bị ảnh hưởng, vui lòng tham khảo các tài liệu sau đây để cập nhật ứng dụng của bạn sao cho ứng dụng vẫn hoạt động như mong đợi sau khi thay đổi này:

    • Hướng dẫn di chuyển mới cố gắng giải thích các bước mà nhà phát triển có thể cần giải quyết trong các ứng dụng API hiện đang sử dụng các luồng và thông báo truyền tin mặc định.
    • Hướng dẫn Vòng đời của một chương trình phát sóng sẽ hướng dẫn bạn từng bước giải thích cách tạo và quản lý một sự kiện trực tiếp trên YouTube. Mỗi bước giải thích các lệnh gọi API hoặc những việc khác mà bạn cần làm để hoàn tất một hành động cụ thể. Ứng dụng của bạn sẽ cần tuân theo quy trình đó khi YouTube ngừng hỗ trợ các luồng và sự kiện phát trực tiếp mặc định.

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

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

Ngừng sử dụng tài nguyên sponsor và phương thức sponsors.list, thay vào đó là tài nguyên member và phương thức members.list.

Chúng tôi sẽ ngừng hỗ trợ phương thức sponsors.list kể từ ngày 30 tháng 9 năm 2020. Ứng dụng API nên cập nhật các lệnh gọi đến phương thức sponsors.list để sử dụng phương thức members.list. Vui lòng xem nhật ký sửa đổi API Dữ liệu YouTube để biết thêm thông tin về tài nguyên mới này.

Ngày 11 tháng 3 năm 2020

Chúng tôi đã cập nhật phần Điểm cuối truyền dẫn trong hướng dẫn Phân phối nội dung trực tiếp trên YouTube qua HLS để làm rõ quy trình mà bộ mã hoá nên sử dụng để hoàn tất giá trị thông số file= khi tạo URL truyền dẫn chính và URL truyền dẫn dự phòng.

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

Chúng tôi đã cập nhật hướng dẫn Phân phối nội dung trực tiếp trên YouTube qua HLS để lưu ý rằng các yêu cầu DELETE là không bắt buộc và điểm cuối HLS của YouTube sẽ bỏ qua các yêu cầu đó. Vì lý do hiệu suất, YouTube khuyên bạn không nên gửi yêu cầu DELETE.

Ngày 10 tháng 1 năm 2020

API hiện hỗ trợ khả năng xác định nội dung hướng đến trẻ em, mà YouTube gọi là "dành cho trẻ em". Tìm hiểu thêm về nội dung "dành cho trẻ em" trong Trung tâm trợ giúp của YouTube.

  • Tài nguyên liveBroadcast hỗ trợ hai thuộc tính mới để giúp nhà sáng tạo nội dung và người xem xác định nội dung "dành cho trẻ em":
    • Thuộc tính selfDeclaredMadeForKids cho phép nhà sáng tạo nội dung chỉ định liệu một sự kiện phát trực tiếp có phải là nội dung hướng đến trẻ em hay không. Bạn có thể đặt thuộc tính này khi tạo thông báo truyền tin thông qua phương thức liveBroadcasts.insert. Xin lưu ý rằng thuộc tính này chỉ có trong các phản hồi API chứa tài nguyên liveBroadcast nếu chủ sở hữu kênh đã cho phép yêu cầu API.
    • Thuộc tính madeForKids cho phép mọi người dùng API truy xuất trạng thái "dành cho trẻ em" của một chương trình phát sóng. Ví dụ: trạng thái có thể được xác định dựa trên giá trị của thuộc tính selfDeclaredMadeForKids. Hãy truy cập vào Trung tâm trợ giúp của YouTube để biết thêm thông tin về cách đặt đối tượng người xem cho kênh, video hoặc sự kiện phát trực tiếp của bạn.
  • Trong API Dữ liệu của YouTube, tài nguyên channel cũng hỗ trợ các thuộc tính selfDeclaredMadeForKids và madeForKids mới.

Chúng tôi cũng đã cập nhật Điều khoản dịch vụ của Dịch vụ API YouTube và Chính sách dành cho nhà phát triển. Vui lòng xem Điều khoản dịch vụ của Dịch vụ API YouTube – Nhật ký sửa đổi để biết thêm thông tin. Các thay đổi đối với Điều khoản dịch vụ của Dịch vụ API YouTube và Chính sách dành cho nhà phát triển sẽ có hiệu lực từ ngày 10 tháng 1 năm 2020 theo giờ Thái Bình Dương.

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

Chúng tôi đã cập nhật phần Yêu cầu trong hướng dẫn Phân phối nội dung phát trực tiếp trên YouTube qua HLS. Nội dung cập nhật có 2 điểm thay đổi:

  • Tài liệu này giải thích rằng tốt nhất là bạn nên đưa cả phân khúc được xác nhận và phân khúc nổi bật vào mỗi Danh sách phát nội dung nghe nhìn. Phương pháp này giúp giảm khả năng một phân đoạn bị bỏ qua nếu Danh sách phát nội dung nghe nhìn bị mất ở phía máy chủ. Ví dụ: bạn có thể thêm tối đa 2 phân khúc được xác nhận và tối đa 5 phân khúc nổi bật vào mỗi Danh sách phát nội dung nghe nhìn.
  • Bây giờ, yêu cầu phải gửi Danh sách phát nội dung nghe nhìn cho mỗi Phân đoạn nội dung nghe nhìn. Điều này cho phép máy chủ nhanh chóng khôi phục nếu Danh sách phát nội dung nghe nhìn bị mất. Phương pháp này trước đây được liệt kê là một đề xuất.

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

YouTube hiện hỗ trợ tính năng truyền dẫn HLS. Theo đó, thuộc tính ingestionType của tài nguyên liveStream hỗ trợ giá trị mới hls để xác định các sự kiện phát trực tiếp được truyền tới YouTube bằng HLS.

Hướng dẫn mới về Phân phối nội dung phát trực tiếp trên YouTube qua HLS cung cấp các nguyên tắc sử dụng HLS để phát trực tiếp nội dung lên YouTube từ một bộ mã hoá. Hướng dẫn này nhằm giúp các nhà cung cấp bộ mã hoá thêm tính năng hỗ trợ phân phối HLS vào sản phẩm của họ.

Ngày 4 tháng 4 năm 2019

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

  • Tài liệu tham khảo API đã được cập nhật để giải thích rõ hơn các trường hợp sử dụng phổ biến cho từng phương thức và cung cấp các mẫu mã linh động, chất lượng cao thông qua tiện ích Trình khám phá API. Hãy xem tài liệu về phương thức liveBroadcasts.list để biết ví dụ. Hiện có hai phần tử mới trên các trang mô tả phương thức API:

    • Tiện ích APIs Explorer cho phép bạn chọn phạm vi uỷ quyền, nhập thông số mẫu và giá trị thuộc tính, sau đó gửi yêu cầu API thực tế và xem các phản hồi API thực tế. Tiện ích này cũng cung cấp chế độ xem toàn màn hình hiển thị các mẫu mã hoàn chỉnh, tự động cập nhật để sử dụng các phạm vi và giá trị mà bạn đã nhập.

    • Mục Trường hợp sử dụng phổ biến mô tả một hoặc nhiều trường hợp sử dụng phổ biến của phương thức được giải thích trên trang. Ví dụ: bạn có thể gọi phương thức liveBroadcasts.list để truy xuất dữ liệu về một thông báo truyền tin cụ thể hoặc để truy xuất dữ liệu về thông báo truyền tin của người dùng hiện tại.

      Bạn có thể sử dụng các đường liên kết trong phần đó để điền các giá trị mẫu vào APIs Explorer hoặc để mở APIs Explorer ở chế độ toàn màn hình bằng các giá trị đã được điền sẵn. Những thay đổi này nhằm giúp bạn dễ dàng xem các mẫu mã có thể áp dụng trực tiếp cho trường hợp sử dụng mà bạn đang cố gắng triển khai trong ứng dụng của riêng mình.

    Mã mẫu hiện được hỗ trợ cho Java, JavaScript, PHP, Python và curl.

  • Trang mẫu mã cũng có giao diện người dùng mới cung cấp tất cả các tính năng như mô tả ở trên. Khi sử dụng công cụ đó, bạn có thể khám phá các trường hợp sử dụng cho nhiều phương thức, tải các giá trị vào Trình khám phá API và mở Trình khám phá API ở chế độ toàn màn hình để lấy các mẫu mã trong Java, JavaScript, PHP và Python.

    Cùng với thay đổi này, các trang trước đây liệt kê các mã mẫu hiện có cho Java, PHP và Python đã bị xoá.

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

Chúng tôi đã cập nhật tài liệu về các tài nguyên liveChatMessage và superChatEvent để phản ánh việc cả hai tài nguyên này hiện đều có thể chứa thông tin về Super Stickers. Super Stickers là một loại tin nhắn Super Chat hiển thị hình ảnh. Giống như Super Chat, người hâm mộ mua tin nhắn Super Stickers trong sự kiện phát trực tiếp trên YouTube.

  • Trong tài nguyên liveChatMessage, thuộc tính snippet.type hiện được đặt thành superStickerEvent để cho biết tài nguyên đó chứa thông tin về Hình dán đặc biệt. Trong trường hợp đó, tài nguyên này cũng chứa đối tượng snippet.superStickerDetails chứa thông tin bổ sung về Super Stickers.
  • Trong tài nguyên superChatEvent, giá trị boolean snippet.isSuperStickerEvent cho biết liệu tin nhắn Super Chat có phải là Super Sticker hay không. Nếu có, thì đối tượng snippet.superStickerMetadata sẽ chứa thông tin chi tiết bổ sung về Super Stickers đó.

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

Nội dung mô tả về phương thức superChatEvents.list đã được cập nhật để phản ánh thực tế là phản hồi của API không còn chứa fanFundingEvents (không còn được dùng nữa vào đầu năm 2017).

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

Chúng tôi đã thêm các mã mẫu Java mới để hướng dẫn cách liệt kê, chèn và xoá tin nhắn trò chuyện trực tiếp. Các mẫu gọi các phương thức sau:

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

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

  • Thông tin cập nhật về các tài nguyên và phương pháp hiện có

    • Phương thức liveCuepoints.insert đã được cập nhật để phản ánh thực tế là tham số onBehalfOfContentOwner hiện là bắt buộc. Ngoài ra, nội dung mô tả của phương thức này đã được cập nhật để lưu ý rằng các lệnh gọi đến phương thức đó phải được một tài khoản liên kết với Chủ sở hữu nội dung trên YouTube uỷ quyền.

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

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

  • Nội dung cập nhật đối với các tài nguyên và phương thức hiện có

    • Tham số hl mới của phương thức superChatEvents.list cho phép bạn chỉ định rằng giá trị thuộc tính snippet.displayString phải được định dạng theo quy ước của một ngôn ngữ cụ thể. Định nghĩa của thuộc tính đó cũng đã được cập nhật cho phù hợp.

      Giá trị tham số phải là mã ngôn ngữ có trong danh sách do phương thức i18nLanguages.list trả về. Giá trị mặc định là en, nghĩa là hành vi mặc định là định dạng các chuỗi hiển thị như sẽ được sử dụng trong tiếng Anh. Ví dụ: theo mặc định, một chuỗi được định dạng là $1.00 thay vì $1,00.

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

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

  • Tài nguyên và phương thức mới

    • Tài nguyên superChatEvent mới đại diện cho một tin nhắn Super Chat do người hâm mộ mua trong sự kiện phát trực tiếp trên YouTube. Trong cuộc trò chuyện trực tiếp trên YouTube, Super Chat nổi bật so với các tin nhắn khác theo hai cách:

      • Super Chat được làm nổi bật bằng màu.
      • Super Chat được ghim vào biểu ngữ trong một khoảng thời gian nhất định.

      Màu sắc của Super Chat, khoảng thời gian Super Chat được ghim trong biểu ngữ và độ dài tin nhắn tối đa đều do số tiền mua quyết định. Bạn có thể xem thêm thông tin về tính năng Super Chat trong Trung tâm trợ giúp của YouTube.

      API này hỗ trợ một phương thức để liệt kê các sự kiện Super Chat cho các sự kiện phát trực tiếp của một kênh trong 30 ngày trước đó. Phương thức này cũng trả về dữ liệu về sự kiện Tài trợ của người hâm mộ (fanFundingEvents) từ lần phát trực tiếp gần đây nhất của kênh.

  • Nội dung cập nhật đối với các tài nguyên và phương thức hiện có

    • Thuộc tính snippet.type hiện hỗ trợ giá trị superChatEvent, cho biết tài nguyên mô tả một tin nhắn Super Chat.

      Ngoài ra, thuộc tính snippet.superChatDetails mới của tài nguyên liveChatMessage và các thuộc tính con của thuộc tính này chứa thông tin về sự kiện Super Chat.

    • Thuộc tính cdn.resolution của tài nguyên liveStream hiện hỗ trợ giá trị 2160p.

  • Lỗi mới và lỗi đã cập nhật

    • API này hỗ trợ các lỗi mới sau:

      Chi tiết về lỗi
      liveBroadcasts.insert, liveBroadcasts.update Phương thức liveBroadcasts.insert và liveBroadcasts.update trả về lỗi 400 (Bad Request) để cho biết rằng tài nguyên liveBroadcast đang được chèn hoặc cập nhật chứa một giá trị không hợp lệ cho thuộc tính contentDetails.enableEmbed hoặc thuộc tính contentDetails.projection. Nguyên nhân gây ra lỗi cho hai lỗi mới lần lượt là invalidEmbedSetting và invalidProjection.

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

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

Cùng với việc ra mắt tính năng Super Chat mới, YouTube đã ngừng sử dụng tính năng Tài trợ của người hâm mộ và API Tài trợ của người hâm mộ sẽ ngừng hoạt động kể từ ngày 28 tháng 2 năm 2017. Kể từ ngày đó:

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

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

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

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

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

YouTube hiện hỗ trợ tính năng truyền dẫn DASH. Do đó, thuộc tính ingestionType của tài nguyên liveStream hỗ trợ giá trị mới dash để xác định các luồng được truyền dẫn vào YouTube bằng DASH.

Hướng dẫn mới về Cung cấp nội dung phát trực tiếp trên YouTube qua DASH đưa ra các nguyên tắc sử dụng định dạng Phân phối DASH để truyền trực tuyến dữ liệu phát trực tiếp trên YouTube từ một bộ mã hoá. Thư viện này nhằm giúp các nhà cung cấp bộ mã hoá thêm tính năng hỗ trợ phân phối DASH vào sản phẩm của họ.

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

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

  • Nội dung cập nhật đối với các tài nguyên và phương thức hiện có

    • Nội dung cập nhật tài nguyên liveStream

      • YouTube hiện hỗ trợ các sự kiện phát trực tiếp có độ phân giải 1440p ở tốc độ 30 hoặc 60 khung hình/giây.

        Ngoài ra, tài nguyên liveStream còn chứa các thuộc tính mới để chỉ định tốc độ khung hình và độ phân giải của dữ liệu video đến:

        Thuộc tính
        cdn.frameRate Tốc độ khung hình của dữ liệu video đến. Các giá trị hợp lệ là 30fps và 60fps.
        cdn.resolution Độ phân giải của dữ liệu video đến. Các giá trị thuộc tính hợp lệ là: 1440p, 1080p, 720p, 480p, 360p và 240p.

      • Theo thông tin giới thiệu về thuộc tính cdn.frameRate và cdn.resolution của tài nguyên liveStream, cdn.format của tài nguyên hiện không được dùng nữa. Thuộc tính cdn.format chỉ định độ phân giải và tốc độ khung hình trong một giá trị duy nhất.

        Bạn nên chuyển sang các trường mới được hỗ trợ. Trong thời gian chờ đợi, cdn.format vẫn tiếp tục hoạt động. Ngoài ra, các yêu cầu chèn luồng phát trực tiếp hiện sẽ thành công miễn là bạn chỉ định giá trị cho thuộc tính cdn.format hoặc thuộc tính cdn.frameRate và cdn.resolution. Nếu bạn cung cấp giá trị cho cả ba thuộc tính, API có thể trả về lỗi nếu các giá trị không thống nhất.

        Xin lưu ý rằng mặc dù thuộc tính cdn.format không còn được dùng nữa, nhưng thuộc tính này hiện hỗ trợ hai giá trị mới là 1440p và 1440p_hfr để phản ánh khả năng hỗ trợ của API đối với luồng 1440p ở tốc độ 30 hoặc 60 khung hình/giây.

    • Nội dung cập nhật tài nguyên liveBroadcast

      • Tài nguyên liveBroadcast chứa các thuộc tính mới sau:

        Thuộc tính
        contentDetails.boundStreamLastUpdateTimeMs Ngày và giờ cập nhật gần đây nhất của luồng phát trực tiếp được tham chiếu bằng thuộc tính contentDetails.boundStreamId của thông báo truyền tin.
        contentDetails.projection Định dạng chiếu của thông báo truyền tin. Giá trị mặc định của thuộc tính này là rectangular. Các giá trị hợp lệ cho thuộc tính này là 360 và rectangular.

      • Định nghĩa của thuộc tính statistics.totalChatCount của tài nguyên liveBroadcast đã được cập nhật để lưu ý rằng giá trị thuộc tính chỉ xuất hiện nếu thông báo truyền tin có ít nhất một tin nhắn trò chuyện.

    • liveChatMessage cập nhật tài nguyên

      • Thuộc tính snippet.type hỗ trợ hai giá trị mới là messageDeletedEvent và userBannedEvent tương ứng với các thuộc tính mới được mô tả trong dấu đầu dòng sau đây. Định nghĩa của thuộc tính snippet.authorChannelId cũng đã được cập nhật để giải thích giá trị thuộc tính xác định cho các loại thông báo mới này.

      • Tài nguyên liveChatMessage chứa các thuộc tính mới sau:

        Thuộc tính
        snippet.messageDeletedDetails Đối tượng này chứa thông tin về một tin nhắn mà người kiểm duyệt cuộc trò chuyện đã xoá. Đối tượng này chỉ xuất hiện nếu giá trị thuộc tính snippet.type là messageDeletedEvent.
        snippet.userBannedDetails Đối tượng này chứa thông tin về một người dùng đã bị cấm tham gia cuộc trò chuyện. Đối tượng này cũng chứa thông tin về chính lệnh cấm, cụ thể là lệnh cấm là vĩnh viễn hay tạm thời. Nếu lệnh cấm là tạm thời, một trong các thuộc tính của đối tượng sẽ chỉ định khoảng thời gian cấm.

        Đối tượng này chỉ xuất hiện nếu giá trị thuộc tính snippet.type là userBannedEvent.

  • Lỗi mới và lỗi đã cập nhật

    • API này hỗ trợ các lỗi mới sau:

      Chi tiết về lỗi
      liveBroadcasts.bind Phương thức liveBroadcasts.bind trả về lỗi 403 (Forbidden) để cho biết rằng người dùng đã gửi quá nhiều yêu cầu trong một khung thời gian nhất định. Nguyên nhân gây ra lỗi là userRequestsExceedRateLimit.

      Phương thức liveBroadcasts.insert và liveBroadcasts.update đã hỗ trợ cùng một lỗi.
      liveStreams.insert Phương thức liveStreams.insert hỗ trợ 4 lỗi 400 (Bad Request) mới giúp xác định giá trị thuộc tính không hợp lệ trong tài nguyên liveStream mà yêu cầu đã cố gắng chèn. Danh sách sau đây xác định nguyên nhân xảy ra lỗi và những thuộc tính liên quan đến lỗi đó:
      liveStreams.insert Phương thức liveStreams.insert hỗ trợ hai lỗi 400 (Bad Request) mới, mỗi lỗi cho biết rằng một giá trị bắt buộc không có trong tài nguyên liveStream mà yêu cầu đã cố gắng chèn. Danh sách sau đây xác định nguyên nhân xảy ra lỗi và những thuộc tính liên quan đến lỗi đó:
      Cụ thể hơn, khi chèn tài nguyên liveStream, bạn phải chỉ định một giá trị cho thuộc tính cdn.format hoặc cho thuộc tính cdn.frameRate và cdn.resolution.
      • API sẽ trả về lỗi formatRequired nếu bạn không chỉ định giá trị cho bất kỳ thuộc tính nào trong số ba thuộc tính này.
      • API sẽ trả về lỗi frameRateRequired nếu bạn chỉ định giá trị cho cdn.resolution nhưng không chỉ định cdn.frameRate.
      • API sẽ trả về lỗi resolutionRequired nếu bạn chỉ định giá trị cho cdn.frameRate nhưng không chỉ định giá trị cho cdn.resolution.
      liveStreams.update Phương thức liveStreams.update trả về lỗi 403 (Forbidden) nếu yêu cầu cố gắng sửa đổi giá trị của bất kỳ thuộc tính không thể thay đổi nào sau đây: reason trong phản hồi lỗi là liveStreamModificationNotAllowed.

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 đã thêm thông báo về yêu cầu này vào Điều khoản dịch vụ của API YouTube.

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

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

  • Tài nguyên và phương thức mới

    • API này hỗ trợ một số tài nguyên mới hỗ trợ chức năng trò chuyện cho các chương trình phát sóng trực tiếp. YouTube hỗ trợ chức năng trò chuyện trực tiếp trong các sự kiện phát trực tiếp đang diễn ra. Các tài nguyên và phương thức này hỗ trợ việc truy xuất tin nhắn trò chuyện cũng như các chức năng quản trị cho cuộc trò chuyện.

      Tài nguyên
      liveChatMessage Tài nguyên này đại diện cho một tin nhắn trong cuộc trò chuyện trực tiếp trên YouTube. YouTube hỗ trợ một số loại tin nhắn, bao gồm tin nhắn văn bản và sự kiện Tài trợ của người hâm mộ. Một số loại tin nhắn xác định một giai đoạn cụ thể của cuộc trò chuyện, chẳng hạn như thời điểm bắt đầu giai đoạn chỉ dành cho nhà tài trợ hoặc thời điểm kết thúc cuộc trò chuyện. API này hỗ trợ các phương thức để liệt kê, chèn và xoá tin nhắn trò chuyện trực tiếp.
      liveChatModerators Tài nguyên này xác định một người kiểm duyệt cuộc trò chuyện. Người kiểm duyệt có thể thực hiện một số chức năng quản trị, chẳng hạn như cấm người dùng tham gia cuộc trò chuyện hoặc xoá tin nhắn. API này hỗ trợ các phương thức để liệt kê, chèn và xoá người kiểm duyệt cuộc trò chuyện trực tiếp.
      liveChatBans Tài nguyên này xác định một người dùng bị cấm đăng tin nhắn vào một cuộc trò chuyện trực tiếp cụ thể. Các lệnh cấm có thể là tạm thời hoặc vĩnh viễn. API này hỗ trợ các phương thức chèn và xoá lệnh cấm trò chuyện trực tiếp.
      fanFundingEvents Tài nguyên này đại diện cho một sự kiện Tài trợ của người hâm mộ trên kênh YouTube. Tính năng Tài trợ của người hâm mộ là một cách để người xem tự nguyện ủng hộ nhà sáng tạo trên YouTube bằng khoản tiền hỗ trợ một lần.

      Phương thức fanFundingEvents.list của API liệt kê các sự kiện Tài trợ của người hâm mộ của một kênh. Các sự kiện Tài trợ của người hâm mộ được bắt đầu thông qua cuộc trò chuyện trực tiếp trong sự kiện phát trực tiếp do kênh sở hữu cũng sẽ kích hoạt tin nhắn fanFundingEvent trong cuộc trò chuyện trực tiếp của sự kiện phát trực tiếp đó.

      Hãy tìm hiểu thêm về tính năng Tài trợ của người hâm mộ trong Trung tâm trợ giúp của YouTube.
      sponsors Tài nguyên sponsor xác định nhà tài trợ của một kênh YouTube. Nhà tài trợ trả phí hằng tháng cho một kênh. Huy hiệu xuất hiện bên cạnh tin nhắn của nhà tài trợ trong phần trò chuyện trực tiếp trên kênh. Nếu có, nhà tài trợ cũng có thể tham gia trò chuyện trực tiếp dành riêng cho họ.

      Phương thức sponsors.list của API liệt kê các nhà tài trợ của một kênh. Khi người dùng đăng ký tài trợ cho một kênh trong lúc kênh đó phát trực tiếp, API cũng sẽ thêm một tin nhắn newSponsorEvent vào cuộc trò chuyện trực tiếp của sự kiện phát trực tiếp đó.

      Tìm hiểu thêm về các chương trình tài trợ trong Trung tâm trợ giúp của YouTube.

  • Nội dung cập nhật đối với các tài nguyên và phương thức hiện có

    • Tài nguyên liveBroadcast chứa các thuộc tính mới sau:

      Thuộc tính
      snippet.liveChatId Mã nhận dạng cuộc trò chuyện trực tiếp trên YouTube của chương trình phát sóng. Với mã nhận dạng này, bạn có thể sử dụng các phương thức của tài nguyên liveChatMessage để truy xuất, chèn hoặc xoá tin nhắn trò chuyện. Bạn cũng có thể thêm hoặc xoá người kiểm duyệt cuộc trò chuyện, cấm người dùng tham gia cuộc trò chuyện trực tiếp hoặc xoá lệnh cấm hiện có.
      contentDetails.closedCaptionsType Lưu ý: Thuộc tính này thay thế thuộc tính contentDetails.enableClosedCaptions.

      Thuộc tính này cho biết liệu bạn có bật phụ đề cho chương trình phát sóng của mình hay không và nếu có thì bạn đang cung cấp loại phụ đề nào:
      • closedCaptionsDisabled: Tắt phụ đề cho sự kiện phát trực tiếp.
      • closedCaptionsHttpPost: Bạn sẽ gửi phụ đề, thông qua HTTP POST, đến một URL truyền dẫn liên kết với sự kiện phát trực tiếp.
      • closedCaptionsEmbedded: Phụ đề sẽ được mã hoá trong luồng video bằng các định dạng EIA-608 và/hoặc CEA-708.
      contentDetails.enableClosedCaptions Thuộc tính này không được dùng nữa kể từ ngày 17 tháng 12 năm 2015. Thay vào đó, hãy dùng thuộc tính contentDetails.closedCaptionsType. Đối với các ứng dụng khách API đang sử dụng thuộc tính này:
      • Việc đặt giá trị thuộc tính thành true tương đương với việc đặt thuộc tính contentDetails.closedCaptionsType thành closedCaptionsHttpPost.
      • Việc đặt giá trị thuộc tính thành false tương đương với việc đặt thuộc tính contentDetails.closedCaptionsType thành closedCaptionsDisabled.

    • Thông số broadcastType mới của phương thức liveBroadcasts.list cho phép bạn lọc phản hồi API để bao gồm thông báo truyền tin sự kiện, thông báo truyền tin liên tục hoặc tất cả thông báo truyền tin.

      Thông báo liên tục là thông báo luôn tồn tại và không liên kết với một sự kiện cụ thể. Cụ thể, bản phát sóng mặc định của một kênh là bản phát sóng liên tục và bạn có thể truy cập vào bản phát sóng này thông qua Trang tổng quan về sự kiện phát trực tiếp trong YouTube Studio. Các chương trình phát sóng khác của kênh là chương trình phát sóng sự kiện.

  • Trường status.healthStatus.configurationIssues[].type của tài nguyên liveStream báo cáo các lỗi trạng thái mới sau:

    Lỗi
    audioTooManyChannels Âm thanh có nhiều hơn hai kênh nhưng chỉ một kênh (đơn âm) hoặc hai kênh (âm thanh nổi) được hỗ trợ. Vui lòng sửa số kênh âm thanh.
    frameRateHigh Tốc độ khung hình hiện tại quá cao. Vui lòng đặt tốc độ khung hình thành %(framerate)s khung hình/giây trở xuống.

  • Sửa ngày phát hành của bản cập nhật tài liệu trước.

  • Lỗi mới và lỗi đã cập nhật

    • Ngoài các lỗi được xác định cho các tài nguyên mới nêu trên, API này còn hỗ trợ các lỗi mới sau:

      Chi tiết về lỗi
      liveBroadcasts.update
      Mã phản hồi HTTPforbidden (403)
      Lý doclosedCaptionsTypeModificationNotAllowed
      Mô tảBạn chỉ có thể sửa đổi giá trị contentDetails.closedCaptionsType khi thông báo truyền tin ở trạng thái created hoặc ready.
      liveBroadcasts.update
      Mã phản hồi HTTPinvalidValue (400)
      Lý doinvalidEnableClosedCaptions
      Mô tảTrong tài nguyên Livebroadcast, giá trị của thuộc tính contentDetails.enableClosedCaptions không tương thích với giá trị của chế độ cài đặt contentDetails.closedCaptionType. Sửa đổi tài nguyên để chỉ bao gồm một trong hai thuộc tính, sau đó gửi lại yêu cầu.

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

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

  • Các tài nguyên và phương thức mới

    • Lưu ý: Tài liệu về tài nguyên liveChat và các phương thức của tài nguyên này là tài liệu mật và chỉ một số đối tác YouTube mới xem được.

      Tài nguyên liveChat mới chứa một bình luận được đăng trong một sự kiện phát trực tiếp trên YouTube. API hỗ trợ hai phương thức cho tài nguyên này:

      Phương thức
      liveChats.list Liệt kê tin nhắn trò chuyện trực tiếp của một sự kiện phát trực tiếp.
      liveChats.insert Tạo một tin nhắn trò chuyện mới.

      Bạn chỉ có thể truy xuất và đăng tin nhắn trò chuyện trực tiếp khi sự kiện phát trực tiếp đang diễn ra.

  • Nội dung cập nhật đối với các tài nguyên và phương thức hiện có

    • Tài nguyên liveStream chứa các thuộc tính mới sau:

      Thuộc tính
      snippet.isDefaultStream Cho biết luồng này có phải là luồng mặc định cho kênh hay không. Luồng mặc định của kênh tồn tại vô thời hạn, không có thời gian bắt đầu hoặc kết thúc liên kết và không thể bị xoá. Hãy xem định nghĩa của tài sản để biết thêm thông tin về cách hoạt động của luồng mặc định.
      status.healthStatus Đối tượng này chứa thông tin có thể dùng để xác định, chẩn đoán và giải quyết các vấn đề về việc truyền trực tuyến. Đối tượng này chứa một số thuộc tính con để giúp bạn đánh giá tình trạng của luồng video trực tiếp.

      Cụ thể, đối tượng status.healthStatus.configurationIssues[] liệt kê các vấn đề ảnh hưởng đến luồng video. Tài liệu mới Các vấn đề về cấu hình đối với tài nguyên LiveStream liệt kê tất cả các vấn đề mà API báo cáo.
      contentDetails.isReusable Cho biết liệu luồng có thể sử dụng lại hay không, tức là luồng có thể được liên kết với nhiều thông báo truyền tin. Thông thường, các đài truyền hình thường sử dụng lại cùng một luồng phát cho nhiều chương trình phát sóng nếu các chương trình phát sóng đó diễn ra vào các thời điểm khác nhau.

    • Tài nguyên liveBroadcast chứa các thuộc tính mới sau:

      Thuộc tính
      snippet.isDefaultBroadcast Cho biết liệu thông báo này có phải là thông báo mặc định cho kênh hay không. Khi một kênh YouTube được bật tính năng phát trực tiếp, YouTube sẽ tạo một sự kiện phát trực tiếp và một sự kiện phát sóng mặc định cho kênh đó. Sự kiện phát trực tiếp xác định cách chủ sở hữu kênh gửi video trực tiếp đến YouTube và chương trình phát sóng là cách người xem có thể xem sự kiện phát trực tiếp mặc định. Hãy xem định nghĩa của thuộc tính này để biết thêm thông tin về cách hoạt động của thông báo truyền tin mặc định.
      contentDetails.enableLowLatency Cho biết liệu chương trình truyền tin này có được mã hoá để phát trực tuyến có độ trễ thấp hay không. Độ trễ thấp của sự kiện phát trực tiếp có thể làm giảm thời gian cần thiết để người dùng xem sự kiện phát trực tiếp có thể nhìn thấy video. Tuy nhiên, điều này cũng có thể ảnh hưởng đến độ phân giải của người xem sự kiện phát trực tiếp đó.
      statistics.totalChatCount Tổng số tin nhắn trò chuyện trực tiếp được liên kết với chương trình phát sóng. Thuộc tính và giá trị của thuộc tính đó sẽ xuất hiện nếu nội dung phát sóng hiển thị với người dùng và đã bật tính năng trò chuyện trực tiếp. Xin lưu ý rằng thuộc tính này sẽ không chỉ định giá trị sau khi thông báo truyền tin kết thúc. Do đó, thuộc tính này sẽ không xác định số lượng tin nhắn trò chuyện cho video đã lưu trữ của một sự kiện phát trực tiếp đã kết thúc.

  • Lỗi mới và lỗi đã cập nhật

    • Ngoài các lỗi được xác định cho tài nguyên liveChat mới, API này còn hỗ trợ lỗi mới sau:

      Chi tiết về lỗi
      liveStreams.update
      Mã phản hồi HTTPforbidden (403)
      Lý doliveStreamModificationNotAllowed
      Mô tảAPI không cho phép bạn thay đổi luồng có thể sử dụng lại thành không thể sử dụng lại hoặc ngược lại. Để biết thêm thông tin, hãy xem phần Tìm hiểu về thông báo truyền tin và luồng phát

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

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

  • YouTube hiện hỗ trợ phát trực tiếp video ở tốc độ 60 khung hình/giây (fps), giúp video phát mượt mà hơn đối với các sự kiện phát trực tiếp trò chơi và các video hành động nhanh khác. Khi bạn bắt đầu phát trực tiếp trên YouTube ở tốc độ 60 khung hình/giây, YouTube cũng cung cấp sự kiện phát trực tiếp ở tốc độ 30 khung hình/giây trên những thiết bị chưa hỗ trợ chế độ xem tốc độ khung hình cao.

    Thuộc tính cdn.format của tài nguyên liveStream hỗ trợ hai giá trị mới cho tính năng này: 720p_hfr và 1080p_hfr.

    Hãy xem Blog người sáng tạo trên YouTube để biết thêm thông tin về tính năng này.

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

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

  • Định nghĩa của tham số walltime của phương thức liveBroadcasts.control đã được cập nhật để lưu ý rằng giá trị thuộc tính được chỉ định ở định dạng ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ).

  • API hiện hỗ trợ các lỗi sau:

    Loại lỗi Thông tin chi tiết về lỗi Mô tả
    insufficientPermissions liveStreamingNotEnabled Tất cả phương thức cho tài nguyên liveBroadcast và liveStream sẽ trả về lỗi này nếu người dùng đã cho phép yêu cầu API chưa được bật để phát trực tiếp video trên YouTube. Thông tin chi tiết giải thích lý do người dùng không thể phát video trực tiếp có thể có trong phần cài đặt kênh của người dùng tại https://www.youtube.com/features.
    rateLimitExceeded userRequestsExceedRateLimit Cả phương thức liveBroadcasts.insert và liveStreams.insert đều trả về lỗi này để cho biết rằng người dùng đã gửi quá nhiều yêu cầu trong một khung thời gian nhất định.

Ngày 2 tháng 5 năm 2014

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

  • Nội dung mô tả về tài nguyên liveStream và phương thức liveBroadcasts.bind đã được cập nhật để lưu ý rằng một thông báo truyền tin chỉ có thể liên kết với một luồng video, nhưng một luồng video có thể liên kết với nhiều thông báo truyền tin. Thay đổi này chỉ là nội dung sửa đổi đối với tài liệu; chức năng API cơ bản không thay đổi.

  • Thuộc tính contentDetails.monitorStream.enableMonitorStream của tài nguyên liveBroadcast đã được cập nhật để giải thích rằng nếu giá trị của thuộc tính là true, thì bạn phải chuyển đổi thông báo truyền tin sang trạng thái testing trước khi có thể chuyển đổi thông báo truyền tin sang trạng thái live. (Nếu giá trị của thuộc tính là false, thì thông báo truyền tin của bạn không thể có giai đoạn testing, vì vậy, bạn có thể chuyển đổi thông báo truyền tin trực tiếp sang trạng thái live.

  • Thuộc tính settings.offsetTimeMs của tài nguyên liveCuepoint đã được cập nhật để lưu ý rằng bạn không nên chỉ định giá trị cho thuộc tính này nếu thông báo truyền tin của bạn không có luồng giám sát.

  • Tất cả các phương thức cho tài nguyên liveBroadcast và liveStream hiện hỗ trợ các tham số onBehalfOfContentOwner và onBehalfOfContentOwnerChannel. Những thông số này cho phép bạn sử dụng cùng thông tin xác thực uỷ quyền để hoàn tất yêu cầu API cho nhiều kênh liên kết với cùng một chủ sở hữu nội dung.

  • Tài liệu của phương thức liveCuepoints.insert đã được cập nhật để lưu ý rằng bạn có thể đặt giá trị cho thuộc tính settings.walltime khi gọi phương thức đó.

  • Tài liệu về lỗi hiện chỉ định mã phản hồi HTTP cho từng loại lỗi.

  • API hiện hỗ trợ lỗi sau:

    Loại lỗi Thông tin chi tiết về lỗi Mô tả
    insufficientPermissions livePermissionBlocked Các phương thức liveBroadcasts.insert, liveBroadcasts.transition và liveStreams.insert sẽ trả về lỗi này nếu người dùng đã cho phép yêu cầu không thể phát trực tiếp video trên YouTube. Bạn có thể xem thông tin chi tiết giải thích lý do người dùng không thể phát trực tiếp video trong phần cài đặt kênh của người dùng tại https://www.youtube.com/features.

  • Lỗi invalidScheduledStartTime của phương thức liveBroadcasts.insert đã được cập nhật để làm rõ rằng thời gian bắt đầu theo lịch phải đủ gần với ngày hiện tại để có thể lên lịch phát sóng một cách đáng tin cậy vào thời điểm đó.

Ngày 13 tháng 12 năm 2013

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

  • Thuộc tính status.recordingStatus mới của tài nguyên liveBroadcast xác định trạng thái hiện tại của thông báo truyền tin.

  • Thuộc tính contentDetails.enableClosedCaptions mới của tài nguyên liveBroadcast cho biết liệu có thể nhập phụ đề cho chương trình phát sóng hay không. Bạn có thể đặt giá trị thuộc tính khi chèn hoặc cập nhật chương trình phát sóng, nhưng không thể cập nhật giá trị này sau khi chương trình phát sóng ở trạng thái testing hoặc live. Nếu bạn đặt thuộc tính này thành true, thì tài nguyên liveStream liên kết với sự kiện phát sóng sẽ chỉ định URL truyền dẫn để sử dụng cho phụ đề của sự kiện phát sóng.

  • Thuộc tính snippet.scheduledEndTime của tài nguyên liveBroadcast hiện hỗ trợ các thông báo truyền tin được lên lịch để tiếp tục vô thời hạn. Với thay đổi này, thuộc tính này không còn bắt buộc trong các yêu cầu liveBroadcasts.insert và liveBroadcasts.update.

    Nếu bạn truy xuất một tài nguyên liveBroadcast không chỉ định giá trị cho thuộc tính này, thì sự kiện truyền phát sẽ được lên lịch tiếp tục vô thời hạn. Tương tự, nếu bạn gọi phương thức liveBroadcasts.insert hoặc liveBroadcasts.update và không chỉ định giá trị cho thuộc tính này, thì chương trình phát sóng sẽ được lên lịch tiếp tục vô thời hạn.

  • Thuộc tính contentDetails.recordFromStart của tài nguyên liveBroadcast vốn đã có giá trị mặc định là true, hiện chỉ có thể được thiết lập thành false nếu kênh phát sóng được phép tắt bản ghi cho chương trình phát sóng trực tiếp.

    Nếu kênh của bạn không có quyền tắt tính năng ghi lại và bạn cố gắng chèn một sự kiện phát trực tiếp có thuộc tính recordFromStart được đặt thành false, thì API sẽ trả về lỗi Forbidden. Ngoài ra, nếu kênh của bạn không có quyền đó và bạn cố gắng cập nhật thông báo truyền tin để đặt thuộc tính recordFromStart thành false, thì API sẽ trả về lỗi modificationNotAllowed.

  • Tài nguyên liveBroadcast không còn chứa thuộc tính enableArchive được đề cập trong phần mô tả thuộc tính contentDetails.enableDvr và contentDetails.enableEmbed.

  • Danh sách các giá trị hợp lệ cho thuộc tính status.lifeCycleStatus của tài nguyên liveBroadcast đã được cập nhật để bao gồm nội dung mô tả về từng trạng thái.

  • Thuộc tính settings.walltime mới của tài nguyên liveCuepoint chỉ định ngày và giờ cần chèn điểm tín hiệu. API sẽ trả về lỗi nếu một yêu cầu cố gắng chèn một điểm tín hiệu chỉ định giá trị cho thuộc tính này và cho thuộc tính settings.offsetTimeMs.

  • Đối tượng contentDetails mới trong tài nguyên liveStream chứa thông tin về luồng. Hiện tại, thuộc tính duy nhất của đối tượng là contentDetails.closedCaptionsIngestionUrl. Thuộc tính này chỉ định URL truyền dẫn cho phụ đề liên kết với luồng video.

  • Danh sách các giá trị hợp lệ cho thuộc tính status.streamStatus của tài nguyên liveStream đã được cập nhật để bao gồm nội dung mô tả về từng trạng thái.

  • Tham số walltime mới của phương thức liveBroadcasts.control cho phép bạn chỉ định ngày và giờ diễn ra thay đổi về lịch phát sóng. API sẽ trả về lỗi nếu một yêu cầu chỉ định giá trị cho tham số này và cho tham số offsetTimeMs.

  • Trong phản hồi API cho yêu cầu liveBroadcasts.list, giá trị của thuộc tính kind đã thay đổi từ youtube#liveBroadcastList thành youtube#liveBroadcastListResponse.

  • Trong phản hồi API cho yêu cầu liveStreams.list, giá trị của thuộc tính kind đã thay đổi từ youtube#liveStreamList thành youtube#liveStreamListResponse.

  • Thuộc tính eventId không còn được dùng trong cả liveBroadcastListResponse và liveStreamListResponse nữa.

  • API này hỗ trợ các lỗi mới sau:

    Loại lỗi Thông tin chi tiết về lỗi Mô tả
    invalidValue conflictingTimeFields Phương thức liveBroadcasts.control sẽ trả về lỗi này nếu yêu cầu của bạn chỉ định giá trị cho các tham số offsetTimeMs và walltime. Yêu cầu có thể bỏ qua cả hai tham số hoặc chỉ định giá trị cho một trong hai tham số.
    invalidValue invalidWalltime Phương thức liveBroadcasts.control sẽ trả về lỗi này nếu giá trị của tham số walltime không hợp lệ.
    forbidden enableClosedCaptionsModificationNotAllowed Phương thức liveBroadcasts.update sẽ trả về lỗi này nếu bạn cố gắng cập nhật giá trị contentDetails.enableClosedCaptions và trạng thái của thông báo truyền tin không phải là created hoặc ready.
    invalidValue conflictingTimeFields Phương thức liveCuepoints.insert sẽ trả về lỗi này nếu yêu cầu của bạn chỉ định giá trị cho các thuộc tính settings.offsetTimeMs và settings.walltime. Một yêu cầu có thể bỏ qua cả hai thuộc tính hoặc chỉ định giá trị cho một trong hai thuộc tính.

    Ngoài ra, phương thức liveStreams.update không còn hỗ trợ lỗi cdnRequired tương tự như lỗi mà phương thức liveStreams.insert hỗ trợ.

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 2 tháng 5 năm 2013

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

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

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

  • Các thuộc tính sau đây đã thay đổi trong tài nguyên liveBroadcast:

    • Chúng tôi đã đổi tên thuộc tính startWithSlateCuepoint thành startWithSlate.
    • Chúng tôi đã đổi tên thuộc tính enableArchive thành recordFromStart.
    • Đối tượng slateSettings không còn được dùng nữa và đã bị xoá khỏi tài liệu. Các thông báo lỗi liên quan đến đối tượng slateSettings hoặc các thuộc tính của đối tượng này cũng đã bị xoá. Cuối cùng, chúng tôi đã xoá phần "Hiển thị phương tiện chặn" trong hướng dẫn Bắt đầu.

  • API không còn hỗ trợ khả năng chèn phương tiện chặn trong luồng bằng phương thức liveCuepoints.insert nữa. Các tài liệu sau đây đã được cập nhật để phản ánh thay đổi này:

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

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

  • Tất cả thông báo lỗi của API đều được cập nhật để giải thích rõ ràng hơn về các lỗi có thể xảy ra và nếu có thể, sẽ đưa ra hướng dẫn về cách khắc phục các lỗi đó.

  • Giờ đây, API có thể trả về một số lỗi mới. Danh sách dưới đây xác định lỗi và phương thức API có thể trả về lỗi đó:

    • liveBroadcasts.insert – Thời gian kết thúc đã lên lịch của chương trình phát sóng phải sau thời gian bắt đầu đã lên lịch.
    • liveBroadcasts.insert – Thông báo truyền tin chỉ định trạng thái quyền riêng tư không hợp lệ.
    • liveBroadcasts.update – Tài nguyên không chứa hoặc không đặt giá trị cho thuộc tính contentDetails.enableArchive.
    • liveBroadcasts.update – Tài nguyên không chứa hoặc không đặt giá trị cho thuộc tính contentDetails.enableContentEncryption.
    • liveBroadcasts.update – Tài nguyên không chứa hoặc không đặt giá trị cho thuộc tính contentDetails.enableDvr.
    • liveStreams.insert – Tiêu đề đoạn trích phải dài từ 1 đến 128 ký tự.
    • liveStreams.update – Tài nguyên không chứa hoặc không đặt giá trị cho thuộc tính snippet.title.

  • Tài liệu về tài nguyên liveStream đã được cập nhật để phản ánh rằng multicast và WebM không phải là các phương thức truyền dẫn được hỗ trợ như đã chỉ định trước đó. Danh sách định dạng cho thuộc tính cdn.format đã được cập nhật cho phù hợp, đồng thời đối tượng cdn.multicastIngestionInfo và các thuộc tính con của đối tượng này đã bị xoá khỏi tài liệu của tài nguyên. Ngoài ra, http đã bị xoá khỏi danh sách các giá trị cdn.ingestionType được hỗ trợ.