Nhật ký sửa đổi

Trang này liệt kê các thay đổi và nội dung cập nhật tài liệu của YouTube Data API (v3). Đăng ký nhật ký thay đổi này.

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

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

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

API này không còn hỗ trợ tính năng chèn hoặc truy xuất nội dung thảo luận của kênh nữa. Thay đổi này phù hợp với chức năng được hỗ trợ trên trang web YouTube, vốn không hỗ trợ việc đăng bình luận lên kênh.

Ngày 13 tháng 3 năm 2024

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

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

Tham số sync cho captions.insert và captions.update phương thức không được dùng nữa. YouTube sẽ ngừng hỗ trợ thông số kể từ ngày 12 tháng 4 năm 2024.

Do sự thay đổi này, nhà phát triển phải thêm thông tin về thời gian khi chèn hoặc nếu bạn không cập nhật phụ đề, hoạt động tải lên sẽ không thành công.

Ngày 12 tháng 3 năm 2024

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

Tài liệu cho tài nguyên captions đã được cập nhật để lưu ý rằng độ dài tối đa cho phép đối với snippet.name trường có 150 ký tự. API trả về một nameTooLong nếu tên bản nhạc dài hơn tên bản nhạc đó.

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

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

Thuộc tính tài nguyên channel Không dùng brandingSettings.channel.moderateComments nữa. YouTube sẽ ngừng hỗ trợ thông số này kể từ ngày 7 tháng 3 năm 2024.

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

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

forHandle mới của phương thức channels.list cho phép bạn truy xuất thông tin về kênh bằng cách chỉ định tên người dùng của kênh đó trên YouTube.

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

Tất cả tham chiếu đến tài nguyên videoId trong Comments đã bị xoá vì tài nguyên videoId không được trả về bằng lệnh gọi API.

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

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

Phương thức comments.markAsSpam đã bị loại bỏ trong vài năm. Phương thức này hiện chưa được hỗ trợ trên YouTube nên không được hỗ trợ được API hỗ trợ lâu hơn.

Thông báo về việc ngừng sử dụng đã được thêm vào tất cả các tài liệu tham chiếu đến comments.markAsSpam.

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

Phương thức search.list hiện hỗ trợ videoPaidProductPlacement . Tham số này cho phép bạn lọc kết quả tìm kiếm để chỉ bao gồm những video nhà sáng tạo đã cho biết là mình triển khai nội dung được trả tiền để quảng cáo.

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

Định nghĩa của tài nguyên video liveStreamingDetails.concurrentViewers đã được cập nhật để lưu ý rằng số lượng người xem đồng thời mà API dữ liệu YouTube trả về có thể khác với số người xem đồng thời đã được xử lý và đã loại bỏ nội dung rác trên YouTube Số liệu phân tích. Chiến lược phát hành đĩa đơn Trung tâm trợ giúp của YouTube cung cấp thêm thông tin về các chỉ số phát trực tiếp.

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

Như đã thông báo vào ngày 12 tháng 6 năm 2023, Phương thức search.list Tham số relatedToVideoId không được dùng nữa. Thông số đó không còn tồn tại được hỗ trợ và các thông tin tham chiếu đến thông số này đã bị xoá khỏi tài liệu về API.

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

Phương thức thumbnails.set hiện hỗ trợ Lỗi uploadRateLimitExceeded, cho biết kênh đã tải quá nhiều video lên trong 24 giờ qua và nên thử lại sau.

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

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

Phương thức search.list Tham số relatedToVideoId không được dùng nữa. YouTube sẽ ngừng hỗ trợ kể từ ngày 7 tháng 8 năm 2023.

Hiện tại, thông báo về việc ngừng sử dụng đã được thêm vào phương thức search.list tài liệu. Tham số này sẽ bị xoá hoàn toàn khỏi tài liệu search.list kể từ ngày 7 tháng 8 năm 2023.

Ngoài ra, một ví dụ minh hoạ cách truy xuất các video có liên quan là bị xoá khỏi hướng dẫn triển khai API.

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

Sửa lỗi chú thích loại cho video.statistics thành chuỗi từ các trường dài không dấu.

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

YouTube đã thay đổi cách tạo mã phụ đề. Theo đó, chỉ định ID phụ đề mới cho tất cả phụ đề. Thay đổi này có thể không tương thích ngược thay đổi đối với các ứng dụng lưu trữ caption_id giá trị, mặc dù giá trị này sẽ không ảnh hưởng đến các ứng dụng không lưu trữ caption_id giá trị.

Từ nay đến ngày 1 tháng 12 năm 2022, captions.list, captions.update, captions.download và và phương thức captions.delete sẽ hỗ trợ cả ID phụ đề cũ và mới. Tuy nhiên, kể từ ngày 1 tháng 12 năm 2022, YouTube sẽ ngừng hỗ trợ ID phụ đề cũ. Khi đó, việc gọi bất kỳ phương thức API nào trong số đó có mã phụ đề cũ sẽ dẫn đến captionNotFound lỗi.

Để chuẩn bị cho thay đổi này, bạn nên lên kế hoạch thay thế toàn bộ dữ liệu phụ đề đã lưu trữ từ nay đến ngày 1 tháng 12 năm 2022. Điều này có nghĩa là đối với bất kỳ video nào mà bạn lưu trữ bản phụ đề bạn nên xoá dữ liệu hiện đang được lưu trữ, sau đó gọi phương thức Phương thức captions.list để truy xuất bộ phụ đề hiện tại cho video và lưu trữ dữ liệu trong phản hồi API theo cách bạn thông thường.

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

Điều khoản dịch vụ của Dịch vụ API YouTube đã được cập nhật. Năn nỉ xem Điều khoản dịch vụ của Dịch vụ API YouTube – Bản sửa đổi Nhật ký để biết thêm thông tin.

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

Nội dung mô tả phương thức videos.insert đã được cập nhật để lưu ý rằng kích thước tệp tối đa của video tải lên đã tăng từ 128 GB lên 256 GB.

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

của phương thức subscriptions.list myRecentSubscribers và mySubscribers định nghĩa tham số đều đã được cập nhật để lưu ý rằng số lượng người đăng ký tối đa mà API trả về có thể bị giới hạn. Thay đổi này thể hiện một nội dung chỉnh sửa trong tài liệu chứ không phải là thay đổi về hành vi của API.

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

Như đã thông báo vào ngày 18 tháng 11 năm 2021, cùng với các thay đổi liên quan đến chế độ cài đặt lượt không thích video tính riêng tư trên toàn bộ nền tảng YouTube, số liệu của tài nguyên video statistics.dislikeCount tài sản hiện ở chế độ riêng tư.

Bạn có thể tìm hiểu thêm về thay đổi này trên blog chính thức của YouTube.

Ngày 18 tháng 11 năm 2021

Cùng với các thay đổi đối với đặt số lượt không thích video ở chế độ riêng tư trên toàn bộ nền tảng YouTube, đây là tài nguyên video statistics.dislikeCount bất động sản sẽ được chuyển sang chế độ riêng tư kể từ ngày 13 tháng 12 năm 2021. Điều này có nghĩa là khách sạn sẽ chỉ được đưa vào phản hồi API từ điểm cuối videos.list nếu yêu cầu API là đã được chủ sở hữu video xác thực.

Điểm cuối videos.rate không bị ảnh hưởng bởi thay đổi này.

Những nhà phát triển không hiển thị công khai số lượt không thích nhưng vẫn cần có số lượt không thích cho họ Ứng dụng API có thể đăng ký để được đưa vào danh sách cho phép để được miễn trừ. Để xin miễn thuế, bạn phải hoàn thành việc này biểu mẫu đăng ký.

Bạn có thể tìm hiểu thêm về thay đổi này trên blog chính thức của YouTube.

Ngày 2 tháng 7 năm 2021

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

Điểm cuối commentThreads.update đã ngừng hoạt động và không còn được hỗ trợ nữa. Chức năng nhân bản của điểm cuối này được cung cấp thông qua các điểm cuối API khác. Thay vào đó, bạn có thể gọi comments.update

phương thức và nếu mã của bạn đòi hỏi tài nguyên commentThreads, hãy thực hiện lệnh gọi phụ đến commentThreads.list.

Ngày 1 tháng 7 năm 2021

Tất cả nhà phát triển sử dụng Dịch vụ API của YouTube đều phải hoàn tất quy trình Kiểm tra mức độ tuân thủ API để được cấp nhiều hơn hạn mức mặc định là 10.000 đơn vị. Cho đến nay, các nhà phát triển đều đã thực hiện cả quy trình kiểm tra việc tuân thủ và các yêu cầu phân bổ thêm đơn vị hạn mức trong việc điền và gửi Biểu mẫu kiểm tra và tăng hạn mức cho Dịch vụ API YouTube.

Để làm rõ các quy trình này và đáp ứng tốt hơn nhu cầu của nhà phát triển đang sử dụng Dịch vụ API, chúng tôi sẽ bổ sung 3 biểu mẫu mới cùng với hướng dẫn hoàn thành các biểu mẫu đó:

• Biểu mẫu yêu cầu dành cho nhà phát triển được kiểm tra: Những nhà phát triển đã vượt qua một đợt kiểm tra việc tuân thủ API có thể điền vào và gửi biểu mẫu ngắn hơn này để yêu cầu gia hạn hạn mức được phân bổ.
• Biểu mẫu khiếu nại: Nhà phát triển có dự án API không vượt qua được quy trình kiểm tra tính tuân thủ (hoặc bị từ chối tăng đơn vị hạn mức) có thể điền và gửi biểu mẫu này.
• Biểu mẫu thay đổi quyền kiểm soát: Nhà phát triển hoặc bất kỳ bên nào vận hành ứng dụng API thay mặt cho nhà phát triển và thay đổi quyền kiểm soát (ví dụ: thông qua việc mua hoặc bán cổ phiếu, sáp nhập hoặc một hình thức giao dịch doanh nghiệp khác) liên kết với dự án API phải điền vào và gửi biểu mẫu này. Việc này cho phép nhóm API của YouTube cập nhật hồ sơ, kiểm tra tình trạng tuân thủ trường hợp sử dụng của dự án API mới và xác thực việc phân bổ hạn mức hiện tại của nhà phát triển.

Mỗi biểu mẫu mới sẽ cho chúng tôi biết mục đích sử dụng API của YouTube của bạn và giúp chúng tôi hỗ trợ bạn tốt hơn.

Bạn có thể xem thêm thông tin chi tiết trong hướng dẫn mới của chúng tôi về quy trình Kiểm tra việc tuân thủ API.

Ngày 12 tháng 5 năm 2021

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

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

• Tài nguyên channel contentDetails.relatedPlaylists.favorites đã ngừng sử dụng. Chức năng Video yêu thích đã ngừng hoạt động đối với như đã nêu trong ngày 28 tháng 4 năm 2016, bản sửa đổi mục nhập nhật ký.

  Trước lần cập nhật này, API vẫn sẽ tạo danh sách phát mới nếu ứng dụng API cố gắng thêm video vào danh sách phát yêu thích không tồn tại. Từ giờ trở đi, danh sách phát này sẽ không được tạo trong trường hợp này và API sẽ trả về lỗi. Cố gắng sửa đổi danh sách phát yêu thích bằng cách thêm, sửa đổi hoặc xoá các mục cũng không được dùng nữa theo thông báo trước đó và có thể bắt đầu trả lại lỗi bất cứ lúc nào.

• Tài nguyên channel sau đây các thuộc tính không được dùng nữa. Các thuộc tính này vốn đã không được hỗ trợ trong giao diện người dùng YouTube Studio và trên YouTube. Do đó, chúng cũng không còn được hỗ trợ thông qua API.

  • brandingSettings.channel.defaultTab
  • brandingSettings.channel.featuredChannelsTitle
  • brandingSettings.channel.featuredChannelsUrls[]
  • brandingSettings.channel.profileColor
  • brandingSettings.channel.showBrowseView
  • brandingSettings.channel.showRelatedChannels

  Tất cả cơ sở lưu trú đã bị xoá khỏi channel biểu diễn tài nguyên và định nghĩa của chúng đã bị xoá khỏi giá trị của tài nguyên danh sách cơ sở lưu trú. Ngoài ra, các lỗi liên kết với các thuộc tính này đã bị xoá khỏi tài liệu dành riêng cho từng phương thức.

• Tài nguyên channelSection sau đây các thuộc tính không được dùng nữa. Các thuộc tính này vốn đã không được hỗ trợ trong giao diện người dùng YouTube Studio và trên YouTube. Do đó, chúng cũng không còn được hỗ trợ thông qua API.

  • snippet.style
  • snippet.defaultLanguage
  • snippet.localized.title
  • localizations
  • localizations.(key)
  • localizations.(key).title
  • targeting
  • targeting.languages[]
  • targeting.regions[]
  • targeting.countries[]

  Cùng với thay đổi này, phương thức channelSection.list Tham số hl cũng đã không được dùng nữa vì các tính năng trong đó không được hỗ trợ.

  Tất cả cơ sở lưu trú đã bị xoá khỏi channelSection biểu diễn tài nguyên và định nghĩa của chúng đã bị xoá khỏi giá trị của tài nguyên danh sách cơ sở lưu trú. Ngoài ra, các lỗi liên kết với các thuộc tính này đã bị xoá khỏi tài liệu dành riêng cho từng phương thức.

• Đối với tài nguyên channelSection thuộc tính snippet.type, các giá trị sau không được dùng nữa. YouTube hiện chưa hỗ trợ các giá trị này trang kênh và do đó, chúng cũng không còn được hỗ trợ thông qua API.

  • likedPlaylists
  • likes
  • postedPlaylists
  • postedVideos
  • recentActivity
  • recentPosts

• Tài nguyên playlist Thuộc tính snippet.tags[] không được dùng nữa. Thuộc tính này không được hỗ trợ trên YouTube. Do đó, API này không còn được hỗ trợ nữa.

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

Tài nguyên playlistItem hỗ trợ hai thuộc tính mới:

• snippet.videoOwnerChannelId thuộc tính xác định ID của kênh đã tải video trong danh sách phát lên.
• snippet.videoOwnerChannelTitle thuộc tính xác định tên của kênh đã tải video danh sách phát lên.

Ngày 28 tháng 1 năm 2021

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

• playlistItems.delete, playlistItems.insert, playlistItems.list, playlistItems.update, playlists.delete, playlists.list và Tất cả các phương thức playlists.update đều hỗ trợ lỗi playlistOperationUnsupported mới. Lỗi này xảy ra khi một yêu cầu cố gắng thực hiện thao tác không được phép đối với một danh sách phát cụ thể. Ví dụ: người dùng không thể xoá video khỏi danh sách phát các video họ đã tải lên hoặc xoá chính danh sách phát đó.

  Trong mọi trường hợp, lỗi này sẽ trả về mã phản hồi HTTP 400 (Yêu cầu không hợp lệ).

• của phương thức playlistItems.list watchHistoryNotAccessible và watchLaterNotAccessible lỗi có đã bị xoá khỏi tài liệu. Trong khi thông tin về danh sách video đã xem và danh sách xem sau không thể truy cập qua API, những lỗi cụ thể này sẽ không được API trả về.

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

Chúng tôi đã thêm hai phần mới vào tài khoản Nhà phát triển Chính sách:

• Mục III.E.4.i mới cung cấp thông tin bổ sung về dữ liệu được thu thập và gửi qua trình phát được nhúng của YouTube. Bạn chịu trách nhiệm về mọi dữ liệu người dùng mà bạn gửi cho chúng tôi qua bất kỳ trình phát được nhúng nào của YouTube trước khi người dùng đã tương tác với trình phát để cho biết ý định phát. Bạn có thể giới hạn dữ liệu được chia sẻ với YouTube trước khi người dùng tương tác với trình phát bằng cách đặt tính năng Tự động phát thành false.
• Mục III.E.4.j mới liên quan đến để kiểm tra trạng thái Dành cho trẻ em (MFK) của nội dung trước khi nhúng nội dung đó trên các trang web của bạn và của chúng tôi. Bạn có trách nhiệm biết thời điểm video mà bạn nhúng vào Ứng dụng API của mình được tạo cho trẻ em và xử lý dữ liệu thu thập được qua trình phát được nhúng cho phù hợp. Như vậy, bạn phải kiểm tra trạng thái của nội dung bằng Dịch vụ YouTube Data API trước khi nhúng nội dung đó vào API Ứng dụng khách thông qua bất kỳ trình phát được nhúng nào của YouTube.

Chế độ mới Tìm trạng thái dành cho trẻ em (dành cho trẻ em) của video hướng dẫn này giải thích cách tra cứu trạng thái dành cho trẻ em của video bằng cách sử dụng Dịch vụ YouTube Data API.

Cùng với những thay đổi này, một lời nhắc đã được thêm vào Tài liệu về Thông số trình phát được nhúng để giải thích rằng nếu bạn bật tính năng Tự động phát, thì quá trình phát sẽ diễn ra mà người dùng không cần tương tác với trình phát; phát do đó, việc thu thập và chia sẻ dữ liệu sẽ diễn ra khi tải trang.

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

Bản cập nhật này bao gồm 3 thay đổi nhỏ liên quan đến Tài nguyên channel:

• snippet.thumbnails đối tượng, xác định hình thu nhỏ của một kênh, có thể trống đối với phần tử mới được tạo kênh và có thể mất đến một ngày để điền dữ liệu.
• statistics.videoCount tài sản chỉ phản ánh số lượng video công khai của kênh, ngay cả đối với chủ sở hữu. Hành vi này phù hợp với số lượng được hiển thị trên trang web YouTube.
• Từ khoá kênh, được xác định trong phần brandingSettings.channel.keywords có thể bị cắt bớt nếu chúng vượt quá độ dài tối đa cho phép là 500 ký tự hoặc nếu chúng có chứa dấu ngoặc kép không thoát ("). Xin lưu ý rằng 500 ký tự giới hạn không phải là giới hạn cho mỗi từ khoá mà là giới hạn về tổng độ dài của tất cả từ khoá. Hành vi này nhất quán với hành vi trên trang web YouTube.

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

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

Bản cập nhật này bao gồm các thay đổi sau đây về API. Tất cả các thay đổi sẽ có hiệu lực vào hoặc sau Ngày 9 tháng 9 năm 2020, ngày đưa ra thông báo này. Với lưu ý đó, nhà phát triển không cần dựa vào bất kỳ tính năng API nào được liệt kê dưới đây.

• Các tài nguyên, phương thức, tham số và thuộc tính tài nguyên API sau đây không còn được dùng nữa ngay lập tức và sẽ ngừng hoạt động vào hoặc sau ngày của thông báo này:
  • Tài nguyên channel sau đây thuộc tính:
    • Thuộc tính statistics.commentCount
    • Đối tượng brandingSettings.image và tất cả thuộc tính con của đối tượng đó
    • Danh sách brandingSettings.hints và tất cả thuộc tính con của danh sách này
  • của phương thức channels.list Tham số bộ lọc categoryId
  • Tài nguyên guideCategories và guideCategories.list phương thức
• Phản hồi của API cho channels.list phương thức không còn chứa prevPageToken nếu yêu cầu API đặt giá trị Tham số managedByMe đến true. Thay đổi này không ảnh hưởng đến tài sản prevPageToken cho các yêu cầu channels.list khác, và điều này không ảnh hưởng đến nextPageToken cho bất kỳ yêu cầu nào.
• contentDetails.relatedPlaylists.watchLater của tài nguyên channel và thuộc tính contentDetails.relatedPlaylists.watchHistory đều đã được công bố ngừng hoạt động kể từ ngày 11 tháng 8 năm 2016. Chiến lược phát hành đĩa đơn Hỗ trợ phương thức playlistItems.insert và playlistItems.delete cho các danh sách phát này cũng không được dùng nữa và hai thuộc tính đã bị xoá khỏi tài liệu.
• Tham số mySubscribers của phương thức channels.list, là thông báo là không dùng nữa vào ngày 30 tháng 7 năm 2013, đã được đã bị xoá khỏi tài liệu. Sử dụng Phương thức subscriptions.list và tham số mySubscribers để truy xuất danh sách người đăng ký kênh của người dùng đã xác thực.
• Đối tượng invideoPromotion của tài nguyên channel và tất cả đối tượng con của tài nguyên đó thuộc tính, được thông báo là không dùng nữa vào Ngày 27 tháng 11 năm 2017 đã bị xóa khỏi tài liệu.

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

Chúng tôi đã đơn giản hoá quy trình tính phí hạn mức cho các yêu cầu API bằng cách xoá bỏ chi phí liên quan đến thông số part. Có hiệu lực ngay lập tức, chúng tôi sẽ chỉ tính phí chi phí cơ sở cho phương thức được gọi. Bạn có thể tìm thêm thông tin về hạn mức tại đây.

Tác động của sự thay đổi này là hầu hết các lệnh gọi API sẽ có chi phí hạn mức thấp hơn một chút, trong khi một số lệnh gọi API vẫn có cùng chi phí. Thay đổi này không làm tăng chi phí của bất kỳ API nào cuộc gọi. Nhìn chung, hạn mức được phân bổ của bạn có thể bị ảnh hưởng, bạn có thể xem trong Google Cloud Console, sẽ tiến xa hơn một chút.

Tất cả các nhà phát triển nên hoàn tất một kiểm tra sự tuân thủ của để đảm bảo có thể tiếp tục truy cập vào Dịch vụ API YouTube.

Mục nhật ký sửa đổi này được xuất bản lần đầu vào ngày 20 tháng 7 năm 2020.

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

Tất cả video được tải lên qua videos.insert điểm cuối của các dự án API chưa được xác minh được tạo sau ngày 28 tháng 7 năm 2020 sẽ chỉ có thể chế độ xem riêng tư. Để gỡ bỏ quy định hạn chế này, mỗi dự án phải tiến hành kiểm tra để xác minh việc tuân thủ Điều khoản dịch vụ.

Những nhà sáng tạo dùng ứng dụng API chưa được xác minh để tải video lên sẽ nhận được email giải thích rằng video của họ bị khoá ở chế độ riêng tư và họ có thể tránh bị hạn chế bằng cách sử dụng hoặc khách hàng được kiểm tra.

Các dự án API được tạo trước ngày 28 tháng 7 năm 2020 hiện không bị ảnh hưởng bởi thay đổi này. Tuy nhiên, tất cả các nhà phát triển đều nên hoàn thành một cuộc kiểm tra tính tuân thủ cho các dự án của họ nhằm đảm bảo quyền truy cập liên tục vào Dịch vụ API YouTube.

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

[Cập nhật vào ngày 28 tháng 7 năm 2020.] Nội dung cập nhật tài liệu được tham chiếu trong bản sửa đổi này bài viết trước đây được xuất bản lại vào ngày 28 tháng 7 năm 2020.

Hôm qua, chúng tôi đã xuất bản tài liệu cập nhật liên quan đến quy trình tính phí hạn mức. Tuy nhiên, do trường hợp không lường trước nên việc thay đổi hạn mức vẫn chưa có hiệu lực. Do đó, tài liệu đã được hoàn nguyên để đảm bảo tính chính xác. Để tránh nhầm lẫn, bản sửa đổi mục nhật ký giải thích thay đổi đó đã bị xoá và sẽ được xuất bản lại trong tương lai gần.

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

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

của phương thức videos.insert Các tham số autoLevels và stabilize hiện không còn được dùng nữa, đồng thời cả hai đã bị xoá khỏi tài liệu. Giá trị của các giá trị này bị bỏ qua và không ảnh hưởng đến cách xử lý video mới tải lên.

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

Hướng dẫn mới về Tuân thủ Nhà phát triển YouTube Hướng dẫn về chính sách đưa ra hướng dẫn và ví dụ để giúp bạn đảm bảo rằng các ứng dụng API của bạn tuân thủ vào các phần cụ thể trong Dịch vụ API YouTube Điều khoản và Chính sách (Điều khoản dịch vụ API).

Hướng dẫn này cung cấp thông tin chi tiết về cách YouTube thực thi một số khía cạnh của Điều khoản dịch vụ của API, nhưng không thay thế bất kỳ tài liệu hiện có nào. Hướng dẫn này giải đáp một số câu hỏi phổ biến nhất nhà phát triển hỏi trong quá trình kiểm tra việc tuân thủ API. Chúng tôi hy vọng rằng tính năng này giúp đơn giản hoá quá trình phát triển tính năng bằng cách giúp bạn hiểu cách chúng tôi diễn giải và thực thi chính sách của mình.

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

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

Tính năng bản tin kênh hiện đã ngừng hoạt động hoàn toàn. Thay đổi này đã được công bố ban đầu từ ngày 17/4/2020 và có hiệu lực. Do đó, Phương thức activities.insert là không được hỗ trợ lâu hơn và activities.list sẽ không trả về các bản tin kênh nữa. Để biết thêm chi tiết, vui lòng xem Trung tâm trợ giúp của YouTube.

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

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

YouTube sẽ ngừng sử dụng tính năng bản tin trên kênh. Do đó, Phương thức activities.insert sẽ là không dùng nữa và activities.list sẽ ngừng trả về các bản tin kênh. Những thay đổi này sẽ có hiệu lực trong API vào hoặc sau ngày 18/5/2020. Để biết thêm chi tiết, vui lòng xem Trung tâm trợ giúp của YouTube.

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

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

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

  • Tài nguyên member mới biểu thị hội viên của một kênh YouTube. Một thành viên hỗ trợ tiền định kỳ cho và nhận được các lợi ích đặc biệt. Ví dụ: hội viên có thể trò chuyện khi nhà sáng tạo bật chế độ chỉ dành cho hội viên trong cuộc trò chuyện.

    Tài nguyên này thay thế cho sponsor được ghi lại trong API phát trực tiếp trên YouTube. Chiến lược phát hành đĩa đơn Tài nguyên sponsor hiện không được dùng nữa và các ứng dụng API phải cập nhật các lệnh gọi thành phương thức sponsors.list để sử dụng members.list.

  • membershipsLevel mới xác định một mức giá do nhà sáng tạo đã uỷ quyền cho yêu cầu API quản lý. membershipsLevels.list truy xuất danh sách tất cả các cấp độ hội viên của người tạo.

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

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

channel và Các tài nguyên video 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 xem một channel hoặc video là dành cho trẻ em.
  
  Đối với các kênh, bạn có thể đặt thuộc tính này khi gọi channels.update. Đối với video, Bạn có thể đặt thuộc tính này khi gọi thuộc tính videos.insert hoặc videos.update.
  
  Xin lưu ý rằng thuộc tính này chỉ có trong các phản hồi của API chứa channel hoặc video 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 truy xuất nội dung "dành cho trẻ em" trạng thái của một kênh hoặc video. Ví dụ: trạng thái có thể là được xác định dựa trên giá trị của thuộc tính selfDeclaredMadeForKids. Xem Tìm hiểu thêm thông tin trong Trung tâm trợ giúp của YouTube thông tin về cách đặt đối tượng người xem cho kênh, video hoặc chương trình phát sóng.

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. Năn nỉ xem Điều khoản dịch vụ của Dịch vụ API YouTube – Bản sửa đổi Nhật ký để biết thêm thông tin. Những 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 10 tháng 9 năm 2019

Tài liệu tham khảo API đã được cập nhật để phản ánh sự thay đổi về cách người đăng ký được báo cáo trên YouTube, và do đó được báo cáo trong các phản hồi của API. Do thay đổi, số người đăng ký do Dịch vụ YouTube Data API trả về được làm tròn xuống ba mức quan trọng số người đăng ký lớn hơn 1.000 người đăng ký. Thay đổi này ảnh hưởng đến Tài nguyên channel statistics.subscriberCount thuộc tính này.

Lưu ý: Thay đổi này ảnh hưởng đến giá trị thuộc tính này ngay cả trong trường hợp người dùng sẽ gửi một yêu cầu được uỷ quyền để lấy dữ liệu về kênh của họ. Chủ sở hữu kênh vẫn có thể xem thông tin chính xác số người đăng ký trong YouTube Studio.

Ví dụ: nếu một kênh có 123.456 người đăng ký, Thuộc tính statistics.subscriberCount sẽ chứa giá trị 123000. Bảng dưới đây trình bày ví dụ về cách làm tròn số người đăng ký trong các phản hồi của API và được viết tắt trong các giao diện người dùng công khai khác trên YouTube:

Ví dụ về số người đăng ký	API Dữ liệu YouTube	Giao diện người dùng hiển thị công khai trên YouTube
1.234	1230	1,23 N
12,345	12300	12,3 N
123.456	123000	123 N
1.234.567	1230000	1,23 TR
12.345.678	12300000	12,3 TR
123.456.789	123000000	123 TR

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 pháp và để cung cấp các mẫu mã động, chất lượng cao thông qua tiện ích APIs Explorer. Hãy xem tài liệu ví dụ về phương thức channels.list. Hiện có hai phần tử mới trên các trang mô tả các 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 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ã mẫu hoàn chỉnh. Các mã này sẽ tự động cập nhật để sử dụng các phạm vi và giá trị mà bạn đã nhập.

  • Phần Cá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 channels.list để truy xuất dữ liệu về một kênh cụ thể hoặc để truy xuất dữ liệu về kênh 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 đã được điền sẵn các giá trị đó. Những thay đổi này nhằm giúp bạn dễ dàng xem các mã mẫu 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 mình.

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

• Công cụ mã mẫu cũng đã được cập nhật với một giao diện người dùng mới cung cấp tất cả tính năng tương tự 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 giá trị vào APIs Explorer và mở APIs Explorer toàn màn hình để lấy mã mẫu trong Java, JavaScript, PHP và Python.

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

• Chúng tôi đã cập nhật hướng dẫn bắt đầu nhanh dành cho Java, JavaScript, PHP và Python. Hướng dẫn đã sửa đổi giải thích cách chạy một mẫu bằng khoá API và một mẫu khác có mã ứng dụng khách OAuth 2.0 bằng mã mẫu của APIs Explorer.

Xin lưu ý rằng những nội dung thay đổi nêu trên sẽ thay thế một công cụ tương tác đã được thêm vào tài liệu về API năm 2017.

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

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

• Định nghĩa về thuộc tính snippet.thumbnails của tài nguyên channel đã được cập nhật để lưu ý rằng khi hiển thị hình thu nhỏ trong ứng dụng, mã của bạn phải sử dụng đúng URL hình ảnh như được trả về trong phản hồi API. Ví dụ: ứng dụng của bạn không được sử dụng miền http thay vì miền https trong URL được trả về trong một phản hồi API.

  Kể từ tháng 7 năm 2018, URL hình thu nhỏ của kênh sẽ chỉ có trong miền https, tức là cách URL xuất hiện trong các phản hồi của API. Sau thời gian đó, bạn có thể thấy hình ảnh bị hỏng trong ứng dụng của mình nếu ứng dụng cố gắng tải hình ảnh trên YouTube từ miền http.

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

  Thuộc tính recordingDetails.location.altitude của tài nguyên video không còn được dùng nữa. Chúng tôi không đảm bảo rằng video sẽ trả về các giá trị cho thuộc tính này. Tương tự, ngay cả khi các yêu cầu API cố gắng đặt một giá trị cho thuộc tính đó, thì có thể dữ liệu nhận được sẽ không được lưu trữ.

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

Hướng dẫn triển khai, trước đây là Hướng dẫn triển khai và di chuyển đã được cập nhật để xóa hướng dẫn di chuyển từ API v2 sang API v3. Ngoài ra, chúng tôi cũng đã gỡ bỏ hướng dẫn đối với các tính năng đã kể từ đó không được dùng nữa trong API v3 (chẳng hạn như video yêu thích).

Ngày 27 tháng 11 năm 2017

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

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

  YouTube sẽ ngừng hỗ trợ các tính năng Video nổi bật và Trang web nổi bật được hỗ trợ trong API thông qua đối tượng invideoPromotion của tài nguyên channel. Do đó, đối tượng đó (bao gồm tất cả các thuộc tính con của nó) sẽ không được dùng nữa.

  Bạn vẫn có thể truy xuất và thiết lập dữ liệu invideoPromotion cho đến hết ngày 14 tháng 12 năm 2017. Sau ngày đó:

  • Hệ thống sẽ cố gắng truy xuất phần invideoPromotion khi gọi channels.list sẽ trả về một invideoPromotion trống hoặc hoàn toàn không trả về dữ liệu invideoPromotion.
  • Nếu bạn cố gắng cập nhật dữ liệu invideoPromotion khi gọi channels.update, thì kết quả trả về sẽ là ít nhất là ngày 27 tháng 5 năm 2018. Tuy nhiên, các lượt cố gắng này sẽ được coi là không hoạt động, nghĩa là sẽ không thực sự cập nhật.

  Sau ngày 27 tháng 5 năm 2018, các yêu cầu này có thể trả về thông báo lỗi để cho biết rằng invalidPromotion là một phần không hợp lệ.

Ngày 16 tháng 11 năm 2017

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

• Công cụ đoạn mã tương tác hiện hỗ trợ các mã mẫu Node.js. Các mẫu này cũng xuất hiện trong tài liệu về hầu hết mọi phương thức API, chẳng hạn như phương thức channels.list.

  Các mẫu có thể tuỳ chỉnh được thiết kế để cung cấp cho bạn điểm bắt đầu cho ứng dụng Node.js theo từng trường hợp sử dụng cụ thể. Chức năng này tương tự như mã trong hướng dẫn bắt đầu nhanh Node.js. Tuy nhiên, các mẫu này có chứa một số hàm hiệu dụng không xuất hiện trong phần bắt đầu nhanh:

  • Hàm removeEmptyParameters nhận danh sách các cặp khoá-giá trị tương ứng với các tham số của yêu cầu API rồi xoá các tham số không có giá trị.
  • Hàm createResource nhận danh sách các cặp khoá-giá trị tương ứng với các thuộc tính trong tài nguyên API. Sau đó, công cụ này chuyển đổi các thuộc tính thành đối tượng JSON có thể dùng trong các toán tử insert và update. Ví dụ bên dưới cho thấy một tập hợp tên và giá trị thuộc tính cũng như đối tượng JSON mà mã sẽ tạo cho các thuộc tính đó:

    # Key-value pairs:
    {'id': 'ABC123',
     'snippet.title': 'Resource title',
     'snippet.description': 'Resource description',
     'status.privacyStatus': 'private'}
    
    # JSON object:
    {
     'id': 'ABC123',
     'snippet': {
       'title': 'Resource title',
       'description': 'Resource description',
     },
     'status': {
       'privacyStatus': 'private'
     }
    }

  Tất cả các mẫu này đều được thiết kế để tải xuống và chạy trên máy. Để biết thêm thông tin, hãy xem các điều kiện tiên quyết để chạy cục bộ mẫu mã đầy đủ trong hướng dẫn của công cụ đoạn mã.

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

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

• Các mã mẫu Python trong công cụ đoạn mã tương tác đã được cập nhật để sử dụng thư viện google-auth và google-auth-oauthlib thay vì thư viện oauth2client (hiện đã ngừng hoạt động).

  Ngoài thay đổi đó, công cụ này hiện cung cấp mã mẫu đầy đủ cho các ứng dụng Python đã cài đặt và ứng dụng máy chủ web Python sử dụng các quy trình uỷ quyền hơi khác. Để xem toàn bộ mẫu (và thay đổi này):

  1. Truy cập công cụ đoạn mã tương tác hoặc xem tài liệu về phương thức API bất kỳ, chẳng hạn như phương thức channels.list.
  2. Nhấp vào thẻ Python ở phía trên các mã mẫu.
  3. Nhấp vào nút bật/tắt phía trên các thẻ để chuyển từ trạng thái xem một đoạn trích sang đoạn trích đầy đủ.
     
  4. Giờ đây, thẻ này sẽ hiển thị một đoạn mã mẫu hoàn chỉnh sử dụng quy trình uỷ quyền InstalledAppFlow. Phần mô tả ở trên mẫu giải thích điều này và cũng liên kết đến một mẫu dành cho ứng dụng máy chủ web.
  5. Hãy nhấp vào đường liên kết để chuyển sang ví dụ về máy chủ web. Mẫu đó sử dụng khung ứng dụng web Flask và một quy trình uỷ quyền khác.

  Tất cả các mẫu này đều được thiết kế để tải xuống và chạy trên máy. Nếu bạn muốn chạy các mẫu, hãy xem hướng dẫn về cách chạy cục bộ toàn bộ mã mẫu trong phần hướng dẫn về công cụ đoạn mã.

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

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

• Định nghĩa về tham số forContentOwner của phương thức search.list đã được cập nhật để lưu ý rằng nếu tham số đó được đặt thành true, thì tham số type phải được đặt thành video.
• Chúng tôi đã cập nhật định nghĩa về tham số regionCode của phương thức search.list để làm rõ rằng thông số này chỉ giới hạn kết quả tìm kiếm ở những video có thể xem ở khu vực cụ thể của bạn.
• YouTube đã cập nhật biểu trưng và biểu tượng thương hiệu. Mới "được phát triển cùng YouTube" Bạn có thể tải biểu trưng xuống từ trang nguyên tắc sử dụng thương hiệu. Các biểu trưng và biểu tượng mới khác của YouTube cũng sẽ hiển thị trên trang đó và bạn có thể tải xuống từ trang web thương hiệu YouTube.

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

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

• Hiện đã có hướng dẫn bắt đầu nhanh mới về API dữ liệu YouTube dành cho iOS. Hướng dẫn này giải thích cách sử dụng YouTube Data API trong một ứng dụng iOS đơn giản được viết bằng Mục tiêu-C hoặc Swift.
• Công cụ đoạn mã tương tác cho YouTube Data API hiện đã bao gồm tài liệu giải thích một số tính năng của công cụ này:
  • Thực thi các yêu cầu API
  • Chuyển đổi giữa các đoạn mã và mã mẫu đầy đủ
  • Sử dụng các hàm nguyên mẫu
  • Đang tải tài nguyên hiện có (cho phương thức cập nhật)

  Lưu ý: Công cụ này cũng được đề cập trong tài liệu tham khảo API cho các phương thức API (ví dụ).

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

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

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

  Các thuộc tính tài nguyên video sau đây sẽ không được dùng nữa. Mặc dù các thuộc tính sẽ được hỗ trợ cho đến ngày 1 tháng 12 năm 2017, nhưng chúng tôi không đảm bảo rằng video sẽ tiếp tục trả về giá trị cho các thuộc tính đó cho đến thời điểm đó. Tương tự, các yêu cầu videos.insert và videos.update đặt các giá trị thuộc tính đó sẽ không tạo ra lỗi trước ngày đó, nhưng có thể dữ liệu sắp tới sẽ không được lưu trữ.

  • recordingDetails.locationDescription
  • recordingDetails.location.latitude
  • recordingDetails.location.longitude

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

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úp các đoạn mã phổ biến và có tính tương tác hơn. Các trang giải thích các phương thức API, như channels.list hoặc videos.rate, hiện có một công cụ tương tác cho phép bạn xem và tuỳ chỉnh các đoạn mã trong Java, JavaScript, PHP, Python, Ruby, Apps Script và Go.

  Đối với bất kỳ phương thức nào, công cụ này hiển thị các đoạn mã cho một hoặc nhiều trường hợp sử dụng, và mỗi trường hợp sử dụng sẽ mô tả một cách phổ biến để gọi phương thức đó. Ví dụ: bạn có thể gọi phương thức channels.list để truy xuất dữ liệu về một kênh cụ thể hoặc về kênh của người dùng hiện tại.

  Bạn cũng có thể tương tác với mã mẫu:

  • Sửa đổi giá trị thông số và thuộc tính, đồng thời các đoạn mã sẽ tự động cập nhật để phản ánh các giá trị mà bạn cung cấp.

  • Chuyển đổi giữa các đoạn mã và mẫu đầy đủ. Đoạn mã cho thấy phần mã gọi phương thức API. Một mẫu đầy đủ có chứa đoạn mã đó cũng như mã nguyên mẫu để uỷ quyền và gửi yêu cầu. Bạn có thể sao chép và chạy các mẫu đầy đủ từ dòng lệnh hoặc máy chủ web cục bộ.

  • Thực hiện yêu cầu bằng cách nhấp vào một nút. (Để thực thi các yêu cầu, bạn cần phải cho phép công cụ thay mặt bạn gọi API.)

  Lưu ý rằng công cụ này đã thay thế APIs Explorer trên các trang có sẵn công cụ này. (Mỗi trang sẽ hiển thị một đường liên kết để bạn cũng có thể tải yêu cầu mà bạn đang thực hiện trong APIs Explorer.)

• Công cụ Đoạn mã API dữ liệu cũng đã được cập nhật với giao diện người dùng mới cung cấp tất cả tính năng tương tự như mô tả ở trên. Các tính năng chính mới có trên trang này là:

  • Hỗ trợ các yêu cầu API ghi dữ liệu.
  • Hỗ trợ các mẫu Java.
  • Mã nguyên mẫu linh hoạt và toàn diện hơn để uỷ quyền cho người dùng và tạo yêu cầu API.

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

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

• Hướng dẫn bắt đầu nhanh mới giải thích cách thiết lập một ứng dụng đơn giản để thực hiện các yêu cầu YouTube Data API. Hiện có hướng dẫn cho Android, Apps Script, Go, Java, JavaScript, Node.js, PHP, Python và Ruby.

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

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

• Thuộc tính topicDetails.topicCategories[] mới của tài nguyên channel chứa danh sách các URL của Wikipedia mô tả nội dung của kênh. Các URL tương ứng với mã chủ đề được trả về trong thuộc tính topicDetails.topicIds[] của tài nguyên.
• Thuộc tính contentDetails.videoPublishedAt mới của tài nguyên playlistItem xác định thời điểm video được xuất bản lên YouTube. Tài nguyên này đã chứa thuộc tính snippet.publishedAt. Thuộc tính này giúp xác định thời điểm thêm một mục vào danh sách phát.
• Giống như tài nguyên channel, tài nguyên video hiện trả về thuộc tính topicDetails.topicCategories[], chứa danh sách các URL Wikipedia mô tả nội dung video. Đối với tài nguyên video, URL tương ứng với mã chủ đề được trả về trong thuộc tính topicDetails.relevantTopicIds[] của tài nguyên đó.
• Thuộc tính contentDetails.contentRating.mpaatRating mới của tài nguyên video xác định mức phân loại mà Hiệp hội Điện ảnh Hoa Kỳ ( Hiệp hội điện ảnh Hoa Kỳ) đưa ra cho một đoạn giới thiệu hoặc bản xem trước của một bộ phim.

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

Như thông báo ban đầu vào ngày 11 tháng 8 năm 2016, YouTube đã chuyển danh sách ID chủ đề được hỗ trợ thành danh sách tuyển chọn. Danh sách đầy đủ các mã chủ đề được hỗ trợ có trong thuộc tính topicDetails của các tài nguyên channel và video cũng như trong tham số topicId của phương thức search.list.

Lưu ý rằng có một số thay đổi đối với danh sách đã chọn:

• Các chủ đề sau đã được thêm làm chủ đề phụ của Society:

  Tên	ID chủ đề
  Doanh nghiệp	/m/09s1f
  Sức khỏe	/m/0kt51
  Quân đội	/m/01h6rj
  Chính trị	/m/05qt0
  Tôn giáo	/m/06bvp

• Chủ đề Animated cartoon, trước đây là phần tử con của Entertainment, đã bị xoá.
• Chủ đề Children's music, trước đây là phần tử con của Music, đã bị xoá.

Do sự thay đổi này, giờ đây, các chủ đề liên quan đến một video sẽ luôn được trả về trong giá trị thuộc tính topicDetails.relevantTopicIds[] của tài nguyên video.

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

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

• Có ba thay đổi nhỏ đối với danh sách mã chủ đề sẽ được hỗ trợ kể từ ngày 10 tháng 2 năm 2017:

  • Danh mục Professional wrestling, trước đây là phần tử con của danh mục Sports, nay là phần tử con của Entertainment.
  • Danh mục TV shows là phần tử con của Entertainment và là danh mục mới.
  • Danh mục Health, trước đây là phần tử con của Lifestyle, đã bị xoá.

  Ngoài ra, xin lưu ý rằng có một vài danh mục mẹ (Entertainment, Gaming, Lifestyle, Music và Sports). Bất kỳ video nào liên kết với danh mục con, chẳng hạn như Tennis, cũng sẽ liên kết với danh mục mẹ (Sports).

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

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

• Như thông báo lần đầu vào ngày 11 tháng 8 năm 2016, việc ngừng sử dụng Freebase và API Freebase đòi hỏi một số thay đổi liên quan đến ID chủ đề. Mã chủ đề xác định những chủ đề liên quan đến tài nguyên channel và video. Bạn cũng có thể sử dụng thông số tìm kiếm topicId để tìm các kênh hoặc video liên quan đến một chủ đề cụ thể.

  Vào ngày 10 tháng 2 năm 2017, YouTube sẽ bắt đầu trả về một tập hợp nhỏ các ID chủ đề thay vì tập hợp ID chi tiết hơn nhiều được trả về từ trước đến nay. Ngoài ra, xin lưu ý rằng chúng tôi không đảm bảo liên kết các kênh và video với bất kỳ chủ đề nào, vì điều này phù hợp với cách hoạt động hiện tại của API.

  Để bạn có thể chuẩn bị cho các Ứng dụng API của mình cho những thay đổi đó, định nghĩa về các tham số và thuộc tính API sau đây đã được cập nhật để liệt kê những mã chủ đề sẽ được hỗ trợ sau thời điểm đó. Xin lưu ý rằng danh sách danh mục giống nhau cho tất cả các cơ sở lưu trú.

  • Thuộc tính topicDetails.topicIds[] của tài nguyên channel.
  • Thuộc tính topicDetails.relevantTopicIds[] của tài nguyên video.
  • Tham số topicId của phương thức search.list.

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

  Các thuộc tính sau sẽ không được dùng nữa:

  • Thuộc tính topicDetails.topicIds[] của tài nguyên channel. Thuộc tính này sẽ được hỗ trợ đến hết ngày 10 tháng 11 năm 2017.
  • Thuộc tính topicDetails.relevantTopicIds[] của tài nguyên video. Thuộc tính này sẽ được hỗ trợ đến hết ngày 10 tháng 11 năm 2017.
  • Thuộc tính topicDetails.topicIds[] của tài nguyên video. Thuộc tính này sẽ không chứa các giá trị sau ngày 10 tháng 2 năm 2017. (Sau ngày đó, giá trị thuộc tính topicDetails.relevantTopicIds[] sẽ xác định tất cả chủ đề liên kết với một video.)

• Vì Freebase không còn được dùng nữa nên hướng dẫn Tìm kiếm bằng các chủ đề Freebase đã bị xoá khỏi tài liệu. Hướng dẫn đó cung cấp các mã mẫu để cho thấy cách một ứng dụng sẽ hoạt động với API Freebase.

  Ngoài ra, một số mã mẫu liên quan đến mã chủ đề cũng đã bị xoá khỏi tài liệu của phương thức search.list.

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

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

• Thuộc tính và thông số mới

  • Tài nguyên video chứa một số thuộc tính mới:

    • Thuộc tính player.embedHtml chứa thẻ <iframe> mà bạn có thể dùng để nhúng trình phát phát video. Thuộc tính player.embedHeight và player.embedWidth mới sẽ xác định kích thước của trình phát được nhúng. Các thuộc tính này chỉ được trả về nếu yêu cầu API chỉ định một giá trị cho ít nhất một trong các tham số maxHeight hoặc maxWidth. Hai thông số mới đó sẽ được giải thích sau trong mục nhật ký sửa đổi này.

    • Thuộc tính hasCustomThumbnail mới cho biết liệu trình tải video lên đã cung cấp hình thu nhỏ tuỳ chỉnh cho video hay chưa. Xin lưu ý rằng chỉ người tải video lên mới thấy tài sản này.

    • fpbRatingReasons[] mới xác định lý do khiến video nhận được xếp hạng FPB (Nam Phi).

    • mcstRating mới xác định mức phân loại của video nhận được ở Việt Nam.

  • Phương thức videos.list hỗ trợ hai tham số mới là maxHeight và maxWidth. Bạn có thể sử dụng một trong hai tham số hoặc cả hai tham số khi truy xuất phần player trong tài nguyên video.

    Theo mặc định, chiều cao của <iframe> được trả về trong thuộc tính player.embedHtml là 360px. Chiều rộng sẽ điều chỉnh cho phù hợp với tỷ lệ khung hình của video, nhờ đó đảm bảo rằng trình phát được nhúng không có các thanh màu đen đóng khung video. Ví dụ: nếu tỷ lệ khung hình của video là 16:9, thì chiều rộng của trình phát sẽ là 640px.

    Với các tham số mới, bạn có thể chỉ định rằng thay vì kích thước mặc định, mã nhúng phải sử dụng chiều cao và/hoặc chiều rộng phù hợp với bố cục ứng dụng của bạn. Máy chủ API điều chỉnh tỷ lệ kích thước của trình phát sao cho phù hợp để đảm bảo trình phát được nhúng không có các thanh màu đen đóng khung video. Lưu ý rằng cả hai thông số đều chỉ định kích thước tối đa của trình phát được nhúng. Do đó, nếu cả hai thông số được chỉ định, một phương diện vẫn có thể nhỏ hơn số lượng tối đa được phép cho phương diện đó.

    Ví dụ: Giả sử video có tỷ lệ khung hình 16:9. Do đó, thẻ player.embedHtml sẽ chứa trình phát 640x360 nếu bạn không đặt tham số maxHeight hoặc maxWidth.

    • Nếu tham số maxHeight được đặt thành 720 và tham số maxWidth không được đặt, API sẽ trả về trình phát có kích thước 1280x720.
    • Nếu bạn đặt tham số maxWidth thành 960 và không đặt tham số maxHeight, thì API sẽ trả về một trình phát có kích thước 960x540.
    • Nếu tham số maxWidth được đặt thành 960 và tham số maxHeight được đặt thành 450, thì API sẽ trả về một trình phát có kích thước 800x450.

    Các thuộc tính player.embedHeight và player.embedWidth mới (như mô tả ở trên) sẽ xác định phương diện của người chơi.

• Nội dung cập nhật đối với các phương thức, thuộc tính và thông số hiện có

  • Chúng tôi đã cập nhật nội dung mô tả về tài nguyên channelSection để lưu ý rằng một kênh có thể tạo tối đa 10 kệ mà không cần đặt dữ liệu nhắm mục tiêu, đồng thời có thể tạo tối đa 100 kệ có dữ liệu nhắm mục tiêu.

    Ngoài ra, thuộc tính targeting của tài nguyên channelSection đã được cập nhật để phản ánh thực tế là các tuỳ chọn nhắm mục tiêu chỉ có thể được đặt bằng API. Tùy chọn nhắm mục tiêu bị xóa nếu phần kênh được sửa đổi bằng cách sử dụng giao diện người dùng trên trang web YouTube.

  • Định nghĩa về thuộc tính snippet.name của tài nguyên i18nLanguage đã được sửa để phản ánh rằng giá trị này đại diện cho tên của một ngôn ngữ như được viết bằng ngôn ngữ được chỉ định bằng tham số hl của phương thức i18nLanguage.list.

  • Thuộc tính contentDetails.note của tài nguyên playlistItem đã được cập nhật để lưu ý rằng độ dài tối đa của giá trị thuộc tính là 280 ký tự.

  • Các thuộc tính contentDetails.startAt và contentDetails.endAt của tài nguyên playlistItem không còn được dùng nữa. Các trường này sẽ bị bỏ qua nếu được đặt trong yêu cầu playlistItems.insert hoặc playlistItems.update.

  • Phương thức playlistItems.delete và playlistItems.update hiện hỗ trợ tham số onBehalfOfContentOwner. Tham số này hiện đã được hỗ trợ cho một số phương thức khác. Các yêu cầu dùng phương thức đó cũng cần được uỷ quyền bằng mã thông báo cấp quyền truy cập vào phạm vi https://www.googleapis.com/auth/youtubepartner.

  • Cả hai tham số publishedBefore và publishedAfter của phương thức search.list đều đã được cập nhật để cho biết rằng các giá trị tham số này đã được đưa vào. Vì vậy, chẳng hạn như nếu tham số publishedBefore được đặt, API sẽ trả về các tài nguyên được tạo trước hoặc tại thời điểm được chỉ định.

  • Thuộc tính contentDetails.contentRating.grfilmRating của tài nguyên video hỗ trợ ba giá trị bổ sung: grfilmK12, grfilmK15 và grfilmK18.

  • Nội dung mô tả phương thức videos.insert đã được cập nhật để lưu ý rằng kích thước tệp tối đa của video tải lên đã tăng từ 64 GB lên 128 GB.

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

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

    Loại lỗi	Chi tiết về lỗi	Mô tả
    forbidden (403)	homeParameterDeprecated	Phương thức activities.list trả về lỗi này để cho biết rằng dữ liệu hoạt động trên trang chủ của người dùng không có sẵn thông qua API này. Lỗi này có thể xảy ra nếu bạn đặt tham số home thành true trong một yêu cầu trái phép.
    invalidValue (400)	invalidContentDetails	Phương thức playlistItems.insert trả về lỗi này để cho biết đối tượng contentDetails trong yêu cầu không hợp lệ. Lỗi này có một nguyên nhân là do trường contentDetails.note dài hơn 280 ký tự.
    forbidden (403)	watchHistoryNotAccessible	Phương thức playlistItems.list trả về lỗi này để cho biết yêu cầu đã cố truy xuất "nhật ký xem" mục trong danh sách phát nhưng không thể truy xuất các mục đó bằng API.
    forbidden (403)	watchLaterNotAccessible	Phương thức playlistItems.list trả về lỗi này để cho biết yêu cầu đã cố truy xuất "xem sau" mục trong danh sách phát nhưng không thể truy xuất các mục đó bằng API.
    badRequest (400)	uploadLimitExceeded	Phương thức videos.insert trả về lỗi này để cho biết kênh đã vượt quá số lượng video có thể tải lên.
    forbidden (403)	forbiddenEmbedSetting	Phương thức videos.update trả về lỗi này để cho biết yêu cầu API tìm cách đặt chế độ cài đặt nhúng không hợp lệ cho video. Xin lưu ý rằng một số kênh có thể không có quyền cung cấp trình phát được nhúng cho sự kiện phát trực tiếp. Hãy tham khảo Trung tâm trợ giúp của YouTube để biết thêm thông tin.

  • Phương thức playlistItems.insert không còn trả về lỗi nữa nếu bạn chèn video trùng lặp vào danh sách phát. Trước đây, chúng tôi đã gặp lỗi này đối với một số danh sách phát (chẳng hạn như video yêu thích) không cho phép trùng lặp nhưng không còn được hỗ trợ. Nhìn chung, danh sách phát cho phép đăng video trùng lặp.

• Thông tin cập nhật khác

  • Mục nhập nhật ký sửa đổi vào ngày 15 tháng 9 năm 2016 đã được cập nhật để làm rõ rằng bất cứ khi nào thuộc tính contentDetails.relatedPlaylists.watchHistory và contentDetails.relatedPlaylists.watchLater của tài nguyên channel được đưa vào phản hồi thì chúng luôn chứa giá trị HL và WL tương ứng. Hơn nữa, các thuộc tính đó chỉ được đưa vào nếu người dùng được uỷ quyền truy xuất dữ liệu về kênh riêng của người dùng đó.

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

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

• Bản cập nhật lịch sử sửa đổi ngày 11 tháng 8 năm 2016 đã thảo luận một số thay đổi liên quan đến ID chủ đề, bao gồm cả việc bộ ID chủ đề được hỗ trợ sẽ thay đổi kể từ ngày 10 tháng 2 năm 2017. Danh sách các chủ đề sẽ được hỗ trợ sẽ được công bố vào ngày 10 tháng 11 năm 2016.

• Những thay đổi sau đây hiện đã có hiệu lực. Thông báo về những thay đổi này được cung cấp trong bản cập nhật lịch sử sửa đổi vào ngày 11 tháng 8 năm 2016:

  • Nếu phương thức activities.list được gọi với tham số home được đặt thành true, thì phản hồi của API giờ đây sẽ chứa các mục tương tự như nội dung mà một người dùng YouTube đã đăng xuất sẽ thấy trên trang chủ.

    Đây là một thay đổi nhỏ nhằm cung cấp trải nghiệm người dùng tốt hơn so với hành vi được mô tả trong bản cập nhật lịch sử sửa đổi vào ngày 11 tháng 8 năm 2016. Nội dung cập nhật đó đã nêu rõ rằng các yêu cầu sử dụng tham số home sẽ trả về một danh sách trống.

  • Thuộc tính contentDetails.relatedPlaylists.watchHistory và contentDetails.relatedPlaylists.watchLater của tài nguyên channel hiện chứa các giá trị HL và WL tương ứng cho tất cả các kênh.

    Để cho rõ ràng, các thuộc tính này chỉ hiển thị cho người dùng được uỷ quyền khi truy xuất dữ liệu về kênh riêng của người dùng đó. Các thuộc tính luôn chứa các giá trị HL và WL, ngay cả đối với người dùng được uỷ quyền truy xuất dữ liệu về kênh riêng của người dùng đó. Do đó, không thể truy xuất nhật ký xem và mã danh sách phát xem sau qua API.

    Ngoài ra, các yêu cầu truy xuất thông tin chi tiết về danh sách phát (playlists.list) hoặc các mục trong danh sách phát (playlistItems.list) trong danh sách phát xem hoặc danh sách phát xem sau của kênh giờ đây sẽ trả về danh sách trống. Hành vi này đúng với các giá trị mới (HL và WL), cũng như mọi mã danh sách phát trong danh sách video đã xem hoặc danh sách phát xem sau mà Ứng dụng API của bạn có thể đã lưu trữ.

• Đối tượng fileDetails.recordingLocation của tài nguyên video và các thuộc tính con của tài nguyên đó không còn được trả về nữa. Trước đây, chỉ chủ sở hữu video mới có thể truy xuất dữ liệu này (chẳng hạn như đối tượng fileDetails mẹ).

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 đó.

• Việc Freebase và Freebase API ngừng hoạt động gây ra một số thay đổi liên quan đến mã chủ đề. Mã chủ đề được dùng trong các tài nguyên và phương thức API sau:

  • Phần topicDetails của tài nguyên channel xác định các chủ đề có liên quan đến kênh.
  • Phần topicDetails của tài nguyên video xác định các chủ đề có liên quan đến video.
  • Tham số topicId của phương thức search.list cho phép bạn tìm kiếm các video hoặc kênh liên quan đến một chủ đề cụ thể.

  Những thay đổi đối với các tính năng này là:

  • Kể từ ngày 10 tháng 2 năm 2017, YouTube sẽ bắt đầu trả về một nhóm nhỏ các mã chủ đề thay vì một nhóm mã nhận dạng chi tiết hơn nhiều được trả về từ trước đến nay. Tập hợp các chủ đề được hỗ trợ đó sẽ xác định các danh mục cấp cao như Thể thao hoặc Bóng rổ, nhưng chẳng hạn như chúng sẽ không xác định các đội hoặc cầu thủ cụ thể. Chúng tôi sẽ công bố nhóm các chủ đề được hỗ trợ để bạn có thời gian chuẩn bị đơn đăng ký cho thay đổi này.

  • Bạn có thể sử dụng mọi mã chủ đề Freebase để tìm nội dung cho đến hết ngày 10 tháng 2 năm 2017. Tuy nhiên, sau thời gian đó, bạn sẽ chỉ có thể sử dụng một số ít chủ đề được xác định trong mục trước để truy xuất kết quả tìm kiếm theo chủ đề.

  • Sau ngày 10 tháng 2 năm 2017, nếu bạn cố gắng tìm kiếm kết quả bằng mã chủ đề không nằm trong nhóm mã chủ đề được hỗ trợ ít hơn, thì API sẽ trả về một tập hợp kết quả trống.

• Một số trường và tham số API sẽ không được dùng nữa kể từ ngày 12 tháng 9 năm 2016:

  • Tham số home của phương thức activities.list cho phép người dùng được uỷ quyền truy xuất nguồn cấp dữ liệu hoạt động sẽ hiển thị trên trang chủ YouTube cho người dùng đó. Các yêu cầu sử dụng thông số này sau ngày 12 tháng 9 năm 2016 sẽ trả về một danh sách trống.

  • Các thuộc tính contentDetails.relatedPlaylists.watchHistory và contentDetails.relatedPlaylists.watchLater của tài nguyên channel chỉ hiển thị cho người dùng được uỷ quyền truy xuất dữ liệu về kênh riêng của người dùng đó. Sau ngày 12 tháng 9 năm 2016, contentDetails.relatedPlaylists.watchHistory sẽ trả về giá trị HL và thuộc tính contentDetails.relatedPlaylists.watchLater sẽ trả về giá trị WL cho tất cả các kênh.

    Sau ngày 12 tháng 9 năm 2016, yêu cầu truy xuất thông tin chi tiết về danh sách phát (playlists.list) cho danh sách phát xem hoặc danh sách phát xem sau của kênh sẽ trả về một danh sách trống. Sau thời điểm đó, yêu cầu truy xuất các mục trong danh sách phát (playlistItems.list) ở một trong các danh sách phát đó cũng sẽ trả về danh sách trống. Điều này đúng với các giá trị mới (HL và WL) cũng như với mọi mã nhận dạng danh sách phát xem sau hoặc nhật ký xem sau mà Ứng dụng API của bạn có thể đã lưu trữ.

  • Đối tượng fileDetails.recordingLocation của tài nguyên video hoặc bất kỳ thuộc tính con nào của tài nguyên đó sẽ không còn được trả về sau ngày 12 tháng 9 năm 2016. Chỉ chủ sở hữu video mới có thể truy xuất dữ liệu này vì chỉ chủ sở hữu video mới có thể truy xuất đối tượng fileDetails mẹ.

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

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

• Thuộc tính contentDetails.googlePlusUserId của tài nguyên channel không còn được dùng nữa. Trước đây, thuộc tính chỉ xuất hiện nếu kênh được liên kết với hồ sơ trên Google+. Sau khi chúng tôi ngừng sử dụng thuộc tính này, thuộc tính này sẽ không còn xuất hiện trong bất kỳ tài nguyên channel nào nữa.

• Thuộc tính snippet.authorGoogleplusProfileUrl của tài nguyên comment không còn được dùng nữa. Trước đây, thuộc tính chỉ xuất hiện nếu kênh được liên kết với hồ sơ trên Google+. Sau khi chúng tôi ngừng sử dụng thuộc tính này, thuộc tính này sẽ không còn xuất hiện trong bất kỳ tài nguyên comment nào nữa.

Vì không có thuộc tính nào trong số này được trả về sau khi ngừng sử dụng nên cả hai thuộc tính đều đã bị xoá khỏi tài liệu về tài nguyên tương ứng.

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

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

• Tham số myRecentSubscribers mới của phương thức subscriptions.list truy xuất danh sách người đăng ký kênh của người dùng đã xác thực theo trình tự thời gian ngược của thời gian mà họ đã đăng ký kênh.

  Xin lưu ý rằng tham số mới chỉ hỗ trợ truy xuất 1.000 người đăng ký gần đây nhất đối với kênh của người dùng đã xác thực. Để truy xuất danh sách đầy đủ những người đăng ký, hãy sử dụng tham số mySubscribers. Tham số này không trả về số người đăng ký theo thứ tự cụ thể và không giới hạn số lượng người đăng ký có thể truy xuất.

• Chúng tôi đã cập nhật định nghĩa của thuộc tính snippet.thumbnails.(key) cho các tài nguyên hoạt động, playlistItem, danh sách phát, kết quả tìm kiếm, hình thu nhỏ và video. Xin lưu ý rằng kích thước hình thu nhỏ bổ sung chỉ áp dụng cho một số video.

  • Hình ảnh standard rộng 640px và cao 480px.
  • Hình ảnh maxres rộng 1280px và cao 720px.

• Định nghĩa về tham số part của phương thức channelSection.list đã được cập nhật để lưu ý rằng phần targeting có thể được truy xuất với chi phí là 2 đơn vị hạn mức.

• Phương thức videos.list hiện trả về lỗi bị cấm (403) khi một yêu cầu được uỷ quyền không hợp lệ cố gắng truy xuất các phần fileDetails, processingDetails hoặc suggestions của tài nguyên video. Chỉ chủ sở hữu video mới xem được những phần đó.

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

Công cụ mới Đoạn mã API dữ liệu cung cấp các đoạn mã ngắn cho các trường hợp sử dụng phổ biến của YouTube Data API. Đoạn mã hiện dùng được cho mọi phương thức API chỉ có thể đọc trong Apps Script, Go, JavaScript, PHP, Python và Ruby.

Đối với mỗi phương thức, công cụ này sẽ hiển thị mã mẫu cho một hoặc nhiều trường hợp sử dụng. Ví dụ: đoạn mã này cung cấp 5 đoạn mã cho phương thức search.list:

• Liệt kê video theo từ khoá
• Liệt kê video theo vị trí
• Liệt kê sự kiện trực tiếp
• Tìm kiếm video của người dùng đã xác thực
• Liệt kê các video có liên quan

Đối với mỗi trường hợp sử dụng, công cụ này sẽ cho thấy các tham số dùng trong yêu cầu API. Bạn có thể sửa đổi các giá trị thông số, trong trường hợp đó, công cụ sẽ cập nhật các đoạn mã để phản ánh các giá trị thông số mà bạn đã cung cấp.

Cuối cùng, công cụ này cho thấy phản hồi của API cho mỗi yêu cầu. Nếu bạn đã sửa đổi các tham số yêu cầu, thì phản hồi của API sẽ dựa trên các giá trị tham số mà bạn cung cấp. Xin lưu ý rằng bạn cần cho phép công cụ thay mặt bạn gửi yêu cầu để phản hồi của API hiển thị.

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

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

• Thuộc tính contentDetails.projection mới của tài nguyên video chỉ định định dạng chiếu của video. Các giá trị thuộc tính hợp lệ là 360 và rectangular.

• Cả hai thuộc tính recordingDetails.location và fileDetails.recordingLocation của tài nguyên video đều được cập nhật để giải thích sự khác biệt giữa 2 thuộc tính:

  • Thuộc tính recordingDetails.location xác định vị trí mà chủ sở hữu video muốn liên kết với video. Người dùng có thể chỉnh sửa, tìm kiếm thông tin vị trí này trên các video công khai và có thể hiển thị cho người dùng trong các video công khai.
  • Giá trị thuộc tính fileDetails.recordingLocation là không thể thay đổi và đại diện cho vị trí liên kết với tệp video gốc đã tải lên. Chỉ chủ sở hữu video mới nhìn thấy giá trị này.

• Định nghĩa về thuộc tính contentDetails.relatedPlaylists.favorites của tài nguyên channel đã được cập nhật để lưu ý rằng giá trị thuộc tính có thể chứa mã nhận dạng danh sách phát tham chiếu đến một danh sách phát trống và không tìm nạp được. Lý do là chức năng video yêu thích đã không còn được dùng nữa. Xin lưu ý rằng thuộc tính này không phải tuân thủ chính sách về việc ngừng sử dụng API.

• Định nghĩa của lỗi ineligibleAccount (có thể được trả về bằng phương thức comments.insert, comments.update, commentThreads.insert hoặc commentThreads.update) đã được cập nhật để phản ánh rằng lỗi này xảy ra khi tài khoản YouTube dùng để cấp quyền cho yêu cầu API chưa được hợp nhất với Tài khoản Google của người dùng.

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

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

• Định nghĩa về tham số part của phương thức channels.update đã được cập nhật để lưu ý rằng localizations cũng là một giá trị hợp lệ cho tham số đó.

• Phần Mức sử dụng hạn mức trong hướng dẫn Bắt đầu đã được cập nhật để liên kết với Google Developer Console. Tại đây, bạn có thể xem hạn mức và mức sử dụng hạn mức thực tế của mình.

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

Bản cập nhật này có những 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ó

  • Tài liệu về tài nguyên channelBanner đã được cập nhật để lưu ý rằng kích thước đề xuất cho ảnh biểu ngữ kênh tải lên là 2560px x 1440px. Kích thước tối thiểu (2048px x 1152px) không thay đổi.

  • Thuộc tính snippet.customUrl mới của tài nguyên channel xác định URL tuỳ chỉnh liên kết với kênh. (Không phải kênh nào cũng có URL tuỳ chỉnh). Trung tâm trợ giúp YouTube giải thích điều kiện để nhận URL tuỳ chỉnh cũng như cách thiết lập URL.

  • Ngừng sử dụng đối tượng brandingSettings.watch của tài nguyên channel và mọi thuộc tính con của tài nguyên đó.

  • Phản hồi của API cho một yêu cầu search.list hiện chứa thuộc tính regionCode. Thuộc tính xác định mã vùng được sử dụng cho truy vấn tìm kiếm. Mã vùng hướng dẫn API trả về kết quả tìm kiếm cho quốc gia đã chỉ định.

    Giá trị thuộc tính là một mã quốc gia gồm hai chữ cái theo chuẩn ISO xác định khu vực. Phương thức i18nRegions.list trả về danh sách các khu vực được hỗ trợ. Giá trị mặc định là US. Nếu bạn đã chỉ định một khu vực không được hỗ trợ, YouTube vẫn có thể chọn một khu vực khác thay vì giá trị mặc định, để xử lý truy vấn.

  • Định nghĩa về các thuộc tính snippet.label và snippet.secondaryReasons[].label của tài nguyên videoAbuseReportReason đã được cập nhật để lưu ý rằng các thuộc tính này chứa văn bản nhãn đã bản địa hoá vì lý do báo cáo hành vi sai trái.

    Ngoài ra, phương thức videoAbuseReportReasons.list hiện hỗ trợ tham số hl. Tham số này chỉ định ngôn ngữ cần dùng cho văn bản nhãn trong phản hồi của API. Giá trị tham số mặc định là en_US.

  • Thuộc tính contentDetails.contentRating.ecbmctRating mới của tài nguyên video xác định mức phân loại của một video theo Uỷ ban Đánh giá và Phân loại thuộc Bộ Văn hoá và Du lịch Thổ Nhĩ Kỳ.

    Ngoài ra, các thuộc tính API cho những hệ thống phân loại khác hỗ trợ các giá trị thuộc tính mới sau đây:

    • contentDetails.contentRating.fpbRating (Nam Phi)
      Xếp hạng: 10; giá trị thuộc tính: fpb10
    • contentDetails.contentRating.moctwRating (Đài Loan)
      Xếp hạng: R-12; giá trị thuộc tính: moctwR12
    • contentDetails.contentRating.moctwRating (Đài Loan)
      Xếp hạng: R-15; giá trị thuộc tính: moctwR15

  • Thuộc tính liveStreamingDetails.activeLiveChatId của tài nguyên video chứa mã nhận dạng của cuộc trò chuyện trực tiếp đang diễn ra được liên kết với video đó. Giá trị thuộc tính chỉ xuất hiện nếu video đó là một chương trình phát sóng trực tiếp hiện tại và đã bật tính năng trò chuyện trực tiếp. Sau khi chương trình phát sóng kết thúc và cuộc trò chuyện trực tiếp kết thúc, tài sản sẽ không còn được trả về cho video đó nữa.

  • Thuộc tính status.rejectionReason của tài nguyên video hỗ trợ giá trị thuộc tính mới legal.

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

  Loại lỗi	Chi tiết về lỗi	Mô tả
  badRequest (400)	notEditable	Các phương thức channelSections.insert, channelSections.update và channelSections.delete sẽ trả về lỗi này để cho biết không thể tạo, cập nhật hoặc xoá phần kênh đã chỉ định.
  badRequest (400)	styleRequired	Phương thức channelSections.insert và channelSections.update trả về lỗi này để cho biết rằng tài nguyên channelSection được gửi trong yêu cầu API phải chỉ định một giá trị cho thuộc tính snippet.style.
  badRequest (400)	typeRequired	Phương thức channelSections.insert và channelSections.update trả về lỗi này để cho biết rằng tài nguyên channelSection được gửi trong yêu cầu API phải chỉ định một giá trị cho thuộc tính snippet.type.
  badRequest (400)	processingFailure	Phương thức commentThreads.list trả về lỗi này để cho biết rằng máy chủ API không xử lý được yêu cầu. Mặc dù đây có thể là lỗi tạm thời, nhưng lỗi này thường cho biết dữ liệu đầu vào của yêu cầu không hợp lệ. Hãy kiểm tra cấu trúc của tài nguyên commentThread trong nội dung yêu cầu để đảm bảo cấu trúc này hợp lệ.
  forbidden (403)	commentsDisabled	Phương thức commentThreads.list trả về lỗi này để cho biết rằng video được xác định bằng thông số videoId đã tắt tính năng bình luận.
  badRequest (400)	commentTextTooLong	Phương thức commentThreads.insert trả về lỗi này để cho biết rằng tài nguyên comment đang được chèn có chứa quá nhiều ký tự trong thuộc tính snippet.topLevelComment.snippet.textOriginal.
  invalidValue (400)	videoAlreadyInAnotherSeriesPlaylist	Phương thức playlistItems.insert trả về lỗi này để cho biết rằng video mà bạn đang cố gắng thêm vào danh sách phát đã có trong một danh sách phát theo bộ khác. Hãy truy cập vào Trung tâm trợ giúp của YouTube để tìm hiểu thêm thông tin về danh sách phát theo bộ.
  badRequest (400)	subscriptionForbidden	Phương thức subscriptions.insert trả về lỗi này để cho biết rằng bạn đã đạt đến số lượng gói thuê bao tối đa hoặc đã tạo quá nhiều gói thuê bao gần đây. Trong trường hợp thứ hai, bạn có thể thử lại yêu cầu sau vài giờ.
  badRequest (400)	invalidCategoryId	Phương thức videos.update trả về lỗi này để cho biết rằng thuộc tính snippet.categoryId trong tài nguyên video tải lên đã chỉ định một mã danh mục không hợp lệ. Hãy sử dụng phương thức videoCategories.list để truy xuất các danh mục được hỗ trợ.
  badRequest (400)	invalidDescription	Phương thức videos.update trả về lỗi này để cho biết rằng thuộc tính snippet.description trong tài nguyên video tải lên đã chỉ định một giá trị không hợp lệ.
  badRequest (400)	invalidPublishAt	Phương thức videos.update trả về lỗi này để cho biết rằng thuộc tính status.publishAt trong tài nguyên video đã tải lên đã chỉ định thời gian xuất bản theo lịch không hợp lệ.
  badRequest (400)	invalidRecordingDetails	Phương thức videos.update trả về lỗi này để cho biết rằng đối tượng recordingDetails trong tài nguyên video đã tải lên đã chỉ định thông tin chi tiết về bản ghi không hợp lệ.
  badRequest (400)	invalidTags	Phương thức videos.update trả về lỗi này để cho biết rằng thuộc tính snippet.tags trong tài nguyên video tải lên đã chỉ định một giá trị không hợp lệ.
  badRequest (400)	invalidTitle	Phương thức videos.update trả về lỗi này để cho biết rằng thuộc tính snippet.title trong tài nguyên video tải lên đã chỉ định một tiêu đề video không hợp lệ hoặc trống.
  badRequest (400)	invalidVideoMetadata	Phương thức videos.update trả về lỗi này để cho biết siêu dữ liệu của yêu cầu không hợp lệ. Lỗi này xảy ra nếu yêu cầu cập nhật phần snippet của tài nguyên video nhưng không đặt giá trị cho cả hai thuộc tính snippet.title và snippet.categoryId.

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 19 tháng 11 năm 2015

API này hiện hỗ trợ khả năng thiết lập và truy xuất văn bản đã bản địa hoá cho thuộc tính snippet.title và snippet.description của tài nguyên playlist và video, thuộc tính snippet.title của tài nguyên channelSection và thuộc tính snippet.description của tài nguyên channel.

• Đặt tiêu đề và nội dung mô tả đã bản địa hoá

  Bạn có thể đặt giá trị đã bản địa hoá cho một tài nguyên khi gọi phương thức insert hoặc update cho tài nguyên đó. Để đặt giá trị đã bản địa hoá cho một tài nguyên, hãy làm theo cả hai cách sau:

  • Hãy đảm bảo đặt một giá trị cho thuộc tính snippet.defaultLanguage của tài nguyên. Thuộc tính đó sẽ xác định ngôn ngữ của các thuộc tính snippet.title và snippet.description của tài nguyên. Giá trị của giá trị này có thể là bất kỳ ngôn ngữ ứng dụng được hỗ trợ nào hoặc hầu hết các mã ngôn ngữ khác theo tiêu chuẩn ISO 639-1:2002. Ví dụ: Nếu tải một video có tiêu đề và nội dung mô tả bằng tiếng Anh lên, bạn sẽ đặt thuộc tính snippet.defaultLanguage thành en.

    Lưu ý về việc cập nhật tài nguyên channel: Để thiết lập thuộc tính snippet.defaultLanguage cho tài nguyên channel, bạn phải cập nhật thuộc tính brandingSettings.channel.defaultLanguage.

  • Thêm đối tượng localizations vào tài nguyên bạn đang cập nhật. Mỗi khoá đối tượng là một chuỗi xác định ngôn ngữ ứng dụng hoặc mã ngôn ngữ ISO 639-1:2002 và mỗi khoá ánh xạ tới một đối tượng chứa tiêu đề (và phần mô tả) được bản địa hoá cho tài nguyên.

    Đoạn mã mẫu dưới đây đặt ngôn ngữ mặc định của tài nguyên thành tiếng Anh. Ứng dụng này cũng thêm tiêu đề và nội dung mô tả đã bản địa hoá bằng tiếng Đức và tiếng Tây Ban Nha vào video:

    {
      "kind": "youtube#video",
      ...
      "snippet": {
        "title": "Playing soccer",
        "description": "We play soccer in the park on Sundays.",
        "defaultLanguage": "en",
        ...
      },
      "localizations":
        "de": {
          "title": "Fußball spielen",
          "description": "Wir spielen Fußball im Park am Sonntag"
        },
        "es": {
          "title": "Jugar al fútbol",
          "description": "Nosotros jugamos fútbol en el parque los domingos",
        }
      }
    }

  Lưu ý quan trọng: Hãy nhớ rằng khi bạn cập nhật dữ liệu đã bản địa hoá cho một tài nguyên, yêu cầu API của bạn phải bao gồm tất cả phiên bản đã bản địa hoá hiện có của dữ liệu đó. Ví dụ: Nếu tiếp theo, nếu bạn gửi yêu cầu thêm dữ liệu tiếng Bồ Đào Nha vào video trong ví dụ trên, thì yêu cầu đó sẽ phải thêm dữ liệu đã bản địa hoá sang tiếng Đức, tiếng Tây Ban Nha và tiếng Bồ Đào Nha.

• Truy xuất giá trị đã bản địa hoá

  API này hỗ trợ 2 cách truy xuất giá trị đã bản địa hoá cho tài nguyên:

  • Thêm tham số hl vào yêu cầu channels.list, channelSections.list, playlists.list hoặc videos.list để truy xuất dữ liệu đã bản địa hoá cho một ngôn ngữ cụ thể của ứng dụng mà trang web YouTube hỗ trợ. Nếu thông tin chi tiết về tài nguyên đã bản địa hoá có sẵn bằng ngôn ngữ đó, thì đối tượng snippet.localized của tài nguyên sẽ chứa các giá trị đã bản địa hoá. Tuy nhiên, nếu không có thông tin chi tiết đã bản địa hoá, đối tượng snippet.localized sẽ chứa thông tin chi tiết về tài nguyên bằng ngôn ngữ mặc định của tài nguyên.

    Ví dụ: giả sử một yêu cầu videos.list truy xuất dữ liệu cho video mô tả ở trên kèm theo dữ liệu đã bản địa hoá tiếng Đức và tiếng Tây Ban Nha. Nếu tham số hl được đặt thành de, tài nguyên sẽ chứa dữ liệu sau:

    {
      "kind": "youtube#video",
      ...
      "snippet": {
        "title": "Playing soccer",
        "description": "We play soccer in the park on Sundays.",
        "defaultLanguage": "en",
        "localized": {
          "title": "Fußball spielen",
          "description": "Wir spielen Fußball im Park am Sonntag"
        }
        ...
      }
    }

    Tuy nhiên, nếu tham số hl được đặt thành fr, thì đối tượng snippet.localized sẽ chứa tiêu đề và nội dung mô tả bằng tiếng Anh vì tiếng Anh là ngôn ngữ mặc định cho tài nguyên này và sẽ không có thông tin chi tiết đã bản địa hoá bằng tiếng Pháp.

    Quan trọng: Tham số hl chỉ hỗ trợ các giá trị xác định ngôn ngữ ứng dụng mà trang web YouTube hỗ trợ. Để xác định xem có văn bản đã bản địa hoá cho các ngôn ngữ khác hay không, bạn cần truy xuất phần localizations cho tài nguyên và bộ lọc để xác định xem văn bản đã bản địa hoá có tồn tại hay không.
    
    Ví dụ: bạn sẽ cần truy xuất danh sách bản địa hoá đầy đủ để xác định xem văn bản đã bản địa hoá có trong tiếng Anh Appalachian hay không.
    
    

  • Khi truy xuất tài nguyên, hãy thêm localizations vào giá trị tham số part để truy xuất tất cả thông tin chi tiết đã bản địa hoá cho tài nguyên đó. Nếu đang truy xuất dữ liệu đã bản địa hóa cho một ngôn ngữ không phải là ngôn ngữ ứng dụng YouTube hiện tại, bạn cần sử dụng phương pháp này để truy xuất tất cả nội dung bản địa hóa, sau đó lọc để xác định xem dữ liệu đã bản địa hóa mong muốn có tồn tại hay không.

• Lỗi liên quan đến giá trị văn bản đã bản địa hoá

  API này cũng hỗ trợ các lỗi mới sau đây cho giá trị văn bản đã bản địa hoá:

  Loại lỗi	Chi tiết về lỗi	Mô tả
  badRequest (400)	defaultLanguageNotSetError	Lỗi này cho biết rằng một yêu cầu cố gắng chèn hoặc cập nhật đối tượng localizations cho một tài nguyên không thành công vì thuộc tính snippet.defaultLanguage chưa được thiết lập cho tài nguyên đó. Phương thức channels.update, channelSections.insert, channelSections.update, playlists.insert, playlists.update, videos.insert và videos.update hỗ trợ lỗi này.
  badRequest (400)	localizationValidationError	Lỗi này cho biết không xác thực được một trong các giá trị trong đối tượng localizations của một tài nguyên. Ví dụ: lỗi này có thể xảy ra nếu đối tượng chứa mã ngôn ngữ không hợp lệ. Phương thức channels.update, channelSections.insert, channelSections.update, playlists.insert và playlists.update hỗ trợ lỗi này.

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

Bản cập nhật này có những 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ó

  • Tham số order của phương thức search.list đã được cập nhật để lưu ý rằng nếu bạn sắp xếp các chương trình phát sóng trực tiếp theo viewCount, thì kết quả API sẽ được sắp xếp theo chương trình phát sóng số người xem đồng thời trong khi chương trình phát sóng vẫn đang phát.

  • Tham số relatedToVideoId của phương thức search.list đã được cập nhật để lưu ý rằng nếu tham số này được đặt thì các tham số duy nhất được hỗ trợ khác là part, maxResults, pageToken, regionCode, relevanceLanguage, safeSearch, type (phải đặt thành video) và fields. Nội dung cập nhật này không phản ánh thay đổi về hành vi của API.

  • Định nghĩa về thuộc tính snippet.publishedAt của tài nguyên video đã được cập nhật để lưu ý rằng giá trị thuộc tính chỉ định ngày và giờ xuất bản video có thể khác với thời gian tải video lên. Ví dụ: nếu một video được tải lên dưới dạng video riêng tư rồi sau đó chuyển sang chế độ công khai, thì giá trị thuộc tính sẽ chỉ định thời gian đặt video đó ở chế độ công khai. Định nghĩa mới này cũng giải thích cách hệ thống điền giá trị cho video riêng tư và video không công khai.

    Thay đổi này không phản ánh thay đổi về hành vi của API.

  • Định nghĩa về thuộc tính status.publishAt của tài nguyên video đã được cập nhật để lưu ý:

    • Nếu đặt giá trị của thuộc tính này khi gọi phương thức videos.update, bạn cũng phải đặt giá trị thuộc tính status.privacyStatus thành private ngay cả khi video đã ở chế độ riêng tư.
    • Nếu yêu cầu lên lịch xuất bản video vào một thời điểm nào đó trong quá khứ, thì video đó sẽ được xuất bản ngay lập tức. Do đó, việc đặt thuộc tính status.publishAt thành ngày và giờ trong quá khứ cũng giống như việc thay đổi privacyStatus của video từ private thành public.

  • Thuộc tính contentDetails.contentRating.cncRating của tài nguyên video chỉ định mức phân loại của video theo Uỷ ban phân loại điện ảnh của Pháp. Thuộc tính này thay thế thuộc tính contentDetails.contentRating.fmocRating (hiện không dùng nữa).

  • Chúng tôi đã cập nhật định nghĩa về brandingSettings.channel.keywords của tài nguyên channel để phản ánh chính xác rằng giá trị thuộc tính chứa danh sách các chuỗi được phân tách bằng dấu cách chứ không phải danh sách được phân tách bằng dấu phẩy như đã nêu trước đây. Nội dung cập nhật này không phản ánh thay đổi về hành vi của API.

  • Tài liệu cho phương thức thumbnails.set đã được cập nhật để phản ánh chính xác rằng phần nội dung của yêu cầu có chứa hình thu nhỏ mà bạn đang tải lên và liên kết với một video. Nội dung yêu cầu không chứa tài nguyên thumbnail. Trước đây, tài liệu nói rằng bạn không nên cung cấp nội dung yêu cầu khi gọi phương thức này. Nội dung cập nhật này không phản ánh thay đổi về hành vi của API.

  • Phần mô tả của tài nguyên activity đã được cập nhật để phản ánh thực tế là phương thức activities.list hiện không bao gồm các tài nguyên liên quan đến bình luận mới trên video. snippet.type và contentDetails.comment của tài nguyên cũng đã được cập nhật.

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

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

    Chi tiết về lỗi
    activities.insert	Mã phản hồi HTTP badRequest (400) Lý do invalidMetadata Mô tả Thuộc tính kind không khớp với loại mã nhận dạng được cung cấp.
    commentThreads.update comments.insert comments.update	Mã phản hồi HTTP badRequest (400) Lý do commentTextTooLong Mô tả Tài nguyên comment đang được chèn hoặc cập nhật có chứa quá nhiều ký tự trong thuộc tính snippet.topLevelComment.snippet.textOriginal.
    playlistItems.insert playlistItems.update	Mã phản hồi HTTP forbidden (403) Lý do playlistItemsNotAccessible Mô tả Yêu cầu không được uỷ quyền hợp lệ để chèn, cập nhật hoặc xoá mục trong danh sách phát được chỉ định.
    playlists.delete playlists.insert playlists.update	Mã phản hồi HTTP badRequest (400) Lý do playlistForbidden Mô tả Hoạt động này bị cấm hoặc yêu cầu không được uỷ quyền hợp lệ.
    search.list	Mã phản hồi HTTP badRequest (400) Lý do invalidLocation Mô tả Giá trị tham số location và/hoặc locationRadius có định dạng không chính xác.
    search.list	Mã phản hồi HTTP badRequest (400) Lý do invalidRelevanceLanguage Mô tả Giá trị tham số relevanceLanguage có định dạng không chính xác.
    subscriptions.insert	Mã phản hồi HTTP badRequest (400) Lý do subscriptionForbidden Mô tả Lỗi này xảy ra khi bất kỳ trường hợp nào sau đây xảy ra: Gói thuê bao mà bạn đang cố tạo đã tồn tại Bạn đã đạt đến số lượng gói thuê bao tối đa Bạn đang cố đăng ký kênh của chính mình nhưng việc này không được hỗ trợ. Gần đây, bạn đã tạo quá nhiều gói thuê bao. Bạn cần chờ vài giờ rồi mới thử lại yêu cầu đăng ký.
    videos.update	Mã phản hồi HTTP badRequest (400) Lý do invalidDefaultBroadcastPrivacySetting Mô tả Yêu cầu này cố gắng thiết lập chế độ cài đặt quyền riêng tư không hợp lệ cho chương trình phát sóng mặc định.

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

Bản cập nhật này có những 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ó

  • Thuộc tính statistics.favoriteCount của tài nguyên video không còn được dùng nữa.

    Theo chính sách của chúng tôi về việc ngừng sử dụng, tài sản này sẽ tiếp tục xuất hiện trong các tài nguyên video trong ít nhất một năm kể từ khi có thông báo này. Tuy nhiên, giá trị thuộc tính hiện luôn được đặt thành 0.

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

Bản cập nhật này có những 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ó

  • Định nghĩa về thuộc tính snippet.tags[] của tài nguyên video đã được cập nhật để cung cấp thêm thông tin về cách máy chủ API tính toán độ dài giá trị của thuộc tính. Lưu ý rằng nội dung cập nhật này không phản ánh thay đổi về hành vi của API.

    Cụ thể, định nghĩa này hiện giải thích rằng nếu một thẻ có chứa dấu cách, thì máy chủ API sẽ xử lý giá trị thẻ như thể thẻ được gói trong dấu ngoặc kép và dấu ngoặc kép sẽ được tính vào giới hạn ký tự. Vì vậy, để hạn chế giới hạn ký tự, thẻ Foo-Baz chứa 7 ký tự, nhưng thẻ Foo Baz chứa 9 ký tự.

  • Phương thức commentThreads.insert không còn hỗ trợ tham số shareOnGooglePlus. Tham số này trước đây đã cho biết liệu một nhận xét và câu trả lời cho nhận xét đó có được đăng lên hồ sơ Google+ của tác giả hay không. Nếu một yêu cầu gửi tham số, máy chủ API sẽ bỏ qua tham số đó nhưng sẽ xử lý yêu cầu.

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

Bản cập nhật này có những 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ó

  • Tham số order mới của phương thức commentThreads.list chỉ định thứ tự mà phản hồi của API phải liệt kê các chuỗi nhận xét. Bạn có thể sắp xếp các chuỗi tin nhắn theo thời gian hoặc mức độ liên quan. Hành vi mặc định là sắp xếp dữ liệu theo thời gian.

  • Thuộc tính snippet.defaultAudioLanguage mới của tài nguyên video chỉ định ngôn ngữ nói trong bản âm thanh mặc định của video.

  • Định nghĩa về thuộc tính contentDetails.licensedContent của tài nguyên video đã được cập nhật để làm rõ rằng nội dung ban đầu phải được tải lên một kênh liên kết với một đối tác nội dung YouTube, sau đó đối tác đó xác nhận quyền sở hữu. Điều này không thể hiện sự thay đổi trong hành vi thực tế của API.

  • Phương thức captions.delete, captions.download, captions.insert, captions.list và captions.update hiện hỗ trợ tham số onBehalfOfContentOwner. Tham số này đã được hỗ trợ cho một số phương thức khác. Các yêu cầu dùng phương thức đó cũng cần được uỷ quyền bằng mã thông báo cấp quyền truy cập vào phạm vi https://www.googleapis.com/auth/youtubepartner.

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

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

    Chi tiết về lỗi
    videos.rate	Mã phản hồi HTTP badRequest (400) Lý do emailNotVerified Mô tả Người dùng phải xác minh địa chỉ email của mình trước khi xếp hạng video.
    videos.rate	Mã phản hồi HTTP badRequest (400) Lý do videoPurchaseRequired Mô tả Chỉ người dùng đã thuê video mới có thể đánh giá video cho thuê.

  • Phương thức subscriptions.delete và subscriptions.insert không còn hỗ trợ lỗi accountClosed và accountSuspended nữa.

Ngày 27 tháng 4 năm 2015

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

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

  • Tài nguyên videoAbuseReportReason mới có chứa thông tin về lý do video sẽ bị gắn cờ do chứa nội dung vi phạm. Phương thức videoAbuseReportReasons.list cho phép bạn truy xuất danh sách tất cả các lý do khiến video có thể bị gắn cờ.

  • Phương thức videos.reportAbuse mới cung cấp một cách để gắn cờ một video có chứa nội dung vi phạm trên thực tế. Nội dung của yêu cầu chứa đối tượng JSON chỉ rõ video bị gắn cờ cũng như lý do mà video đó bị coi là có chứa nội dung vi phạm. Có thể xác định được các lý do hợp lệ từ phương thức videoAbuseReportReason.list được mô tả ở trên.

    Hướng dẫn di chuyển cũng đã được cập nhật với một ví dụ về cách báo cáo video vi phạm. Với thay đổi này, API v3 hiện hỗ trợ tất cả các tính năng của API v2 mà API này lên lịch hỗ trợ. Tất cả các tính năng này cũng được giải thích trong hướng dẫn di chuyển.

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

  • Tham số bộ lọc forDeveloper mới của phương thức search.list giới hạn thao tác tìm kiếm để chỉ truy xuất video được tải lên thông qua ứng dụng hoặc trang web của nhà phát triển. Tham số forDeveloper có thể được sử dụng cùng với các tham số tìm kiếm không bắt buộc như tham số q.

    Đối với tính năng này, mỗi video tải lên được tự động gắn thẻ với số dự án được liên kết với ứng dụng của nhà phát triển trong Google Developers Console.

    Sau đó, khi một yêu cầu tìm kiếm đặt tham số forDeveloper thành true, máy chủ API sẽ sử dụng thông tin cấp phép của yêu cầu để xác định nhà phát triển. Do đó, nhà phát triển có thể giới hạn kết quả ở những video được tải lên thông qua ứng dụng hoặc trang web của chính nhà phát triển chứ không giới hạn ở những video được tải lên thông qua các ứng dụng hoặc trang web khác.

    Tính năng mới này cung cấp chức năng tương tự, mặc dù không giống hệt, với chức năng thẻ dành cho nhà phát triển mà API phiên bản 2 hỗ trợ.

  • Tài sản snippet.country mới của tài nguyên channel cho phép các chủ sở hữu kênh liên kết kênh của họ với một quốc gia cụ thể.

    Lưu ý: Để đặt thuộc tính snippet.country cho tài nguyên channel, bạn phải cập nhật thuộc tính brandingSettings.channel.country.

  • API này hiện hỗ trợ việc nhắm mục tiêu cho các tài nguyên channelSection. Tính năng nhắm mục tiêu theo phần kênh cung cấp cách thức để hạn chế khả năng hiển thị của một phần nội dung cho những người dùng phù hợp với các tiêu chí cụ thể.

    API này đưa ra 3 lựa chọn nhắm mục tiêu. Người dùng phải đáp ứng tất cả các chế độ cài đặt nhắm mục tiêu thì một phần kênh mới xuất hiện.

    • targeting.languages[]: Danh sách các ngôn ngữ trong ứng dụng YouTube. Người dùng đã chọn một trong các ngôn ngữ đó có thể xem phần kênh tương ứng.

    • targeting.regions[]: Danh sách các khu vực có nội dung ưu tiên trên YouTube. Phần kênh hiển thị đối với người dùng đã chọn một trong các vùng đó cũng như người dùng có một trong những vùng đó được chọn tự động.

    • targeting.countries[]: Danh sách các quốc gia nơi phần kênh xuất hiện. Mỗi giá trị trong danh sách là một mã quốc gia ISO 3166-1 alpha-2.

  • Định nghĩa về thuộc tính contentDetails.duration của tài nguyên video đã được sửa để phản ánh rằng giá trị này có thể phản ánh giờ, ngày, v.v.

  • Tài liệu về phương thức channelSections.delete, playlistItems.delete, playlists.delete, subscriptions.delete và videos.delete đã được sửa để phản ánh rằng khi thành công, các phương thức đó đều trả về mã phản hồi HTTP 204 (No Content).

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

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

    Loại lỗi	Chi tiết về lỗi	Mô tả
    badRequest (400)	targetInvalidCountry	Các phương thức channelSections.insert và channelSections.update sẽ trả về lỗi này nếu tài nguyên channelSection được chèn chứa giá trị không hợp lệ đối với thuộc tính targeting.countries[].
    badRequest (400)	targetInvalidLanguage	Các phương thức channelSections.insert và channelSections.update sẽ trả về lỗi này nếu tài nguyên channelSection được chèn chứa giá trị không hợp lệ đối với thuộc tính targeting.languages[].
    badRequest (400)	targetInvalidRegion	Các phương thức channelSections.insert và channelSections.update sẽ trả về lỗi này nếu tài nguyên channelSection được chèn chứa giá trị không hợp lệ đối với thuộc tính targeting.regions[].
    badRequest (400)	operationNotSupported	Phương thức comments.insert trả về lỗi này nếu người dùng API không thể chèn nhận xét để trả lời nhận xét cấp cao nhất do thuộc tính snippet.parentId xác định. Trong tài nguyên commentThread, thuộc tính snippet.canReply cho biết liệu người xem hiện tại có thể phản hồi luồng hay không.
    badRequest (400)	invalidChannelId	Phương thức search.list sẽ trả về lỗi này nếu tham số channelId trong yêu cầu đã chỉ định một mã nhận dạng kênh không hợp lệ.
    badRequest (400)	subscriptionForbidden	Phương thức subscriptions.insert trả về lỗi này nếu người dùng API cố gắng đăng ký kênh riêng của người dùng đó.

  • Phương thức captions.update không còn hỗ trợ các lỗi invalidMetadata và videoNotFound.

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

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

• Chúng tôi đã cập nhật hướng dẫn di chuyển để giải thích cách di chuyển những ứng dụng vẫn đang dùng chức năng nhận xét trong API phiên bản 2.

  Hướng dẫn này cũng nêu một số tính năng nhận xét mà API phiên bản 2 không hỗ trợ nhưng được hỗ trợ trong API phiên bản 3. Những quốc gia/khu vực này bao gồm:

  • Truy xuất bình luận về kênh
  • Truy xuất tất cả các chuỗi bình luận liên quan đến một kênh, tức là phản hồi của API có thể chứa bình luận về kênh hoặc bất kỳ video nào của kênh đó.
  • Cập nhật nội dung của nhận xét
  • Đánh dấu bình luận là bình luận rác
  • Đặt trạng thái kiểm duyệt của nhận xét

• Chúng tôi đã cập nhật hướng dẫn Đăng ký nhận thông báo đẩy để phản ánh việc thông báo chỉ được gửi đến trung tâm Google PubSubHubBub chứ không phải trung tâm Superfeedr như đã nêu trước đây.

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

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

• Các tài nguyên commentThread và comment mới của API cho phép bạn truy xuất, chèn, cập nhật, xoá và kiểm duyệt nhận xét.

  • Tài nguyên commentThread chứa thông tin về chuỗi bình luận trên YouTube, bao gồm một bình luận cấp cao nhất và các phản hồi cho bình luận đó (nếu có). Tài nguyên commentThread có thể biểu thị các bình luận về một video hoặc kênh.

    Nhận xét cấp cao nhất và các phản hồi thực sự là các tài nguyên comment được lồng bên trong tài nguyên commentThread. Điều quan trọng cần lưu ý là tài nguyên commentThread không nhất thiết chứa tất cả phản hồi cho một bình luận và bạn cần dùng phương thức comments.list nếu muốn truy xuất tất cả phản hồi cho một bình luận cụ thể. Ngoài ra, một số bình luận không có phản hồi.

    API này hỗ trợ các phương thức sau cho tài nguyên commentThread:

    • commentThreads.list – Truy xuất danh sách các chuỗi nhận xét. Bạn có thể dùng phương thức này để truy xuất bình luận liên quan đến một video hoặc kênh cụ thể.
    • commentThreads.insert – Tạo nhận xét ở cấp cao nhất mới. (Sử dụng phương thức comments.insert để trả lời một nhận xét hiện có.)
    • commentThreads.update – Sửa đổi nhận xét cấp cao nhất.

  • Tài nguyên comment chứa thông tin về một bình luận trên YouTube. Tài nguyên comment có thể đại diện cho một bình luận về một video hoặc kênh. Ngoài ra, bình luận có thể là bình luận cấp cao nhất hoặc phản hồi cho một bình luận cấp cao nhất.

    API này hỗ trợ các phương thức sau cho tài nguyên comment:

    • comments.list – Truy xuất danh sách nhận xét. Sử dụng phương thức này để truy xuất tất cả các phản hồi cho một nhận xét cụ thể.
    • comments.insert – Tạo phản hồi cho một bình luận hiện có.
    • comments.update – Sửa đổi nhận xét.
    • comments.markAsSpam – Gắn cờ một hoặc nhiều bình luận là vi phạm.
    • comments.setModerationStatus – Đặt trạng thái kiểm duyệt của một hoặc nhiều nhận xét. Ví dụ: Xoá một bình luận để hiển thị công khai hoặc từ chối một bình luận vì không phù hợp để hiển thị. Yêu cầu API phải được chủ sở hữu kênh hoặc video liên kết với bình luận cấp phép.
    • comments.delete – Xoá bình luận.

  Lưu ý rằng phạm vi https://www.googleapis.com/auth/youtube.force-ssl mới của API, được mô tả trong lịch sử sửa đổi ngày 2 tháng 4 năm 2015, là bắt buộc đối với các lệnh gọi đến các phương thức comments.insert, comments.update, comments.markAsSpam, comments.setModerationStatus, comments.delete, commentThreads.insert và commentThreads.update.

• Hướng dẫn Đăng ký nhận thông báo đẩy mới giải thích về tính năng hỗ trợ mới của API cho thông báo đẩy qua PubSubHubBub, một giao thức xuất bản/đăng ký từ máy chủ đến máy chủ cho các tài nguyên có thể truy cập trên web. Máy chủ gọi lại PubSubHubBub có thể nhận thông báo về nguồn cấp dữ liệu Atom khi một kênh thực hiện bất kỳ hoạt động nào sau đây:

  • tải một video lên
  • cập nhật tiêu đề của video
  • cập nhật mô tả của video

• Hướng dẫn di chuyển cũng đã được cập nhật để lưu ý về việc hỗ trợ thông báo đẩy mới. Tuy nhiên, vì API v2 hỗ trợ nhiều loại thông báo đẩy khác không được hỗ trợ trong API v3, nên việc đề cập đến hỗ trợ PubSubHubBub vẫn được liệt kê trong phần Không dùng nữa của hướng dẫn đó.

• Phạm vi https://www.googleapis.com/auth/youtube.force-ssl mới của API hiện là phạm vi hợp lệ cho mọi phương thức API trước đây đã hỗ trợ phạm vi https://www.googleapis.com/auth/youtube.

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

  Loại lỗi	Chi tiết về lỗi	Mô tả
  badRequest (400)	invalidRating	Phương thức videos.rate sẽ trả về lỗi này nếu yêu cầu chứa giá trị không mong muốn cho thông số rating.

• Phương thức subscriptions.insert không còn hỗ trợ lỗi subscriptionLimitExceeded. Lỗi này trước đây cho biết người đăng ký được xác định cùng yêu cầu đã vượt quá giới hạn tốc độ của gói thuê bao.

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

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

• Tài nguyên captions mới đại diện cho một bản phụ đề trên YouTube. Phụ đề được liên kết với chính xác một video trên YouTube.

  API này hỗ trợ các phương thức để liệt kê, chèn, cập nhật, tải xuống và xoá phụ đề.

• Chúng tôi cũng đã cập nhật hướng dẫn di chuyển để giải thích cách di chuyển các ứng dụng vẫn đang sử dụng chức năng phụ đề trong API v2.

• Phạm vi https://www.googleapis.com/auth/youtube.force-ssl mới của API yêu cầu hoạt động giao tiếp với máy chủ API diễn ra qua kết nối SSL.

  Phạm vi mới này cấp cùng quyền truy cập như phạm vi https://www.googleapis.com/auth/youtube. Trên thực tế, 2 phạm vi đó có chức năng giống nhau vì máy chủ API YouTube chỉ hoạt động qua một điểm cuối HTTPS. Do đó, mặc dù phạm vi https://www.googleapis.com/auth/youtube không yêu cầu kết nối SSL, nhưng thực tế không có cách nào khác để tạo yêu cầu API.

  Cần có phạm vi mới cho các lệnh gọi đến tất cả phương thức của tài nguyên caption.

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

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

• Hướng dẫn di chuyển API dữ liệu YouTube (v3) có một thẻ mới có tên là Mới trong API v3. Thẻ này liệt kê những tính năng mà API v3 có hỗ trợ và API v2 không hỗ trợ. Các tính năng tương tự trước đây và hiện vẫn được liệt kê trong các thẻ khác trong hướng dẫn. Ví dụ: tính năng mới giải thích cách cập nhật dữ liệu chiến dịch quảng cáo trong video của kênh cũng được liệt kê trong thẻ Kênh (hồ sơ).

• Chúng tôi đã cập nhật hướng dẫn di chuyển API dữ liệu YouTube (v3) để lưu ý rằng API v3 sẽ hỗ trợ tính năng sau đây của API v2:

  • Gắn cờ cho video

• Chúng tôi đã cập nhật hướng dẫn di chuyển sang API dữ liệu YouTube (v3) để lưu ý rằng các tính năng sau đây của API phiên bản 2 sẽ không được hỗ trợ trong API phiên bản 3:

  • Truy xuất đề xuất video – API v3 không truy xuất danh sách chỉ chứa các video được đề xuất cho người dùng API hiện tại. Tuy nhiên, bạn có thể sử dụng API v3 để tìm các video đề xuất bằng cách gọi phương thức activities.list và đặt giá trị tham số home thành true.

    Trong phản hồi của API, một tài nguyên sẽ tương ứng với một video đề xuất nếu giá trị của thuộc tính snippet.type là recommendation. Trong trường hợp đó, thuộc tính contentDetails.recommendation.reason và contentDetails.recommendation.seedResourceId sẽ chứa thông tin về lý do video đó được đề xuất. Lưu ý rằng không có đảm bảo rằng câu trả lời sẽ chứa bất kỳ số lượng video đề xuất cụ thể nào.

  • Truy xuất đề xuất kênh

  • Truy xuất video đăng ký mới – API v3 không truy xuất danh sách chỉ chứa các video đã được tải lên gần đây lên các kênh mà người dùng API đăng ký. Tuy nhiên, bạn có thể sử dụng API v3 để tìm video mới của các gói thuê bao bằng cách gọi phương thức activities.list và đặt giá trị tham số home thành true.

    Trong phản hồi của API, một tài nguyên sẽ tương ứng với một video mới của gói thuê bao nếu giá trị của thuộc tính snippet.type là upload. Lưu ý rằng không có đảm bảo rằng phản hồi sẽ chứa bất kỳ số lượng cụ thể nào của video đăng ký mới.

  • Hỗ trợ nguồn cấp dữ liệu RSS

  • Thông báo đẩy để cập nhật nguồn cấp dữ liệu – API v2 hỗ trợ thông báo đẩy, sử dụng Giao thức cập nhật đơn giản (sup) hoặc PubSubHubbub để giám sát nguồn cấp dữ liệu hoạt động của người dùng cho người dùng YouTube. Chúng tôi gửi thông báo khi có người đăng ký theo dõi kênh mới và khi người dùng xếp hạng, chia sẻ, đánh dấu video là yêu thích, bình luận hoặc tải lên video.

    API v3 sẽ hỗ trợ thông báo đẩy bằng cách sử dụng giao thức PubSubHubbub nhưng thông báo sẽ chỉ bao gồm video tải lên và nội dung cập nhật cho tiêu đề video hoặc phần mô tả video.

  • Vị trí kênh – API v2 đã sử dụng thẻ <yt:location> để xác định vị trí của người dùng như đã nhập trong hồ sơ công khai trên YouTube của kênh. Mặc dù một số nhà phát triển sử dụng trường này để liên kết kênh với quốc gia cụ thể nhưng dữ liệu của trường này không thể được sử dụng một cách nhất quán cho mục đích đó.

  • Đặt hoặc truy xuất thẻ nhà phát triển – API v2 hỗ trợ khả năng liên kết từ khoá hoặc thẻ nhà phát triển với video tại thời điểm tải video lên. Thẻ dành cho nhà phát triển sẽ không hiển thị với người dùng YouTube nhưng chủ sở hữu video có thể truy xuất các video khớp với một thẻ nhà phát triển cụ thể.

    API phiên bản 3 sẽ cung cấp tính năng tương tự, nhưng không giống hệt. Cụ thể là nhà phát triển sẽ có thể tìm kiếm các video được tải lên bằng ứng dụng riêng của nhà phát triển. Đối với tính năng này, mỗi video tải lên được tự động gắn thẻ với số dự án được liên kết với ứng dụng của nhà phát triển trong Google Developers Console. Sau đó, nhà phát triển sử dụng chính số dự án đó để tìm kiếm video.

  • Liệt kê video theo ngày xuất bản, số lượt xem hoặc xếp hạng – Trong API v2, tham số orderby cho phép bạn sắp xếp video trong danh sách phát theo vị trí, thời lượng, ngày xuất bản, tiêu đề và một vài giá trị khác. Trong API v3, các mục trong danh sách phát thường được sắp xếp theo vị trí theo thứ tự tăng dần và không có các lựa chọn sắp xếp khác.

    Có một vài ngoại lệ. Hệ thống sẽ tự động thêm video mới tải lên, video yêu thích, video đã thích hoặc video đã xem gần đây làm mục đầu tiên (snippet.position=0) cho các loại danh sách phát sau. Vì vậy, mỗi danh sách trong số này được sắp xếp hiệu quả theo thứ tự mục mới nhất đến cũ nhất dựa trên lần thêm mục vào danh sách.

    • video do người dùng tải lên
    • video yêu thích
    • video đã thích
    • lịch sử xem

    Tuy nhiên, lưu ý rằng mục mới đã được thêm vào phần "Xem sau" danh sách phát được thêm vào dưới dạng mục cuối cùng trong danh sách đó, do đó danh sách được sắp xếp hiệu quả từ mục cũ nhất đến mục mới nhất.

  • Xử lý theo lô – API v3 hỗ trợ một trong các trường hợp sử dụng xử lý hàng loạt mà API v2 đã hỗ trợ. Các phương thức channels.list, channelSections.list, guideCategories.list, playlistItems.list, playlists.list, subscriptions.list, videoCategories.list và videos.list của API phiên bản 3 đều hỗ trợ tham số id. Bạn có thể dùng tham số này để chỉ định danh sách mã nhận dạng được phân tách bằng dấu phẩy (mã video, mã nhận dạng kênh, v.v.). Khi sử dụng các phương thức đó, bạn có thể truy xuất danh sách nhiều tài nguyên qua một yêu cầu duy nhất.

  Với những thay đổi này, giờ đây hướng dẫn sẽ xác định tất cả chức năng được hỗ trợ trong API (v2) cũ sẽ không được dùng nữa trong phiên bản API hiện tại (v3).

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

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

• Phương thức channelSections.delete và channelSections.update hiện hỗ trợ tham số onBehalfOfContentOwner. Tham số này hiện đã được hỗ trợ cho một số phương thức khác.

• Các thuộc tính sau cũng như các thuộc tính con của chúng đã ngừng hoạt động:

  • brandingSettings.image.backgroundImageUrl
  • brandingSettings.image.largeBrandedBannerImageImapScript
  • brandingSettings.image.largeBrandedBannerImageUrl
  • brandingSettings.image.smallBrandedBannerImageImapScript
  • brandingSettings.image.smallBrandedBannerImageUrl

  Lưu ý: Không có thuộc tính nào trong số này phải tuân thủ Chính sách về việc ngừng sử dụng API.

• Thuộc tính contentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons mới của tài nguyên video xác định lý do giải thích vì sao video nhận được xếp hạng DJCQT (Brazil).

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

  Loại lỗi	Chi tiết về lỗi	Mô tả
  notFound (404)	channelNotFound	Phương thức channels.update trả về lỗi này nếu tham số id của yêu cầu chỉ định một kênh không thể tìm thấy.
  badRequest (400)	manualSortRequiredinvalidValue	Phương thức playlistItems.insert và playlistItems.update trả về lỗi này nếu yêu cầu cố gắng đặt vị trí của mục trong danh sách phát nhưng danh sách phát không sử dụng phương thức sắp xếp thủ công. Ví dụ: các mục trong danh sách phát có thể được sắp xếp theo ngày hoặc mức độ phổ biến. Bạn có thể giải quyết lỗi này bằng cách xoá phần tử snippet.position khỏi tài nguyên được gửi trong nội dung yêu cầu. Nếu muốn mục danh sách phát có một vị trí cụ thể trong danh sách, trước tiên, bạn cần cập nhật chế độ cài đặt sắp xếp của danh sách phát thành Thủ công. Bạn có thể điều chỉnh chế độ cài đặt này trong Trình quản lý video trên YouTube.
  forbidden (403)	channelClosed	Phương thức playlists.list sẽ trả về lỗi này nếu tham số channelId của yêu cầu chỉ định một kênh đã bị đóng.
  forbidden (403)	channelSuspended	Phương thức playlists.list sẽ trả về lỗi này nếu tham số channelId của yêu cầu chỉ định một kênh đã bị tạm ngưng.
  forbidden (403)	playlistForbidden	Phương thức playlists.list sẽ trả về lỗi này nếu tham số id của yêu cầu không hỗ trợ yêu cầu đó hoặc yêu cầu không được uỷ quyền đúng cách.
  notFound (404)	channelNotFound	Phương thức playlists.list trả về lỗi này nếu tham số channelId của yêu cầu chỉ định một kênh không thể tìm thấy.
  notFound (404)	playlistNotFound	Phương thức playlists.list sẽ trả về lỗi này nếu tham số id của yêu cầu chỉ định một danh sách phát không thể tìm thấy.
  notFound (404)	videoNotFound	Phương thức videos.list trả về lỗi này nếu tham số id của yêu cầu chỉ định một video không thể tìm thấy.
  badRequest (400)	invalidRating	Phương thức videos.rate sẽ trả về lỗi này nếu yêu cầu chứa giá trị ngoài dự kiến cho thông số rating.

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

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

• Phương thức search.list hiện hỗ trợ tham số relevanceLanguage, cho phép bạn yêu cầu các kết quả phù hợp nhất với một ngôn ngữ cụ thể.

  Chúng tôi cũng đã cập nhật Hướng dẫn di chuyển API Dữ liệu YouTube (v3) để giải thích cách sử dụng thông số mới này. Tham số này giải quyết một thiếu sót về tính năng trước đây đã tồn tại giữa phiên bản API hiện tại (v3) và phiên bản trước đó (v2), nhưng không được dùng nữa.

• Hướng dẫn di chuyển API dữ liệu YouTube (v3) cũng đã được cập nhật để cho biết về việc ngừng sử dụng các trường siêu dữ liệu và nguồn cấp dữ liệu đặc biệt mà API v2 cung cấp để mô tả phim, đoạn giới thiệu, chương trình truyền hình, phần chương trình truyền hình và tập phim truyền hình.

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

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

• Chúng tôi đã cập nhật hướng dẫn di chuyển sang API dữ liệu YouTube (v3) để giải thích cách sử dụng API v3 để tải video lên bằng JavaScript. (Xem phần Tải video lên để biết thông tin chi tiết.) Chức năng này tương tự như chức năng tải lên dựa trên trình duyệt mà API phiên bản 2 hỗ trợ. Xin lưu ý rằng thay đổi này trong hướng dẫn di chuyển không phản ánh thay đổi thực tế về API mà phản ánh khả năng cung cấp mã mẫu mới để tải video lên bằng JavaScript phía máy khách.

  Do hỗ trợ tải video lên bằng thư viện ứng dụng JavaScript và CORS, hướng dẫn di chuyển không còn liệt kê tính năng tải lên dựa trên trình duyệt dưới dạng một tính năng có thể không được dùng nữa trong API v3.

• Tài liệu về phương thức videos.insert đã được cập nhật để bao gồm mã JavaScript mẫu mới được mô tả ở trên. Danh sách các mẫu mã JavaScript cho API dữ liệu YouTube (v3) cũng đã được cập nhật.

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

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

• Chi phí hạn mức cho một lệnh gọi phương thức search.list đã thay đổi thành 100 đơn vị.

  Lưu ý quan trọng: Trong nhiều trường hợp, bạn có thể sử dụng các phương thức API khác để truy xuất thông tin với chi phí thấp hơn. Ví dụ: hãy xem xét hai cách sau để tìm video được tải lên kênh GoogleDevelopers.

  • Giá hạn mức: 100 đơn vị

    Gọi phương thức search.list rồi tìm GoogleDevelopers.

  • Chi phí hạn mức: 6 đơn vị

    Gọi phương thức channels.list để tìm đúng mã nhận dạng kênh. Đặt tham số forUsername thành GoogleDevelopers và tham số part thành contentDetails. Trong phản hồi của API, thuộc tính contentDetails.relatedPlaylists.uploads chỉ định mã nhận dạng danh sách phát của các video được tải lên kênh.

    Sau đó, hãy gọi phương thức playlistItems.list và đặt tham số playlistId thành mã nhận dạng được thu thập và tham số part thành snippet.

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

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

• Tài nguyên channel chứa hai thuộc tính mới:

  • Thuộc tính status.longUploadsStatus cho biết kênh có đủ điều kiện tải video dài hơn 15 phút lên hay không. Tài sản này chỉ được trả về nếu chủ sở hữu kênh đã uỷ quyền cho yêu cầu API. Các giá trị thuộc tính hợp lệ là:

    • allowed – Kênh có thể tải video dài hơn 15 phút lên.
    • eligible – Kênh đủ điều kiện để tải video dài hơn 15 phút lên nhưng trước hết phải bật tính năng này.
    • disallowed – Kênh không thể hoặc không đủ điều kiện để tải video dài hơn 15 phút lên.

    Xem định nghĩa thuộc tính để biết thêm thông tin về các giá trị này. Trung tâm trợ giúp của YouTube cũng cung cấp thông tin chi tiết hơn về tính năng này.

  • Thuộc tính invideoPromotion.useSmartTiming cho biết liệu chiến dịch quảng bá của kênh có sử dụng "thời gian thông minh" hay không. Tính năng này cố gắng hiển thị quảng cáo tại một điểm trong video khi quảng cáo có nhiều khả năng được nhấp vào hơn và ít có khả năng làm gián đoạn trải nghiệm xem. Tính năng này cũng chọn một quảng cáo duy nhất để hiển thị trên mỗi video.

• Cả định nghĩa về thuộc tính snippet.title và snippet.categoryId của tài nguyên video đều đã được cập nhật để làm rõ cách API xử lý các lệnh gọi đến phương thức videos.update. Nếu gọi phương thức đó để cập nhật phần snippet của tài nguyên video, bạn phải đặt giá trị cho cả hai thuộc tính đó.

  Nếu bạn cố cập nhật phần snippet của tài nguyên video và không đặt giá trị cho cả hai thuộc tính đó, thì API sẽ trả về lỗi invalidRequest. Nội dung mô tả của lỗi đó cũng đã được cập nhật.

• Thuộc tính contentDetails.contentRating.oflcRating của tài nguyên video xác định mức phân loại của video theo Văn phòng Phân loại phim và văn học của New Zealand, hiện hỗ trợ hai mức phân loại mới: oflcRp13 và oflcRp16. Các giá trị này tương ứng với điểm xếp hạng RP13 và RP16.

• Phương thức channelBanners.insert hiện hỗ trợ lỗi sau:

  Loại lỗi	Chi tiết về lỗi	Mô tả
  badRequest	bannerAlbumFull	Album Hình ảnh kênh YouTube của chủ sở hữu kênh có quá nhiều hình ảnh. Chủ sở hữu kênh phải truy cập vào http://photos.google.com, chuyển đến trang album và xoá một số ảnh khỏi album đó.

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

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

• Chi phí hạn mức cho một lệnh gọi đến phương thức search.list đã thay đổi từ 1 đơn vị thành 2 đơn vị ngoài chi phí của các phần tài nguyên được chỉ định.

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

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

• Phương thức subscriptions.insert hiện hỗ trợ lỗi sau:

  Loại lỗi	Chi tiết về lỗi	Mô tả
  badRequest	subscriptionLimitExceeded	Người đăng ký được xác định cùng với yêu cầu đã vượt quá giới hạn tốc độ của gói thuê bao. Bạn có thể thử đăng ký thêm gói thuê bao sau vài giờ nữa.

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

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

• Một hướng dẫn mới có tiêu đề Di chuyển ứng dụng của bạn sang YouTube Data API (v3) sẽ giải thích cách sử dụng YouTube Data API (v3) để thực hiện chức năng có trong YouTube Data API (v2). API cũ chính thức không được dùng nữa kể từ ngày 4 tháng 3 năm 2014. Hướng dẫn này nhằm giúp bạn di chuyển các ứng dụng vẫn sử dụng API v2 sang phiên bản API mới nhất.

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

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

• Phương thức playlists.insert hiện hỗ trợ lỗi sau:

  Loại lỗi	Chi tiết về lỗi	Mô tả
  badRequest	maxPlaylistExceeded	Lỗi này xảy ra nếu không thể tạo danh sách phát vì kênh đã có số lượng danh sách phát tối đa được cho phép.

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

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

• Nội dung mô tả của từng phương thức API đã được cập nhật để bao gồm hạn mức chi phí phải chịu của một lệnh gọi đến phương thức đó. Tương tự, định nghĩa của các tham số part đã được cập nhật để chỉ định chi phí hạn mức của từng phần có thể được truy xuất trong lệnh gọi API. Ví dụ: một lệnh gọi đến phương thức subscriptions.insert có chi phí hạn mức là khoảng 50 đơn vị. Tài nguyên subscription cũng chứa ba phần (snippet, contentDetails và subscriberSnippet) và mỗi phần có chi phí là 2 đơn vị.

  Xin lưu ý rằng hạn mức chi phí có thể thay đổi mà không có cảnh báo.

• Tài nguyên video hiện hỗ trợ 43 hệ thống phân loại nội dung mới, trong đó xác định mức phân loại của video nhận được từ nhiều cơ quan phân loại quốc gia. Hệ thống xếp hạng bao gồm: Argentina, Áo, B

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

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

• Phương thức search.list hiện hỗ trợ các thông số location và locationRadius, cho phép bạn tìm kiếm video được liên kết với một vị trí địa lý. Yêu cầu phải chỉ định giá trị cho cả hai tham số để truy xuất kết quả dựa trên vị trí và API sẽ trả về lỗi nếu yêu cầu chỉ bao gồm một trong hai tham số.

  • Tham số location chỉ định vĩ độ/kinh độ tại trung tâm của khu vực địa lý vòng tròn.

  • Tham số locationRadius chỉ định khoảng cách tối đa mà vị trí liên kết với video có thể tính từ trung tâm của khu vực để video vẫn có thể xuất hiện trong kết quả tìm kiếm.

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

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

• Chúng tôi đã cập nhật thuộc tính invideoPromotion.items[] của tài nguyên channel để lưu ý rằng thông thường, bạn chỉ có thể đặt một mục được quảng bá cho kênh của mình. Nếu bạn cố chèn quá nhiều mục được quảng cáo, API sẽ trả về lỗi tooManyPromotedItems, trong đó có mã trạng thái HTTP 400.

• Tài nguyên channelSection hiện có thể chứa thông tin về một số loại nội dung nổi bật mới. Thuộc tính snippet.type của tài nguyên channelSection hiện hỗ trợ các giá trị sau:

  • postedPlaylists - danh sách phát mà chủ sở hữu kênh đã đăng lên nguồn cấp dữ liệu hoạt động của kênh
  • postedVideos – video mà chủ sở hữu kênh đã đăng lên nguồn cấp dữ liệu hoạt động của kênh
  • subscriptions - các kênh mà chủ sở hữu kênh đã đăng ký

• Thuộc tính contentDetails.contentRating.ifcoRating mới của tài nguyên video xác định mức phân loại của một video nhận được từ Cơ quan phân loại phim Ireland.

• Định nghĩa về thuộc tính position.cornerPosition của tài nguyên watermark đã được cập nhật để lưu ý rằng hình mờ luôn xuất hiện ở góc trên bên phải của trình phát.

• Định nghĩa của tham số q cho phương thức search.list đã được cập nhật để lưu ý rằng cụm từ truy vấn có thể sử dụng toán tử Boolean NOT (-) để loại trừ video được liên kết với một cụm từ tìm kiếm cụ thể. Giá trị này cũng có thể sử dụng toán tử Boolean OR (|) để tìm các video được liên kết với một trong nhiều cụm từ tìm kiếm.

• Định nghĩa của thuộc tính pageInfo.totalResults được trả về trong phản hồi API cho lệnh gọi search.list đã được cập nhật để lưu ý rằng giá trị này chỉ là giá trị gần đúng và có thể không biểu thị cho một giá trị chính xác. Ngoài ra, giá trị tối đa là 1.000.000. Bạn không nên sử dụng giá trị này để tạo các đường liên kết phân trang. Thay vào đó, hãy sử dụng các giá trị thuộc tính nextPageToken và prevPageToken để xác định xem có hiển thị các đường liên kết phân trang hay không.

• Các phương thức watermarks.set và watermarks.unset đã được cập nhật để phản ánh rằng API trả về mã phản hồi HTTP 204 cho các yêu cầu thành công đối với các phương thức đó.

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

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

• Tài nguyên i18nLanguage mới xác định ngôn ngữ ứng dụng mà trang web YouTube hỗ trợ. Ngôn ngữ ứng dụng cũng có thể được gọi là ngôn ngữ giao diện người dùng. Đối với trang web YouTube, ngôn ngữ ứng dụng có thể được chọn tự động dựa trên cài đặt Tài khoản Google, ngôn ngữ trình duyệt hoặc vị trí IP và người dùng cũng có thể chọn ngôn ngữ giao diện người dùng mong muốn theo cách thủ công ở chân trang web YouTube.

  API này hỗ trợ phương thức để liệt kê các ngôn ngữ được hỗ trợ của ứng dụng. Bạn có thể dùng ngôn ngữ được hỗ trợ làm giá trị của tham số hl khi gọi các phương thức API như videoCategories.list và guideCategories.list.

• Tài nguyên i18nRegion mới xác định một khu vực địa lý mà người dùng YouTube có thể chọn làm khu vực xem nội dung ưu tiên. Vùng nội dung cũng có thể được gọi là ngôn ngữ nội dung. Đối với trang web YouTube, khu vực nội dung có thể được chọn tự động dựa trên các suy đoán như miền YouTube hoặc vị trí IP của người dùng và người dùng cũng có thể chọn thủ công khu vực nội dung mong muốn từ chân trang trang web YouTube.

  API này hỗ trợ một phương thức để liệt kê những khu vực nội dung được hỗ trợ. Bạn có thể dùng mã vùng được hỗ trợ làm giá trị của tham số regionCode khi gọi các phương thức API như search.list, videos.list, activities.list và videoCategories.list.

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

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

• Tài nguyên channelSection mới chứa thông tin về một nhóm video mà một kênh đã chọn giới thiệu. Ví dụ: Phần kênh có thể giới thiệu các video tải lên mới nhất, các video tải lên phổ biến nhất của một kênh hoặc các video thuộc một hoặc nhiều danh sách phát.

  API này hỗ trợ các phương thức để liệt kê, chèn, cập nhật hoặc xoá các phần kênh. Bạn có thể truy xuất danh sách các phần kênh cho kênh của người dùng đã xác thực, bằng cách chỉ định một ID kênh cụ thể hoặc bằng cách chỉ định một danh sách ID phần kênh duy nhất.

  Tài liệu về lỗi cũng được cập nhật để mô tả các thông báo lỗi mà API hỗ trợ riêng cho các phương thức mới này.

• Định nghĩa về đối tượng fileDetails của tài nguyên video đã được cập nhật để giải thích rằng đối tượng đó sẽ chỉ được trả về nếu thuộc tính processingDetails.fileDetailsAvailability của video có giá trị available.

  Tương tự, định nghĩa về đối tượng suggestions của tài nguyên video đã được cập nhật để giải thích rằng đối tượng đó sẽ chỉ được trả về nếu thuộc tính processingDetails.tagSuggestionsAvailability của video hoặc thuộc tính processingDetails.editorSuggestionsAvailability của video có giá trị là available.

• Tài liệu về các phương thức videos.insert và videos.update đã được cập nhật để phản ánh rằng bạn có thể đặt thuộc tính status.publishAt khi gọi các phương thức đó.

• Định nghĩa về đối tượng invideoPromotion của tài nguyên channel đã được cập nhật để giải thích rằng chỉ chủ sở hữu kênh mới có thể truy xuất đối tượng.

• Danh sách tham số cho phương thức videos.rate đã được cập nhật để phản ánh rằng phương thức đó không thực sự hỗ trợ tham số onBehalfOfContentOwner. Đây là lỗi tài liệu vì videos.rate yêu cầu đặt tham số này trả về lỗi 500.

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

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

• Thuộc tính status.publishAt mới của tài nguyên video cho phép bạn chỉ định ngày và giờ lên lịch xuất bản một video riêng tư. Bạn chỉ có thể đặt thuộc tính này nếu trạng thái quyền riêng tư của video là private và video chưa từng được xuất bản. Thuộc tính mới này không phải tuân thủ chính sách về việc ngừng sử dụng.

Ngày 13 tháng 3 năm 2014

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

• API hiện hỗ trợ phần contentOwnerDetails cho các tài nguyên channel. Phần mới chứa dữ liệu kênh liên quan đến các đối tác YouTube được liên kết với kênh, bao gồm cả mã nhận dạng của chủ sở hữu nội dung được liên kết với kênh cũng như ngày và giờ liên kết chủ sở hữu nội dung và kênh. Xin lưu ý rằng phần mới này không phải tuân thủ chính sách về việc ngừng sử dụng.

• Tài liệu này hiện liệt kê độ dài ký tự tối đa được hỗ trợ cho các thuộc tính sau:

  Tài nguyên	Thuộc tính	Số ngày tối đa
  channel	invideoPromotion.items[].customMessage	40 ký tự
  video	snippet.title	100 ký tự
  video	snippet.description	5000 byte
  video	snippet.tags	500 ký tự. Xin lưu ý rằng giá trị tài sản là một danh sách và dấu phẩy giữa các mục trong danh sách sẽ được tính vào giới hạn này.

• Thuộc tính brandingSettings.watch.featuredPlaylistId của tài nguyên channel không còn được dùng nữa. API sẽ trả về lỗi nếu bạn cố gắng đặt giá trị cho API đó.

• Các thuộc tính tài nguyên video sau đây đã được thêm vào danh sách giá trị có thể được đặt khi chèn hoặc cập nhật video:

  • recordingDetails.locationDescription
  • recordingDetails.location.latitude
  • recordingDetails.location.longitude
  • recordingDetails.recordingDate

• 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 này hiện hỗ trợ các lỗi sau:

  Loại lỗi	Chi tiết về lỗi	Mô tả
  badRequest (400)	invalidCriteria	Phương thức channels.list trả về lỗi này nếu yêu cầu chỉ định các tham số bộ lọc không thể sử dụng cùng với nhau.
  badRequest (400)	channelTitleUpdateForbidden	Phương thức channels.update sẽ trả về lỗi này nếu bạn cố gắng cập nhật phần brandingSettings của một kênh và thay đổi giá trị của thuộc tính brandingSettings.channel.title. (Lưu ý rằng API sẽ không trả về lỗi nếu bạn bỏ qua thuộc tính này.)
  badRequest (400)	invalidRecentlyUploadedBy	Phương thức channels.update sẽ trả về lỗi này nếu thuộc tính invideoPromotion.items[].id.recentlyUploadedBy chỉ định mã nhận dạng kênh không hợp lệ.
  badRequest (400)	invalidTimingOffset	Phương thức channels.update sẽ trả về lỗi này nếu phần invideoPromotion chỉ định độ lệch thời gian không hợp lệ.
  badRequest (400)	tooManyPromotedItems	Phương thức channels.update sẽ trả về lỗi này nếu phần invideoPromotion chỉ định nhiều hơn số lượng mặt hàng được quảng cáo cho phép.
  forbidden (403)	promotedVideoNotAllowed	Phương thức channels.update trả về lỗi này nếu thuộc tính invideoPromotion.items[].id.videoId chỉ định một mã video không tìm thấy hoặc không thể dùng làm mục được quảng bá.
  forbidden (403)	websiteLinkNotAllowed	Phương thức channels.update sẽ trả về lỗi này nếu thuộc tính invideoPromotion.items[].id.websiteUrl chỉ định một URL không được phép.
  required (400)	requiredTimingType	Phương thức channels.update trả về lỗi này nếu yêu cầu không chỉ định chế độ cài đặt thời gian mặc định cho thời điểm YouTube nên hiển thị một mặt hàng được quảng cáo.
  required (400)	requiredTiming	Phương thức channels.update phải chỉ định một đối tượng invideoPromotion.items[].timing cho từng mục được quảng bá.
  required (400)	requiredWebsiteUrl	Phương thức channels.update phải chỉ định một thuộc tính invideoPromotion.items[].id.websiteUrl cho từng mặt hàng được quảng bá.
  badRequest (400)	invalidPublishAt	Phương thức videos.insert sẽ trả về lỗi này nếu siêu dữ liệu của yêu cầu chỉ định thời điểm xuất bản theo lịch không hợp lệ.

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

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

• YouTube Data API, phiên bản 3 hiện phải tuân thủ Chính sách về việc ngừng cung cấp được mô tả trong Điều khoản dịch vụ API YouTube. Xin lưu ý rằng trang liệt kê những API phải tuân thủ chính sách về việc ngừng sử dụng sẽ loại trừ cụ thể một số chức năng của API phiên bản 3 khỏi việc tuân thủ chính sách này.

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

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

• Tài liệu về phương thức search.list đã được cập nhật để phản ánh chính xác rằng bạn không cần chỉ định giá trị cho đúng một thông số bộ lọc khi gửi yêu cầu tìm kiếm. Thay vào đó, bạn có thể đặt một giá trị cho các tham số bộ lọc bằng 0 hoặc cho một tham số bộ lọc.

• Đã cập nhật định nghĩa cho các tham số của phương thức search.list để lưu ý rằng bạn phải đặt giá trị của tham số type thành video nếu bạn cũng chỉ định giá trị cho bất kỳ tham số nào sau đây:

  • eventType
  • videoCaption
  • videoCategoryId
  • videoDefinition
  • videoDimension
  • videoDuration
  • videoEmbeddable
  • videoLicense
  • videoSyndicated
  • videoType

• Kích thước tối thiểu của ảnh biểu ngữ kênh mà bạn tải lên đã giảm xuống còn 2048px x 1152px. (Trước đây, kích thước tối thiểu là 2120 px x 1192 px.) Ngoài ra, hãy lưu ý rằng tài liệu về tài nguyên channel chỉ định kích thước tối đa của tất cả ảnh biểu ngữ được phân phát từ API. Ví dụ: kích thước tối đa của hình ảnh brandingSettings.image.bannerTvImageUrl cho ứng dụng truyền hình là 2120px x 1192px, nhưng hình ảnh thực tế có thể là 2048px x 1152px. Trung tâm trợ giúp của YouTube cung cấp thêm hướng dẫn về cách tối ưu hoá hình ảnh kênh để hiển thị trên các loại thiết bị khác nhau.

• Một số định nghĩa thuộc tính tài nguyên channel đã được cập nhật để phản ánh những thông tin sau:

  • Giá trị của thuộc tính brandingSettings.channel.description có độ dài tối đa là 1.000 ký tự.
  • Thuộc tính brandingSettings.channel.featuredChannelsTitle có độ dài tối đa là 30 ký tự.
  • Giờ đây, tài sản brandingSettings.channel.featuredChannelsUrls[] có thể liệt kê tối đa 100 kênh.
  • Nếu được đặt, giá trị thuộc tính brandingSettings.channel.unsubscribedTrailer phải chỉ định mã video trên YouTube của video công khai hoặc không công khai thuộc quyền sở hữu của chủ sở hữu kênh.

• Phương thức channels.update hiện hỗ trợ cập nhật cho thuộc tính invideoPromotion.items[].promotedByContentOwner. Thuộc tính đó cho biết liệu tên của chủ sở hữu nội dung có hiển thị khi đăng quảng cáo hay không. Bạn chỉ có thể thiết lập thuộc tính này nếu yêu cầu API đặt giá trị thuộc tính được thực hiện thay mặt cho chủ sở hữu nội dung bằng tham số onBehalfOfContentOwner.

• Phương thức playlistItems.list và playlistItems.insert hiện hỗ trợ tham số onBehalfOfContentOwner. Tham số này hiện đã được hỗ trợ cho một số phương thức khác.

• Tài sản contentDetails.contentRating.acbRating giờ đây có thể chỉ định mức phân loại của Uỷ ban Phân loại Úc (ACB) đối với phim hoặc của Cơ quan Thông tin và Truyền thông Úc (ACMA) đối với chương trình truyền hình dành cho trẻ em.

• Các thuộc tính contentDetails.contentRating.catvRating và contentDetails.contentRating.catvfrRating mới xác định mức phân loại mà một video nhận được theo Hệ thống phân loại chương trình truyền hình của Canada và hệ thống phân loại Régie du cinéma bằng tiếng Pháp được dùng ở Québec.

• Thuộc tính snippet.assignable mới của tài nguyên videoCategory cho biết liệu các video cập nhật hoặc video mới tải lên có thể được liên kết với danh mục video đó hay không.

• Chúng tôi đã thêm mã mẫu cho các phương thức sau:

  • activities.insert (Bắt đầu)
  • channelBanners.insert (Python)
  • channels.update (Python)
  • playlistItems.list (Bắt đầu)
  • search.list (Bắt đầu)
  • thumbnails.set (Java)
  • videos.insert (Bắt đầu)

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

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

• API này bao gồm hai tính năng bổ sung được thiết kế để giúp tìm và giới thiệu nội dung phát sóng trực tiếp:

  Thuộc tính snippet.liveBroadcastContent mới trong kết quả tìm kiếm cho biết liệu một video hoặc tài nguyên kênh có nội dung phát sóng trực tiếp hay không. Các giá trị thuộc tính hợp lệ là upcoming, active và none.

  • Thuộc tính snippet.liveBroadcastContent mới của tài nguyên video cho biết video đó là chương trình phát sóng trực tiếp sắp hay đang hoạt động. Danh sách dưới đây giải thích các giá trị có thể có của thuộc tính:

    • upcoming – Video là một chương trình phát sóng trực tiếp chưa bắt đầu.
    • active – Video là một chương trình phát sóng trực tiếp đang diễn ra.
    • none – Video không phải là chương trình phát sóng trực tiếp sắp hoặc đang hoạt động. Đây sẽ là giá trị thuộc tính cho các chương trình phát sóng đã hoàn tất mà vẫn có thể xem được trên YouTube.

  • Thuộc tính liveStreamingDetails mới của tài nguyên video là một đối tượng chứa siêu dữ liệu về một chương trình phát video trực tiếp. Để truy xuất siêu dữ liệu này, hãy thêm liveStreamingDetails vào danh sách các phần tài nguyên của giá trị tham số part. Siêu dữ liệu bao gồm các thuộc tính mới sau:

    • liveStreamingDetails.actualStartTime – Thời gian chương trình phát sóng thực sự bắt đầu. (Giá trị này sẽ xuất hiện khi trạng thái của thông báo truyền tin là active.)
    • liveStreamingDetails.actualEndTime – Thời gian chương trình phát sóng thực sự kết thúc. (Giá trị này sẽ hiển thị sau khi chương trình phát sóng kết thúc.)
    • liveStreamingDetails.scheduledStartTime – Thời gian phát sóng được lên lịch để bắt đầu.
    • liveStreamingDetails.scheduledEndTime – Thời gian kết thúc chương trình phát sóng. Nếu thuộc tính trống hoặc không có thuộc tính này thì chương trình phát sóng được lên lịch tiếp tục vô thời hạn.
    • liveStreamingDetails.concurrentViewers – Số người xem chương trình phát sóng trực tiếp.

    Để truy xuất siêu dữ liệu này, hãy thêm liveStreamingDetails vào giá trị tham số part khi gọi phương thức videos.list, videos.insert hoặc videos.update.

  Lưu ý rằng hai tính năng khác để xác định nội dung phát sóng trực tiếp đã được phát hành vào ngày 1 tháng 10 năm 2013 – tham số eventType của phương thức search.list và thuộc tính snippet.liveBroadcastContent của kết quả tìm kiếm.

• Phương thức videos.insert hiện đã hỗ trợ tham số notifySubscribers. Tham số này cho biết YouTube có nên gửi thông báo về video mới cho những người dùng đăng ký kênh của video đó hay không. Giá trị mặc định của thông số này là True, cho biết rằng người đăng ký sẽ nhận được thông báo về video mới được tải lên. Tuy nhiên, những chủ sở hữu kênh đang tải nhiều video lên nên ưu tiên đặt giá trị thành False để tránh gửi thông báo về mỗi video mới cho người đăng ký kênh.

• Danh sách các thuộc tính có thể sửa đổi khi gọi phương thức channels.update đã được cập nhật để bao gồm các thuộc tính invideoPromotion.items[].customMessage và invideoPromotion.items[].websiteUrl. Ngoài ra, danh sách này đã được sửa đổi để xác định các thuộc tính brandingSettings có thể sửa đổi. Các thuộc tính brandingSettings này đã có thể sửa đổi được, nên nội dung thay đổi trong tài liệu không phản ánh thay đổi đối với chức năng hiện có của API.

• Phương thức playlists.insert, playlists.update và playlists.delete hiện hỗ trợ tham số onBehalfOfContentOwner. Tham số này hiện đã được hỗ trợ cho một số phương thức khác.

• Phương thức playlists.insert hiện hỗ trợ tham số onBehalfOfContentOwnerChannel. Tham số này đã được hỗ trợ cho một số phương thức khác.

• Thuộc tính contentDetails.contentRating.tvpgRating của tài nguyên video hiện hỗ trợ giá trị pg14, tương ứng với điểm xếp hạng TV-14.

• Định nghĩa của thuộc tính snippet.liveBroadcastContent, là một phần của kết quả tìm kiếm, đã được sửa để phản ánh rằng live là giá trị thuộc tính hợp lệ, nhưng active không phải là giá trị thuộc tính hợp lệ.

• Thuộc tính contentDetails.contentRating.mibacRating của tài nguyên video hiện hỗ trợ thêm hai điểm xếp hạng:

  • mibacVap (VAP) – Trẻ em phải có người lớn đi kèm.
  • mibacVm6 (V.M.6) – Bị giới hạn đối với độ tuổi từ 6 trở lên.
  • mibacVm12 (V.M.12) – Bị giới hạn đối với độ tuổi từ 12 trở lên.

• Thuộc tính invideoPromotion.items[].promotedByContentOwner mới của tài nguyên channel cho biết liệu tên của chủ sở hữu nội dung có xuất hiện khi hiển thị quảng cáo hay không. Trường này chỉ có thể được đặt nếu yêu cầu API đặt giá trị được thực hiện thay mặt cho chủ sở hữu nội dung. Hãy xem tham số onBehalfOfContentOwner để biết thêm thông tin.

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

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

• Đối tượng auditDetails mới của tài nguyên channel chứa dữ liệu kênh mà mạng đa kênh (MCN) sẽ đánh giá trong khi xác định xem nên chấp nhận hay từ chối một kênh cụ thể. Lưu ý rằng mọi yêu cầu API truy xuất phần tài nguyên này đều phải cung cấp mã thông báo uỷ quyền có chứa phạm vi https://www.googleapis.com/auth/youtubepartner-channel-audit. Ngoài ra, chúng tôi phải thu hồi mọi mã thông báo thuộc phạm vi đó khi mạng đa kênh quyết định chấp nhận hay từ chối kênh hoặc trong vòng 2 tuần kể từ ngày phát hành mã thông báo.

• Thuộc tính invideoPromotion.items[].id.type của tài nguyên channel hiện hỗ trợ giá trị recentUpload. Giá trị này cho biết mục được quảng bá là video được tải lên gần đây nhất từ một kênh cụ thể.

  Theo mặc định, kênh đó giống với kênh mà hệ thống đặt dữ liệu quảng cáo trong video. Tuy nhiên, bạn có thể quảng bá video tải lên gần đây nhất từ một kênh khác bằng cách đặt giá trị của thuộc tính invideoPromotion.items[].id.recentlyUploadedBy mới thành mã nhận dạng kênh của kênh đó.

• Tài nguyên channel chứa ba thuộc tính mới là brandingSettings.image.bannerTvLowImageUrl, brandingSettings.image.bannerTvMediumImageUrl, brandingSettings.image.bannerTvHighImageUrl – chỉ định URL cho ảnh biểu ngữ hiển thị trên trang kênh trong các ứng dụng truyền hình.

• Thuộc tính snippet.liveBroadcastContent mới trong kết quả tìm kiếm cho biết liệu một video hoặc tài nguyên kênh có nội dung phát sóng trực tiếp hay không. Các giá trị thuộc tính hợp lệ là upcoming, active và none.

  • Đối với tài nguyên video, giá trị upcoming cho biết rằng video là chương trình phát sóng trực tiếp chưa bắt đầu, trong khi giá trị active cho biết video đó là chương trình phát sóng trực tiếp đang diễn ra.
  • Đối với tài nguyên channel, giá trị upcoming cho biết kênh có chương trình phát sóng đã lên lịch chưa bắt đầu, trong khi giá trị acive cho biết kênh có chương trình phát sóng trực tiếp đang diễn ra.

• Trong tài nguyên watermark, thuộc tính targetChannelId đã thay đổi từ một đối tượng thành một chuỗi. Thay vì chứa tài sản con chỉ định mã nhận dạng kênh YouTube của kênh mà hình mờ liên kết đến, thuộc tính targetChannelId giờ đây chỉ định chính giá trị đó. Do đó, thuộc tính targetChannelId.value của tài nguyên này đã bị xoá.

• Phương thức thumbnails.set hiện hỗ trợ tham số onBehalfOfContentOwner. Tham số này đã được hỗ trợ cho một số phương thức khác.

• Phương thức search.list hiện hỗ trợ tham số eventType. Tham số này giới hạn phạm vi tìm kiếm để chỉ trả về các sự kiện truyền tin đang hoạt động, sắp tới hoặc đã kết thúc.

• Thuộc tính contentDetails.contentRating.mibacRating mới xác định mức phân loại của một video nhận được từ Ministero dei Beni e delle Attivita Culturali e del Turismo (Ý).

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

  Loại lỗi	Chi tiết về lỗi	Mô tả
  badRequest	invalidImage	Phương thức thumbnails.set sẽ trả về lỗi này nếu nội dung hình ảnh đã cung cấp không hợp lệ.
  forbidden	videoRatingDisabled	Phương thức videos.rate trả về lỗi này nếu chủ sở hữu video đang được đánh giá đã tắt mức phân loại cho video đó.

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

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

• Tài nguyên watermark mới xác định một hình ảnh hiển thị trong các lần phát video của một kênh cụ thể. Bạn cũng có thể chỉ định kênh đích mà hình ảnh sẽ liên kết tới, cũng như chi tiết thời gian xác định thời điểm hình mờ xuất hiện trong các lần phát video và khoảng thời gian hình mờ hiển thị.

  Phương thức watermarks.set tải lên và đặt hình mờ của kênh. Phương thức watermarks.unset sẽ xoá hình mờ của một kênh.

  Tài liệu về lỗi mô tả các thông báo lỗi mà API hỗ trợ riêng cho các phương thức watermarks.set và watermarks.unset.

• Thuộc tính statistics.hiddenSubscriberCount mới của tài nguyên channel chứa giá trị boolean cho biết số người đăng ký của kênh có bị ẩn hay không. Do đó, giá trị của thuộc tính sẽ là false nếu số người đăng ký của kênh đó hiển thị công khai.

• Phương thức playlists.list hiện hỗ trợ các tham số onBehalfOfContentOwner và onBehalfOfContentOwnerChannel. Cả hai tham số này đã được hỗ trợ cho một số phương pháp khác.

• Phương thức videos.list hiện đã hỗ trợ tham số regionCode, giúp xác định khu vực nội dung mà biểu đồ sẽ được truy xuất. Bạn chỉ có thể sử dụng tham số này cùng với tham số chart. Giá trị thông số là một mã quốc gia ISO 3166-1 alpha-2.

• error documentation mô tả lỗi yêu cầu phổ biến mới sau đây, có thể xảy ra với nhiều phương thức API:

  Loại lỗi	Chi tiết về lỗi	Mô tả
  forbidden	insufficientPermissions	Các phạm vi liên kết với mã thông báo OAuth 2.0 được cung cấp cho yêu cầu không đủ để truy cập vào dữ liệu được yêu cầu.

Ngày 15 tháng 8 năm 2013

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

• Đối tượng invideoPromotion của tài nguyên channel có các thuộc tính mới và đã cập nhật sau đây:

  • API này hiện hỗ trợ khả năng chỉ định một trang web làm mặt hàng được quảng bá. Để thực hiện việc này, hãy thiết lập giá trị thuộc tính invideoPromotion.items[].id.type thành website và sử dụng thuộc tính invideoPromotion.items[].id.websiteUrl mới để chỉ định URL. Ngoài ra, hãy sử dụng thuộc tính invideoPromotion.items[].customMessage mới để xác định một thông điệp tuỳ chỉnh cần hiển thị cho chương trình khuyến mãi.

    Đường liên kết có thể dẫn đến các trang web được liên kết, trang web của người bán hoặc trang web mạng xã hội. Hãy xem hướng dẫn trong Trung tâm trợ giúp của YouTube dành cho các trang web được liên kết và trang web của người bán để biết thêm thông tin về cách bật đường liên kết cho nội dung của bạn.

    Bằng việc thêm các đường liên kết quảng cáo, bạn đồng ý rằng các đường liên kết đó sẽ không được dùng để chuyển hướng lưu lượng truy cập đến các trang web trái phép và rằng các đường liên kết đó sẽ tuân thủ chính sách của YouTube cho AdWords, chính sách quảng cáo của YouTube, Nguyên tắc cộng đồng của YouTube và Điều khoản dịch vụ của YouTube.

  • Chúng tôi đã sắp xếp lại cấu trúc các thuộc tính liên quan đến chế độ cài đặt thời gian để hiển thị các mặt hàng được quảng bá trong quá trình phát video:

    • Đã di chuyển đối tượng invideoPromotion.timing sang invideoPromotion.items[].timing. Đối tượng này hiện cho phép bạn tuỳ chỉnh dữ liệu về thời gian cho từng mục được quảng cáo trong danh sách invideoPromotion.items[].

    • Đối tượng invideoPromotion.defaultTiming mới chỉ định chế độ cài đặt thời gian mặc định cho chương trình khuyến mãi của bạn. Những chế độ cài đặt này xác định thời điểm một mục được quảng cáo xuất hiện trong thời gian phát một video trên kênh của bạn. Bạn có thể ghi đè thời gian mặc định cho mọi mục được quảng bá cụ thể bằng cách sử dụng đối tượng invideoPromotion.items[].timing.

    • Thuộc tính invideoPromotion.items[].timing.durationMs mới sẽ chỉ định khoảng thời gian (tính bằng mili giây) mà chương trình khuyến mãi sẽ hiển thị. Đối tượng invideoPromotion.defaultTiming cũng chứa trường durationMs chỉ định khoảng thời gian mặc định mà mặt hàng được quảng bá sẽ hiển thị.

  • Cả hai thuộc tính invideoPromotion.items[].type và invideoPromotion.items[].videoId đều đã được chuyển vào đối tượng invideoPromotion.items[].id.

• Phương thức subscriptions.list hiện hỗ trợ các tham số onBehalfOfContentOwner và onBehalfOfContentOwnerChannel. Cả hai tham số này đã được hỗ trợ cho một số phương pháp khác.

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

• Chúng tôi đã thêm mã mẫu cho các phương thức sau:

  • channels.update (Java, Python)
  • playlists.insert (.NET, PHP)
  • subscriptions.insert (PHP, Python)
  • thumbnails.set (PHP, Python)
  • videos.insert (PHP)
  • videos.list (PHP)
  • videos.rate (Python)
  • videos.update (Java, PHP, Python)

  Xin lưu ý rằng ví dụ Python cho phương thức playlistItems.insert cũng đã bị xoá vì chức năng đã thể hiện hiện được phương thức videos.rate xử lý.

• error documentation mô tả lỗi ngữ cảnh yêu cầu mới sau đây, có thể xảy ra với bất kỳ phương thức API nào hỗ trợ tham số yêu cầu mine:

  Loại lỗi	Chi tiết về lỗi	Mô tả
  badRequest	invalidMine	Bạn không được sử dụng tham số mine trong các yêu cầu mà người dùng đã xác thực là đối tác của YouTube. Bạn nên xoá tham số mine, xác thực tư cách người dùng YouTube bằng cách xoá tham số onBehalfOfContentOwner hoặc đóng vai trò là một trong các kênh của đối tác bằng cách cung cấp tham số onBehalfOfContentOwnerChannel nếu phương thức được gọi có thể sử dụng.

Ngày 8 tháng 8 năm 2013

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

• Phần Sử dụng hạn mức trong hướng dẫn Bắt đầu với YouTube Data API đã được cập nhật để phản ánh thay đổi về chi phí hạn mức của một video tải lên từ khoảng 16.000 đơn vị thành khoảng 1600 đơn vị.

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

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

• Trong tài nguyên channelBanner, giá trị của thuộc tính kind đã thay đổi từ youtube#channelBannerInsertResponse thành youtube#channelBannerResource. Tài nguyên này được trả về để phản hồi một yêu cầu channelBanners.insert.

• Thuộc tính brandingSettings.channel.profileColor mới của tài nguyên channel chỉ định một màu nổi bật để bổ sung cho nội dung của kênh. Giá trị thuộc tính là dấu thăng (#) theo sau là chuỗi thập lục phân gồm 6 ký tự, chẳng hạn như #2793e6.

• API này hiện hỗ trợ khả năng chỉ định việc đăng ký là dành cho tất cả hoạt động của kênh hay chỉ dành cho video mới tải lên. Thuộc tính contentDetails.activityType mới của tài nguyên subscription xác định các loại hoạt động mà người đăng ký sẽ được thông báo. Các giá trị thuộc tính hợp lệ là all và uploads.

• Phương thức videos.list hỗ trợ các tham số mới để truy xuất biểu đồ các video phổ biến nhất trên YouTube:

  • Tham số chart xác định biểu đồ mà bạn muốn truy xuất. Hiện tại, giá trị duy nhất được hỗ trợ là mostPopular. Xin lưu ý rằng tham số chart là một tham số bộ lọc. Điều này có nghĩa là bạn không thể dùng tham số này trong cùng một yêu cầu với các tham số bộ lọc khác (id và myRating).
  • Tham số videoCategoryId xác định danh mục video mà biểu đồ sẽ được truy xuất. Bạn chỉ có thể sử dụng tham số này cùng với tham số chart. Theo mặc định, biểu đồ không bị hạn chế đối với một danh mục cụ thể.

• Thuộc tính topicDetails.relevantTopicIds[] mới của tài nguyên video cung cấp một danh sách mã chủ đề Freebase có liên quan đến video hoặc nội dung của video. Chủ đề của các chủ đề này có thể được đề cập trong hoặc xuất hiện trong video.

• Thuộc tính recordingDetails.location.elevation của tài nguyên video đã được đổi tên thành recordingDetails.location.altitude và thuộc tính fileDetails.recordingLocation.location.elevation của tài nguyên này đã được đổi tên thành fileDetails.recordingLocation.location.altitude.

• Đối tượng contentDetails.contentRating của tài nguyên video chỉ định mức phân loại mà một video nhận được theo nhiều hệ thống phân loại, bao gồm cả mức phân loại của MPAA, mức phân loại TVPG, v.v. Đối với mỗi hệ thống phân loại, API hiện đã hỗ trợ giá trị phân loại cho biết rằng video chưa được phân loại. Xin lưu ý rằng đối với mức phân loại của MPAA, Hệ thống thường dùng mức phân loại để xác định những phiên bản chưa cắt của những bộ phim có phiên bản cắt ghép đã nhận được mức phân loại chính thức.

• Thuộc tính contentDetails.contentRating.ytRating mới của tài nguyên video xác định nội dung bị giới hạn độ tuổi. Giá trị thuộc tính sẽ là ytAgeRestricted nếu YouTube xác định video đó chứa nội dung không phù hợp với người dùng dưới 18 tuổi. Nếu cơ sở lưu trú không có mặt hoặc nếu giá trị của cơ sở lưu trú còn trống, thì nội dung đó chưa được xác định là bị giới hạn độ tuổi.

• Tham số mySubscribers của phương thức channels.list không còn được dùng nữa. Sử dụng phương thức subscriptions.list và tham số mySubscribers của phương thức đó để truy xuất danh sách người đăng ký kênh của người dùng đã xác thực.

• Phương thức channelBanners.insert, channels.update, videos.getRating và videos.rate hiện đều hỗ trợ tham số onBehalfOfContentOwner. Tham số đó cho biết người dùng đã xác thực đang hành động thay mặt cho chủ sở hữu nội dung được chỉ định trong giá trị tham số.

• Tài liệu về phương thức channels.update đã được cập nhật để phản ánh việc phương thức đó có thể được dùng để cập nhật đối tượng brandingSettings của tài nguyên channel và các thuộc tính con của nó. Tài liệu này cũng liệt kê danh sách thuộc tính mới cập nhật mà bạn có thể đặt cho đối tượng invideoPromotion của tài nguyên channel.

• error documentation mô tả các lỗi mới sau đây:

  Loại lỗi	Chi tiết về lỗi	Mô tả
  forbidden	accountDelegationForbidden	Lỗi này không chỉ xảy ra với một phương thức API cụ thể. Thông báo này cho biết người dùng đã xác thực không được uỷ quyền hành động thay mặt cho Tài khoản Google được chỉ định.
  forbidden	authenticatedUserAccountClosed	Lỗi này không chỉ xảy ra với một phương thức API cụ thể. Dòng này cho biết tài khoản YouTube của người dùng đã xác thực đã bị đóng. Nếu người dùng đang hành động thay mặt cho một Tài khoản Google khác, thì lỗi này sẽ chỉ ra rằng tài khoản kia đã bị đóng.
  forbidden	authenticatedUserAccountSuspended	Lỗi này không chỉ xảy ra với một phương thức API cụ thể. Dòng này cho biết tài khoản YouTube của người dùng đã xác thực đã bị tạm ngưng. Nếu người dùng đang hành động thay mặt cho một Tài khoản Google khác, thì lỗi này sẽ cho biết rằng tài khoản đó đang bị tạm ngưng.
  forbidden	authenticatedUserNotChannel	Lỗi này không chỉ xảy ra với một phương thức API cụ thể. Dòng này cho biết máy chủ API không thể xác định kênh liên kết với yêu cầu API. Nếu yêu cầu được uỷ quyền và sử dụng tham số onBehalfOfContentOwner, thì bạn cũng nên đặt tham số onBehalfOfContentOwnerChannel.
  forbidden	cmsUserAccountNotFound	Lỗi này không chỉ xảy ra với một phương thức API cụ thể. Người dùng CMS không được phép hành động thay mặt cho chủ sở hữu nội dung đã chỉ định.
  notFound	contentOwnerAccountNotFound	Lỗi này không chỉ xảy ra với một phương thức API cụ thể. Không tìm thấy tài khoản chủ sở hữu nội dung được chỉ định.
  badRequest	invalidPart	Lỗi này không chỉ xảy ra với một phương thức API cụ thể. Tham số part của yêu cầu chỉ định các phần không thể được ghi cùng một lúc.
  badRequest	videoChartNotFound	Phương thức videos.list trả về lỗi này khi yêu cầu chỉ định một biểu đồ video không được hỗ trợ hoặc không hoạt động.
  notFound	videoNotFound	Phương thức videos.update trả về lỗi này để cho biết không tìm thấy video bạn đang cố gắng cập nhật. Kiểm tra giá trị của thuộc tính id trong nội dung yêu cầu để đảm bảo giá trị đó chính xác.

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

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

• Tham số forUsername mới của phương thức channels.list cho phép bạn truy xuất thông tin về một kênh bằng cách chỉ định tên người dùng YouTube của kênh đó.

• Phương thức activities.list hiện hỗ trợ tham số regionCode để hướng dẫn API trả về kết quả có liên quan đến quốc gia đã chỉ định. YouTube sử dụng giá trị này khi hoạt động trước đây của người dùng được cấp phép trên YouTube không cung cấp đủ thông tin để tạo nguồn cấp dữ liệu hoạt động.

• Tài nguyên danh sách phát hiện chứa thuộc tính snippet.tags. Tài sản sẽ chỉ được trả lại cho những người dùng được uỷ quyền đang truy xuất dữ liệu về danh sách phát của riêng họ. Người dùng được uỷ quyền cũng có thể đặt thẻ danh sách phát khi gọi phương thức playlists.insert hoặc playlists.update.

• Tham số onBehalfOfContentOwner (trước đây được hỗ trợ cho phương thức channels.list và search.list) giờ đây cũng được hỗ trợ cho phương thức videos.insert, videos.update và videos.delete. Lưu ý rằng khi tham số này được dùng trong lệnh gọi phương thức videos.insert, yêu cầu cũng phải chỉ định một giá trị cho tham số onBehalfOfContentOwnerChannel mới. Tham số này sẽ xác định kênh mà video sẽ được thêm vào. Kênh phải liên kết với chủ sở hữu nội dung mà tham số onBehalfOfContentOwner chỉ định.

  Thông số này cho biết thông tin ủy quyền của yêu cầu xác định một người dùng YouTube CMS đang hành động thay mặt cho chủ sở hữu nội dung được chỉ định trong giá trị thông số. Tài khoản CMS mà người dùng xác thực phải được liên kết với chủ sở hữu nội dung YouTube được chỉ định.

  Thông số này dành cho các đối tác nội dung sở hữu và quản lý nhiều kênh YouTube. Thông số này cho phép các đối tác đó xác thực một lần và có quyền truy cập vào tất cả dữ liệu video và kênh của họ mà không cần phải cung cấp thông tin xác thực cho từng kênh.

  Riêng đối với bản phát hành này, thông số này hiện cho phép đối tác nội dung chèn, cập nhật hoặc xoá video trong bất kỳ kênh YouTube nào mà đối tác sở hữu.

• error documentation mô tả các lỗi mới sau đây:

  Loại lỗi	Chi tiết về lỗi	Mô tả
  forbidden	insufficientCapabilities	Lỗi này không chỉ xảy ra với một phương thức API cụ thể. Cảnh báo này cho biết người dùng CMS gọi API không có đủ quyền để thực hiện thao tác được yêu cầu. Lỗi này có liên quan đến việc sử dụng tham số onBehalfOfContentOwner được hỗ trợ cho một số phương thức API.
  unauthorized	authorizationRequired	Phương thức activities.list sẽ trả về lỗi này khi yêu cầu sử dụng tham số home nhưng không được uỷ quyền đúng cách.

• Trong tài nguyên channels, thuộc tính invideoPromotion.channelId đã bị xoá vì mã nhận dạng kênh đã được chỉ định bằng thuộc tính id của tài nguyên đó.

• Hướng dẫn mới Làm việc với mã nhận dạng kênh giải thích cách API này sử dụng mã nhận dạng kênh. Hướng dẫn này có thể đặc biệt hữu ích cho nhà phát triển di chuyển từ phiên bản API trước đây và những nhà phát triển có ứng dụng yêu cầu nội dung cho người dùng default hoặc dựa trên khái niệm rằng mỗi kênh YouTube đều có một tên người dùng duy nhất, điều này không còn đúng nữa.

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

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

• Phương thức channelBanners.insert mới cho phép bạn tải một ảnh biểu ngữ lên và sau đó có thể đặt làm ảnh biểu ngữ cho một kênh bằng cách sử dụng thuộc tính brandingSettings.image.bannerExternalUrl mới của tài nguyên channel.

• Tài liệu về phương thức channels.update đã được cập nhật để liệt kê các thuộc tính có thể sửa đổi khi gọi phương thức này.

• Tài liệu về tài nguyên video không còn liệt kê unspecified là một giá trị thuộc tính hợp lệ cho các thuộc tính suggestions.processingErrors[], suggestions.processingHints[], suggestions.processingWarnings[] và suggestions.editorSuggestions[].

• Tham số maxResults của phương thức videos.list hiện có giá trị mặc định là 5.

• error documentation hiện liệt kê các lỗi cho phương thức channelBanners.insert và subscriptions.list. Tệp này cũng liệt kê một số lỗi mới trong phương thức channels.update.

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

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

• Các trang độc lập hiện liệt kê mã mẫu cho Java, .NET, PHP và Ruby.

• Trang liệt kê các mã mẫu Python hiện đã có các ví dụ về cách thêm gói đăng ký, tạo danh sách phát và cập nhật video.

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

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

• YouTube không còn xác định các tính năng và dịch vụ API thử nghiệm. Thay vào đó, chúng tôi hiện cung cấp danh sách các API YouTube tuân thủ chính sách về việc ngừng sử dụng.

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

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

• Tài nguyên kênh hiện hỗ trợ đối tượng inVideoPromotion. Đối tượng này bao gồm thông tin về chiến dịch quảng bá liên kết với kênh. Kênh có thể sử dụng chiến dịch quảng cáo trong video để hiển thị hình thu nhỏ cho một video quảng cáo trong trình phát video trong thời gian phát các video của kênh.

  Bạn có thể truy xuất dữ liệu này bằng cách đưa invideoPromotion vào giá trị tham số part trong yêu cầu channels.list.

• Phương thức channels.update mới có thể dùng để cập nhật dữ liệu chiến dịch quảng bá trong video của kênh. Xin lưu ý rằng phương thức này chỉ hỗ trợ cập nhật cho phần invideoPromotion của tài nguyên channel và chưa hỗ trợ cập nhật cho các phần khác của tài nguyên đó.

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

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

• Tài nguyên kênh hiện hỗ trợ thuộc tính status.isLinked cho biết dữ liệu kênh có nhận dạng người dùng đã được liên kết với tên người dùng YouTube hay tài khoản Google+ hay không. Người dùng có một trong các đường liên kết này đã có danh tính công khai trên YouTube. Đây là điều kiện tiên quyết để thực hiện một số hành động, chẳng hạn như tải video lên.

• Tài nguyên về gói thuê bao hiện hỗ trợ phần subscriberSnippet. Đối tượng đó đóng gói chứa dữ liệu đoạn mã cho kênh của người đăng ký.

• API này hiện hỗ trợ phương thức videos.getRating, giúp truy xuất điểm xếp hạng mà người dùng đã xác thực đưa ra trong một danh sách gồm một hoặc nhiều video.

• Tham số myRating mới của phương thức videos.list cho phép bạn truy xuất danh sách video mà người dùng đã xác thực đã xếp hạng với mức phân loại like hoặc dislike.

  Tham số myRating và tham số id hiện đều được coi là tham số bộ lọc, nghĩa là yêu cầu API phải chỉ định chính xác một trong hai tham số đó. (Trước đây, tham số id là tham số bắt buộc đối với phương thức này.)

  Phương thức này sẽ trả về lỗi forbidden đối với các yêu cầu cố gắng truy xuất thông tin phân loại video nhưng không được cho phép một cách thích hợp.

• Với sự ra mắt của tham số myRating, phương thức videos.list cũng đã được cập nhật để hỗ trợ tính năng phân trang. Tuy nhiên, xin lưu ý rằng tham số phân trang chỉ được hỗ trợ cho các yêu cầu sử dụng tham số myRating. (Thông tin và tham số phân trang không được hỗ trợ cho các yêu cầu sử dụng tham số id.)

  • Tham số maxResults chỉ định số lượng video tối đa mà API có thể trả về trong nhóm kết quả và tham số pageToken xác định một trang cụ thể trong nhóm kết quả mà bạn muốn truy xuất.

  • Tài nguyên youtube#videoListResponse được trả về để phản hồi một yêu cầu videos.list, hiện chứa đối tượng pageInfo. Đối tượng này chứa các thông tin chi tiết như tổng số kết quả và số lượng kết quả có trong nhóm kết quả hiện tại. Tài nguyên youtube#videoListResponse cũng có thể bao gồm các thuộc tính nextPageToken và prevPageToken, mỗi thuộc tính cung cấp một mã thông báo có thể dùng để truy xuất một trang cụ thể trong tập hợp kết quả.

• Phương thức videos.insert hỗ trợ các tham số mới sau đây:

  • autoLevels – Đặt giá trị thông số này thành true để hướng dẫn YouTube tự động cải thiện ánh sáng và màu sắc của video.
  • stabilize – Đặt giá trị tham số này thành true để hướng dẫn YouTube điều chỉnh video bằng cách loại bỏ độ rung do chuyển động của camera.

• Thuộc tính channelTitle đã được thêm vào snippet cho các tài nguyên sau:

  • playlistItem – Thuộc tính chỉ định tên của kênh đã thêm mục trong danh sách phát.
  • playlist – Thuộc tính chỉ định tên của kênh đã tạo danh sách phát.
  • subscription – Thuộc tính chỉ định tên của kênh được đăng ký.

• Chúng tôi đã thêm mã mẫu cho các phương thức sau:

  • activities.insert (Hồng ngọc)
  • playlistItems.list (.NET)
  • search.list (.NET)
  • subscriptions.insert (Java, Ruby)
  • videos.insert (.NET, Ruby)

• Tham số mySubscribers mới của phương thức subscriptions.list cho phép bạn truy xuất danh sách người đăng ký của người dùng hiện đã được xác thực. Bạn chỉ có thể sử dụng tham số này trong yêu cầu được uỷ quyền thích hợp.

  Lưu ý: Chức năng này dùng để thay thế tham số mySubscribers hiện được hỗ trợ cho phương thức channels.list. Tham số đó sẽ không được dùng nữa.

• Trong tài nguyên video, giá trị thuộc tính unspecified không còn là giá trị có thể sử dụng cho bất kỳ thuộc tính nào sau đây:

  • fileDetails.fileType
  • fileDetails.videoStreams[].rotation
  • processingDetails.processingStatus
  • processingDetails.processingFailureReason
  • fileDetails.fileType

• Các yêu cầu API chứa tham số không mong muốn hiện trả về lỗi badRequest và lý do được báo cáo gây ra lỗi này là unexpectedParameter.

• Lỗi mà phương thức playlistItems.insert trả về khi danh sách phát đã chứa số lượng mục được phép tối đa đã được cập nhật. Lỗi này hiện được báo cáo là lỗi forbidden và nguyên nhân gây ra lỗi là playlistContainsMaximumNumberOfVideos.

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

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

• Phương thức videos.rate mới cho phép người dùng đặt mức xếp hạng like hoặc dislike cho một video hoặc xoá thông tin xếp hạng khỏi video.

  Tài liệu về lỗi cũng đã được cập nhật để liệt kê các lỗi mà API có thể trả về để phản hồi lệnh gọi phương thức videos.rate.

• Hình thu nhỏ hiện được xác định trong tài liệu API là một tài nguyên riêng, đồng thời phương thức thumbnails.set mới cho phép bạn tải hình thu nhỏ video tùy chỉnh lên YouTube và đặt hình thu nhỏ đó cho video.

  Tài liệu về lỗi cũng đã được cập nhật để liệt kê các lỗi mà API có thể trả về để phản hồi lệnh gọi phương thức thumbnails.set.

  Lưu ý rằng thay đổi này không thực sự ảnh hưởng đến các tài nguyên hiện có trả về hình thu nhỏ. Hình ảnh thu nhỏ được trả về trong các tài nguyên đó theo cách tương tự như trước đây, mặc dù tài liệu hiện đã liệt kê tên của các kích thước hình thu nhỏ khác nhau mà API có thể trả về.

• Phần brandingSettings mới của tài nguyên channel xác định chế độ cài đặt, văn bản và hình ảnh cho trang kênh và trang xem video của kênh.

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

  • Đối tượng status mới đóng gói thông tin trạng thái về mục trong danh sách phát còn thuộc tính status.privacyStatus xác định trạng thái quyền riêng tư của mục đó trong danh sách phát.

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

  • Thuộc tính status.publicStatsViewable cho biết liệu số liệu thống kê về video mở rộng trên trang xem có xem được công khai hay không. Theo mặc định, những số liệu thống kê đó có thể xem được và các số liệu thống kê như số lượt xem và điểm xếp hạng của video vẫn sẽ hiển thị công khai ngay cả khi giá trị của thuộc tính này được đặt thành false. Bạn có thể đặt giá trị của thuộc tính này khi gọi phương thức videos.insert hoặc videos.update.

  • Đối tượng contentDetails.contentRating bao gồm các mức phân loại mà video nhận được theo nhiều cơ chế phân loại. Danh sách dưới đây xác định các hệ thống phân loại được hỗ trợ và cung cấp đường liên kết đến cơ sở lưu trú liên kết với từng hệ thống phân loại. Các định nghĩa thuộc tính xác định các giá trị xếp hạng được hỗ trợ cho từng hệ thống.

    Quốc gia	Hệ thống phân loại	Thuộc tính
    Hoa Kỳ	Hiệp hội điện ảnh Hoa Kỳ (MPAA)	contentDetails.contentRating.mpaaRating
    Hoa Kỳ	TV Parental Guidelines (một hệ thống phân loại truyền hình)	contentDetails.contentRating.tvpgRating
    Úc	Uỷ ban Phân loại Úc (ACB)	contentDetails.contentRating.acbRating
    Brazil	Hành động chính thức, Classificação, Qualificação e Títulos	contentDetails.contentRating.djctqRating
    Canada	Hệ thống xếp hạng video gia đình của Canada (CHVRS)	contentDetails.contentRating.chvrsRating
    Pháp	Trung tâm quốc gia du cinéma et de l'image animee (Bộ Văn hoá Pháp)	contentDetails.contentRating.fmocRating
    Đức	FreiWillige Selbstkontrolle der Filmwirtschaft (FSK)	contentDetails.contentRating.fskRating
    Vương quốc Anh	Uỷ ban Phân loại Phim của Anh (BBFC)	contentDetails.contentRating.bbfcRating
    Ấn Độ	Hội đồng chứng nhận phim trung ương (CBFC)	contentDetails.contentRating.cbfcRating
    Nhật Bản	映倫管理委員会 (EIRIN)	contentDetails.contentRating.eirinRating
    Hàn Quốc	온정물 vô địch (KMRB)	contentDetails.contentRating.kmrbRating
    Mexico	Tổng cục Phát thanh, Truyền hình và Điện ảnh (RTC)	contentDetails.contentRating.rtcRating
    New Zealand	Văn phòng phân loại phim và văn học	contentDetails.contentRating.oflcRating
    Nga	Cơ quan đăng ký điện ảnh quốc gia của Liên bang Nga	contentDetails.contentRating.russiaRating
    Tây Ban Nha	Instituto de la Cinematografía y de las Artes Nghe nhìn (ICAA)	contentDetails.contentRating.icaaRating

• Tài liệu của phương thức playlistItems.update đã được cập nhật để phản ánh việc thuộc tính snippet.resourceId phải được chỉ định trong tài nguyên được gửi dưới dạng nội dung yêu cầu.

• Phương thức search.list hiện hỗ trợ chức năng sau:

  • Tham số forMine mới giới hạn yêu cầu tìm kiếm để chỉ truy xuất video của người dùng đã xác thực.

  • Tham số order hiện hỗ trợ khả năng sắp xếp kết quả theo thứ tự bảng chữ cái của tiêu đề (order=title) hoặc theo số lượng video theo thứ tự giảm dần (order=videoCount).

  • Tham số safeSearch mới cho biết liệu kết quả tìm kiếm có bao gồm nội dung bị hạn chế hay không.

• Phương thức videos.insert hỗ trợ một số lỗi mới được liệt kê trong bảng dưới đây:

  Loại lỗi	Chi tiết về lỗi	Mô tả
  badRequest	invalidCategoryId	Thuộc tính snippet.categoryId chỉ định một mã danh mục không hợp lệ. Hãy sử dụng phương thức videoCategories.list để truy xuất các danh mục được hỗ trợ.
  badRequest	invalidRecordingDetails	metadata specifies invalid recording details.
  badRequest	invalidVideoGameRating	Siêu dữ liệu yêu cầu chỉ định mức phân loại trò chơi điện tử không hợp lệ.
  badRequest	invalidVideoMetadata	Siêu dữ liệu của yêu cầu không hợp lệ.

• Tham số onBehalfOfContentOwner đã bị xoá khỏi danh sách các tham số được hỗ trợ cho phương thức videos.update và videos.delete.

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

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

• Thuộc tính channelTitle đã được thêm vào snippet cho các tài nguyên sau:

  • activity – Thuộc tính chỉ định tên của kênh chịu trách nhiệm về hoạt động.
  • search – Thuộc tính chỉ định tên của kênh được liên kết với tài nguyên mà kết quả tìm kiếm xác định.
  • video – Thuộc tính chỉ định tên của kênh đã tải video lên.

• Phương thức search.list hỗ trợ các tham số mới sau đây:

  • Tham số channelType cho phép bạn giới hạn hoạt động tìm kiếm các kênh để truy xuất tất cả các kênh hoặc chỉ truy xuất các chương trình.

  • Tham số videoType cho phép bạn hạn chế tìm kiếm video để truy xuất tất cả video hoặc chỉ truy xuất phim hoặc chỉ các tập của chương trình.

• Chúng tôi đã cập nhật định nghĩa cho phần recordingDetails của tài nguyên video để lưu ý rằng đối tượng sẽ chỉ được trả về cho một video nếu bạn đã thiết lập dữ liệu định vị vị trí của video hoặc thời gian quay video.

• Phương thức playlistItems.update hiện trả về một lỗi invalidSnippet. Lỗi này sẽ được trả về nếu yêu cầu API không chỉ định một đoạn mã hợp lệ.

• Một số phương thức API hỗ trợ các tham số mới dành riêng cho đối tác nội dung của YouTube. Đối tác nội dung của YouTube bao gồm các hãng phim và truyền hình, hãng thu âm và những nhà sáng tạo nội dung khác cung cấp nội dung của họ trên YouTube.

  • Tham số onBehalfOfContentOwner cho biết thông tin cấp phép của yêu cầu xác định một người dùng YouTube CMS đang hành động thay mặt cho chủ sở hữu nội dung được chỉ định trong giá trị thông số. Tài khoản CMS mà người dùng xác thực phải được liên kết với chủ sở hữu nội dung YouTube được chỉ định.

    Thông số này dành cho các đối tác nội dung sở hữu và quản lý nhiều kênh YouTube. Thông số này cho phép các đối tác đó xác thực một lần và có quyền truy cập vào tất cả dữ liệu video và kênh của họ mà không cần phải cung cấp thông tin xác thực cho từng kênh.

    Phương thức channels.list, search.list, videos.delete, videos.list và videos.update đều hỗ trợ tham số này.

  • Tham số managedByMe được phương thức channels.list hỗ trợ hướng dẫn API trả về tất cả các kênh thuộc sở hữu của chủ sở hữu nội dung mà tham số onBehalfOfContentOwner chỉ định.

  • Tham số forContentOwner được phương thức search.list hỗ trợ hướng dẫn API giới hạn kết quả tìm kiếm để chỉ bao gồm các tài nguyên thuộc sở hữu của chủ sở hữu nội dung mà tham số onBehalfOfContentOwner chỉ định.

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

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

• API này hỗ trợ một số phần và thuộc tính mới cho các tài nguyên video:

  • Các phần fileDetails, processingDetails và suggestions mới cung cấp thông tin cho chủ sở hữu video về các video mà họ đã tải lên. Dữ liệu này rất hữu ích trong các ứng dụng cho phép tải video lên và bao gồm những nội dung sau:

    • trạng thái và tiến trình xử lý
    • lỗi hoặc các sự cố khác gặp phải trong khi xử lý video
    • tình trạng sẵn có của hình thu nhỏ
    • các đề xuất để cải thiện chất lượng video hoặc siêu dữ liệu
    • thông tin chi tiết về tệp gốc được tải lên YouTube

    Chỉ chủ sở hữu video mới có thể truy xuất tất cả các phần này. Danh sách dưới đây mô tả ngắn gọn các phần mới và tài liệu về tài nguyên video xác định tất cả thuộc tính có trong mỗi phần.

    • Đối tượng fileDetails chứa thông tin về tệp video đã được tải lên YouTube, bao gồm độ phân giải, thời lượng, bộ mã hoá và giải mã âm thanh và video, tốc độ bit của luồng dữ liệu, v.v.

    • Đối tượng processingProgress chứa thông tin về tiến trình xử lý tệp video đã tải lên. Các thuộc tính của đối tượng xác định trạng thái xử lý hiện tại và ước tính thời gian còn lại cho đến khi YouTube xử lý xong video. Phần này cũng cho biết video có được cung cấp các loại dữ liệu hoặc nội dung khác nhau, chẳng hạn như thông tin chi tiết về tệp hoặc hình ảnh thu nhỏ hay không.

      Đối tượng này được thiết kế để thăm dò ý kiến, giúp người tải video lên có thể theo dõi tiến trình xử lý tệp video đã tải lên của YouTube.

    • Đối tượng suggestions chứa các đề xuất giúp xác định các cơ hội cải thiện chất lượng video hoặc siêu dữ liệu của video đã tải lên.

  • Phần contentDetails chứa 4 thuộc tính mới. Bạn có thể truy xuất các thuộc tính này bằng yêu cầu chưa được xác thực.

    • dimension – Cho biết video có ở chế độ 2D hay 3D.
    • definition – Cho biết video có thể phát ở độ phân giải chuẩn hay cao.
    • caption – Cho biết video có phụ đề hay không.
    • licensedContent – Cho biết video có chứa nội dung đã được đối tác nội dung của YouTube xác nhận quyền sở hữu hay không.

  • Phần status chứa hai thuộc tính mới. Chủ sở hữu video có thể đặt giá trị cho cả hai thuộc tính khi chèn hoặc cập nhật video. Bạn cũng có thể truy xuất các thuộc tính này bằng yêu cầu chưa được xác thực.

    • embeddable – Cho biết liệu video có thể nhúng trên trang web khác hay không.
    • license – Chỉ định giấy phép của video. Các giá trị hợp lệ là creativeCommon và youtube.

• Định nghĩa của tham số part đã được cập nhật cho các phương thức videos.list, videos.insert và videos.update để liệt kê các phần mới thêm như mô tả ở trên cũng như phần recordingDetails đã vô tình bị bỏ qua.

• Thuộc tính contentDetails.googlePlusUserId mới của tài nguyên channel chỉ định ID hồ sơ trên Google+ được liên kết với kênh. Giá trị này có thể dùng để tạo liên kết tới hồ sơ trên Google+.

• Giờ đây, mỗi đối tượng hình ảnh thu nhỏ sẽ chỉ định chiều rộng và chiều cao của hình ảnh. Hình thu nhỏ hiện được trả về trong các tài nguyên activity, channel, playlist, playlistItem, search result, subscription và video.

• playlistItems.list hiện hỗ trợ tham số videoId. Bạn có thể dùng tham số này kết hợp với tham số playlistId để chỉ truy xuất mục trong danh sách phát đại diện cho video đã chỉ định.

  API sẽ trả về lỗi notFound nếu không tìm thấy video mà thông số đó xác định trong danh sách phát.

• Tài liệu về lỗi mô tả lỗi forbidden mới, cho biết rằng một yêu cầu không được uỷ quyền đúng cách đối với hành động được yêu cầu.

• Thuộc tính snippet.channelId của tài nguyên channel đã bị xoá. Thuộc tính id của tài nguyên cung cấp cùng một giá trị.

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

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

• Trang error mới liệt kê các lỗi mà API có thể trả về. Trang bao gồm các lỗi chung có thể xảy ra với nhiều phương thức API cũng như lỗi riêng của từng phương pháp.

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

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

• Hiện đã có mã mẫu cho các phương thức và ngôn ngữ được nêu trong danh sách bên dưới:

  • activities.insert – Java
  • playlistItems.insert – Python
  • playlistItems.list – Java, JavaScript, PHP, Python, Ruby
  • playlists.insert – Java, JavaScript, Python
  • search.list – Java, JavaScript, Python, Ruby
  • videos.insert – Java

• Tài nguyên activity hiện có thể báo cáo một hành động channelItem. Hành động này xảy ra khi YouTube thêm một video vào kênh YouTube được tạo tự động. (YouTube xác định theo thuật toán các chủ đề có sự hiện diện đáng kể trên trang web YouTube và tự động tạo kênh cho những chủ đề đó.)

• Các thông số search.list sau đây đã được cập nhật:

  • Tham số q không còn được chỉ định làm bộ lọc, có nghĩa là ....
  • Tham số relatedToVideo đổi tên thành relatedToVideoId.
  • Tham số published đã được thay thế bằng 2 tham số mới là publishedAfter và publishedBefore như được mô tả ở bên dưới.

• Phương thức search.list hỗ trợ các tham số mới sau đây:

  Tên thông số	Giá trị	Mô tả
  channelId	string	Trả về tài nguyên do kênh cụ thể tạo.
  publishedAfter	datetime	Trả về các tài nguyên được tạo sau thời gian chỉ định.
  publishedBefore	datetime	Trả về các tài nguyên được tạo trước thời gian chỉ định.
  regionCode	string	Trả về tài nguyên cho quốc gia được chỉ định.
  videoCategoryId	string	Lọc kết quả tìm kiếm video để chỉ bao gồm các video được liên kết với danh mục video được chỉ định.
  videoEmbeddable	string	Lọc kết quả tìm kiếm video để chỉ bao gồm những video có thể phát trong trình phát được nhúng trên một trang web. Thiết lập giá trị tham số thành true để chỉ truy xuất video có thể nhúng.
  videoSyndicated	string	Lọc kết quả tìm kiếm video để chỉ bao gồm những video có thể phát bên ngoài YouTube.com. Thiết lập giá trị tham số thành true để chỉ truy xuất các video được tổng hợp.

• Một số tài nguyên API hỗ trợ các thuộc tính mới. Bảng dưới đây xác định các tài nguyên và thuộc tính mới của chúng:

  Tài nguyên	Tên tài sản	Giá trị	Mô tả
  activity	contentDetails.playlistItem.playlistItemId	string	ID mục trong danh sách phát mà YouTube gán để xác định duy nhất mục trong danh sách phát.
  activity	contentDetails.channelItem	object	Đối tượng chứa thông tin về tài nguyên đã được thêm vào kênh. Thuộc tính này chỉ xuất hiện nếu snippet.type là channelItem.
  activity	contentDetails.channelItem.resourceId	object	Đối tượng xác định tài nguyên đã được thêm vào kênh. Giống như các thuộc tính resourceId khác, thuộc tính này chứa thuộc tính kind chỉ định loại tài nguyên, chẳng hạn như video hoặc danh sách phát. Tệp này cũng chứa chính xác một trong các thuộc tính videoId, playlistId, v.v. – chỉ định giá trị nhận dạng duy nhất cho tài nguyên đó.
  channel	status	object	Đối tượng này bao gồm thông tin về trạng thái quyền riêng tư của kênh.
  channel	status.privacyStatus	string	Trạng thái quyền riêng tư của kênh đó. Các giá trị hợp lệ là private và public.
  playlist	contentDetails	object	Đối tượng này chứa siêu dữ liệu về nội dung của danh sách phát.
  playlist	contentDetails.itemCount	unsigned integer	Số lượng video trong danh sách phát.
  playlist	player	object	Đối tượng này chứa thông tin mà bạn sẽ sử dụng để phát danh sách phát trong trình phát được nhúng.
  playlist	player.embedHtml	string	Thẻ <iframe> nhúng trình phát video phát danh sách phát.
  video	recordingDetails	object	Đối tượng này bao gồm thông tin xác định hoặc mô tả địa điểm và thời gian quay video.
  video	recordingDetails.location	object	Đối tượng này chứa thông tin định vị vị trí liên kết với video.
  video	recordingDetails.location.latitude	double	Vĩ độ tính bằng độ.
  video	recordingDetails.location.longitude	double	Kinh độ tính bằng độ.
  video	recordingDetails.location.elevation	double	Độ cao so với Trái Đất, tính bằng mét.
  video	recordingDetails.locationDescription	string	Nội dung mô tả bằng văn bản về địa điểm quay video.
  video	recordingDetails.recordingDate	datetime	Ngày và giờ quay video. Giá trị này được chỉ định ở định dạng ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).

• Tài liệu về một số phương thức API hiện xác định các thuộc tính phải được chỉ định trong nội dung yêu cầu hoặc được cập nhật dựa trên các giá trị trong nội dung yêu cầu. Bảng dưới đây liệt kê các phương pháp đó cũng như các thuộc tính bắt buộc hoặc có thể sửa đổi.

  Lưu ý: Tài liệu về các phương pháp khác có thể đã liệt kê các thuộc tính bắt buộc và có thể sửa đổi.

  Phương thức	Thuộc tính
  activities.insert	Thuộc tính bắt buộc: snippet.description Tài sản có thể xác minh: snippet.description contentDetails.bulletin.resourceId
  playlists.update	Thuộc tính bắt buộc: id
  playlistItems.update	Thuộc tính bắt buộc: id
  videos.update	Thuộc tính bắt buộc: id

• API không còn báo cáo lỗi playlistAlreadyExists nếu bạn cố tạo hoặc cập nhật danh sách phát có cùng tiêu đề với danh sách phát đã tồn tại trong cùng một kênh.

• Một số phương thức API hỗ trợ các loại lỗi mới. Bảng dưới đây xác định phương thức và các lỗi mới được hỗ trợ:

  Phương thức	Loại lỗi	Chi tiết về lỗi	Mô tả
  guideCategories.list	notFound	notFound	Không tìm thấy danh mục hướng dẫn được xác định bởi thông số id. Sử dụng phương thức guideCategories.list để truy xuất danh sách các giá trị hợp lệ.
  playlistItems.delete	forbidden	playlistItemsNotAccessible	Yêu cầu không được uỷ quyền thích hợp để xoá mục trong danh sách phát được chỉ định.
  videoCategories.list	notFound	videoCategoryNotFound	Không tìm thấy danh mục video được xác định bởi thông số id. Sử dụng phương thức videoCategories.list để truy xuất danh sách các giá trị hợp lệ.