API Content ID của YouTube - Nhật ký sửa đổi

Lưu ý: YouTube Data API chỉ dành cho các đối tác nội dung của YouTube và không phải nhà phát triển hay người dùng YouTube nào cũng có thể truy cập. Bạn cần có tài khoản Trình quản lý nội dung của YouTube để truy cập. Nếu bạn có tài khoản YouTube Content Manager nhưng không thấy YouTube Data API là một trong các dịch vụ được liệt kê trong bảng điều khiển Google Cloud, hãy liên hệ với người quản lý đối tác hoặc nhóm hỗ trợ đối tác được chỉ định.

Trang này liệt kê các thay đổi và nội dung cập nhật đối với tài liệu về YouTube Content ID API.

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

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

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

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

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

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

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

Tài liệu về YouTube Content ID API đã được cập nhật để làm rõ thứ tự các thao tác khi cập nhật tài sản đã thuộc quyền sở hữu của một chủ sở hữu nội dung khác:

• Nếu một tài sản đã thuộc quyền sở hữu của một chủ sở hữu nội dung khác, bạn phải thêm quyền sở hữu của mình vào tài sản đó bằng cách sử dụng ownership.update hoặc ownership.patch trước khi có thể đặt hoặc cập nhật siêu dữ liệu hoặc chính sách trùng khớp của tài sản đó.
• Nếu bạn cố gắng cập nhật siêu dữ liệu (assets.update hoặc assets.patch) hoặc chính sách trùng khớp (assetMatchPolicy.update hoặc assetMatchPolicy.patch) trước khi xác nhận quyền sở hữu, thì yêu cầu sẽ không thành công và trả về lỗi PERMISSION_DENIED.
• Hướng dẫn Cập nhật nhãn của tài sản đã được cập nhật với hướng dẫn từng bước về cách thêm nhãn vào tài sản thuộc quyền sở hữu của một chủ sở hữu nội dung khác.

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

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

Theo thay đổi này, đến hết ngày 30 tháng 6 năm 2025, Content ID API sẽ được cập nhật theo những cách sau:

• claimSearch.list.sort sẽ được cập nhật thứ tự sắp xếp:
  • DAILY_ENGAGED_VIEWS sẽ được thêm vào số lượt xem hằng ngày dựa trên phương pháp đếm số lượt xem trước đây.
  • LIFETIME_ENGAGED_VIEWS sẽ được thêm vào tổng số lượt xem từ trước đến nay dựa trên phương pháp đếm số lượt xem trước đây.
• assetSearch.list.sort sẽ được cập nhật thứ tự sắp xếp:
  • DAILY_ENGAGED_VIEWS sẽ được thêm vào số lượt xem hằng ngày dựa trên phương pháp đếm số lượt xem trước đây.

Theo thay đổi này, Content ID API sẽ được cập nhật theo những cách sau đây muộn nhất vào ngày 30 tháng 9 năm 2025:

• assetSearch.list.sort thứ tự sắp xếp VIEWS sẽ không được dùng nữa.
• claimSearch.list.sort thứ tự sắp xếp VIEW_COUNT sẽ không được dùng nữa.
• claimSearch.claimSnippet.videoViews sẽ được cập nhật để phản ánh phương pháp tính số lượt xem mới đối với video Shorts.
• claimSearch.claimSnippet.engagedViews sẽ được thêm vào số lượt xem dựa trên phương pháp tính lượt xem trước đây

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

Trường autoGeneratedBreaks[] của tài nguyên videoAdvertisingOption đã được cập nhật vì hiện tại, chúng tôi cho phép cung cấp ad_breaks và autoGeneratedBreaks cùng một lúc. Nếu autoGeneratedBreaks được đặt thành true trên một video có adBreaks được xác định, thì hệ thống của chúng tôi sẽ xác định những vị trí hiển thị quảng cáo ngoài các vị trí quảng cáo mà bạn đặt thủ công. Hãy xem bài viết hỗ trợ để biết thêm thông tin chi tiết.

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

Trường adFormats[] của tài nguyên videoAdvertisingOption đã được cập nhật để third_party là giá trị hợp lệ duy nhất cho trường đó. Chúng tôi không còn hỗ trợ các định dạng quảng cáo sau: instream_trueview, instream_standard, display, preroll, postroll. Hãy xem bài viết hỗ trợ để biết thêm thông tin.

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

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 những thay đổi sau:

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

  • Trường breakPosition[] của tài nguyên videoAdvertisingOption đã được đánh dấu là không dùng nữa và sẽ bị xoá vào năm 2024.
    Các phương thức videoAdvertisingOptions.update và videoAdvertisingOptions.patch đã bỏ qua trường này.
  • Đã xoá trường adBreaks[].slot[] không dùng nữa của tài nguyên videoAdvertisingOption.
  • Đã xoá các trường category và showCustomId không dùng nữa của tài nguyên asset.
  • Trường timeStatusLastModified của tài nguyên claim mới báo cáo thời điểm một yêu cầu xác nhận quyền sở hữu được sửa đổi lần gần đây nhất.
  • Bạn có thể dùng tham số isVideoShortsEligible của phương thức claimSearch.list mới để lọc các video đã được xác nhận quyền sở hữu theo điều kiện sử dụng YouTube Shorts.

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

  • API này hiện hỗ trợ liệt kê các tài nguyên của YouTube Music:
    • Bạn có thể liệt kê các tài nguyên musicRelease bằng phương thức musicReleases.list.
    • Bạn có thể liệt kê các tài nguyên musicTrack bằng phương thức musicTracks.list.
    • Bạn có thể liệt kê các tài nguyên musicChangeRequest bằng phương thức musicChangeRequests.list.

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

Định nghĩa về tham số truy vấn ownershipRestriction của phương thức assetSearch.list đã được cập nhật để làm rõ rằng nếu giá trị của tham số đó là none, thì giá trị tham số metadataSearchFields cũng phải sử dụng ít nhất một bộ lọc mã nhận dạng. Thay đổi này về tài liệu không phản ánh sự thay đổi trong hành vi của API.

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

Tài liệu cho các phương thức asset.get và asset.list đã được cập nhật để làm rõ cách hỗ trợ nhiều giá trị cho:

• fetchMatchPolicy (get, list)
• fetchMetadata (get, list)
• fetchOwnership (get, list)

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

Thông tin về khả năng cấp phép đã được thêm vào asset resource.

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

Tài liệu cho claimSearch.list của phương thức inactiveReasons đã được cập nhật để phản ánh những điểm cải tiến nhằm đảm bảo tính nhất quán với YouTube Studio:

• Trước đây, Studio đã xoá tính năng hỗ trợ cho Audio Swap và Song Erase. Các giá trị API tương ứng, audio_removed và song_erased, đã bị bỏ qua một cách âm thầm và hiện không được ghi lại.
• channel_whitelisted đã được thay thế bằng channel_allowlisted. Giá trị trước đó không còn được ghi lại nhưng vẫn được hỗ trợ.
• Hiện tại, các giá trị closed_disabled_monetization, closed_manually, closed_no_adsense, closed_own_video_match, reference_removed, replaced và video_modified đều được hỗ trợ.

Ngày 14 tháng 6 năm 2022

Tài liệu về tài nguyên assetSearch đã được cập nhật để phản ánh 2 thuộc tính mới: isrcs[] và iswcs[]. Mỗi giá trị thuộc tính isrcs[] và iswcs[] mới đều chứa một mảng các giá trị chuỗi, trong đó mỗi giá trị chỉ định một mã ISRC hoặc ISWC (nếu có) tương ứng với tài sản được xác định bằng kết quả tìm kiếm.

Bạn nên sử dụng các tài sản mới thay vì tài sản isrc và iswc đã có trong tài nguyên assetSearch vì các tài sản mới cung cấp dữ liệu chính xác hơn. Trong khi các thuộc tính mới có thể liệt kê một mảng các giá trị chuỗi, thì mỗi thuộc tính isrc và iswc chỉ xác định một mã ISRC hoặc ISWC được liên kết với kết quả tìm kiếm.

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

Các đường liên kết đến thư viện ứng dụng đã được cập nhật để trỏ đến các thư viện ứng dụng API chuẩn của Google. Đã cập nhật các liên kết được tạo trước cho PHP.

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

Tham số status của phương thức claimSearch.list hiện hỗ trợ nhiều bộ lọc hơn dựa trên thông tin chi tiết về yêu cầu xác nhận quyền sở hữu tiềm ẩn.

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

Tài liệu về Phản hồi của phương thức assetSearch.list đã được cập nhật để phản ánh những điểm cải tiến nhằm đảm bảo tính nhất quán với AIP-158:

• Nội dung mô tả về pageInfo.totalResults nêu rõ rằng giá trị này là giá trị ước tính chứ không phải giá trị thực tế
• Đã xoá các trường pageInfo.resultsPerPage và pageInfo.startIndex

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

Tài liệu về tài nguyên assetLabels.list đã được cập nhật để làm rõ ý nghĩa của các tham số yêu cầu labelPrefix và q, đồng thời ghi lại rằng yêu cầu / phản hồi hỗ trợ phân trang.

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

Tài liệu về tài nguyên claimSearch.list đã được cập nhật để phản ánh đúng 2 trường hợp sử dụng mà phương thức này đề cập đến:

• Tìm kiếm theo mã nhận dạng (tài sản, tệp đối chiếu hoặc video) hoặc chuỗi truy vấn
• Tìm kiếm theo ngày tạo, ngày sửa đổi hoặc trạng thái của thông báo xác nhận quyền sở hữu

Mỗi trường hợp sử dụng hỗ trợ một tập hợp các tham số truy vấn khác nhau. Tài liệu về phương thức claimSearch.list đã được cập nhật để giải thích những thông số được hỗ trợ cho từng trường hợp sử dụng.

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

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

• Giờ đây, phương thức claims.update hỗ trợ khả năng cập nhật trạng thái của một yêu cầu xác nhận quyền sở hữu không hoạt động hoặc tiềm ẩn thành active. Định nghĩa về thuộc tính status của tài nguyên claim cung cấp thêm thông tin chi tiết.
• Tài liệu cho các tài nguyên claim và claimSearch đã được cập nhật để phản ánh việc bổ sung đối tượng studioInfo mới. Đối tượng này chứa các đường liên kết đến những trang liên quan đến thông báo xác nhận quyền sở hữu trong YouTube Studio.
• Danh sách các giá trị được hỗ trợ cho tham số origin của phương thức claimSearch.list đã thay đổi. Tham số này hiện hỗ trợ 4 giá trị bổ sung: batchTool, inProductShorts, melodyMatch và youTubeAdmin. Ngoài ra, các giá trị dropboxUpload và webUpload không còn được hỗ trợ nữa.

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

Tài liệu cho tham số videoId của phương thức claimSearch.list đã được cập nhật để lưu ý rằng giá trị tham số hiện chấp nhận tối đa 10 mã video được phân tách bằng dấu phẩy. API sẽ trả về lỗi badRequest (mã phản hồi HTTP 400) nếu giá trị chứa hơn 10 mã video.

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

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

Tài liệu API đã được cập nhật để xoá các thông tin tham chiếu đến tài nguyên contentOwnerAdvertisingOptions và các phương thức của tài nguyên này. Những phương thức này được sử dụng rất ít và những người dùng API đã sử dụng các phương thức này đã được liên hệ riêng trước khi có thông báo này.

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

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

• Giờ đây, bạn phải đặt thuộc tính metadataMine.artist bất cứ khi nào bạn chèn, cập nhật hoặc vá một tài sản video nhạc hoặc bản ghi âm. Giờ đây, API sẽ trả về lỗi nếu bạn không đặt thuộc tính cho các loại tài nguyên đó. Ngoài ra, xin lưu ý rằng thuộc tính metadataMine.artist chỉ được hỗ trợ cho nghệ sĩ video nhạc và bản ghi âm.

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

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

• Tài nguyên package mới đại diện cho một nhóm tệp được phân phối qua web, SFTP hoặc một cơ chế phân phối khác. API này hỗ trợ 2 phương thức cho tài nguyên này:

  • Phương thức package.insert xác thực và tải lên một gói chỉ chứa siêu dữ liệu, trong đó có đúng một tệp siêu dữ liệu.
  • Phương thức package.get truy xuất thông tin về một gói đã tải lên trước đó.

• Đối với phương thức validator.validate, định nghĩa về thuộc tính uploaderName đã được cập nhật để lưu ý rằng giá trị này không xác định đối tác nội dung tải dữ liệu lên mà là một giá trị như web-google hoặc yt-google xác định tài khoản người tải lên cụ thể mà chủ sở hữu nội dung đang sử dụng.

• Thuộc tính status của tài nguyên reference không còn sử dụng giá trị duplicate_on_hold để cho biết rằng một tài liệu tham khảo trùng lặp với một tài liệu tham khảo khác. Thay vào đó, nếu một giá trị tham chiếu là bản sao, thì giá trị của thuộc tính status hiện được đặt thành inactive và giá trị của thuộc tính statusReason là REASON_DUPLICATE_FOR_OWNERS.

  Tuy nhiên, như trước đây, thuộc tính duplicateLeader của tài nguyên chỉ được điền sẵn nếu tệp đối chiếu là bản sao. Nếu được đặt, thì giá trị của thuộc tính đó sẽ xác định thông tin tham chiếu trùng lặp.

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

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

• Tài nguyên assetShare mới (chỉ liên quan đến tài sản hợp thành) xác định mối quan hệ giữa hai biểu diễn của một tài nguyên tài sản. Những thông tin này phản ánh mô hình dữ liệu xuất bản mới được thiết kế để giúp bạn kiểm soát tốt hơn và nắm bắt thông tin minh bạch về cách các quyền của bạn liên kết với tài sản bản ghi âm.

  Trong mô hình mới, mỗi bản ghi âm đều tương ứng với đúng một tài sản duy nhất, được gọi là chế độ xem bản sáng tác. Siêu dữ liệu của tài sản đó là tập hợp thông tin chính thức mà YouTube hiển thị về quyền đối với bản sáng tác liên quan đến một bản ghi âm cụ thể và có thể tổng hợp thông tin từ nhiều nhà cung cấp dữ liệu.

  Ngoài ra, mỗi chủ sở hữu bản sáng tác đều có tài sản phần sở hữu trong bản sáng tác riêng. Phần sở hữu trong bản sáng tác là thông tin mà một nhà xuất bản cụ thể cung cấp cho một tài sản bản sáng tác. Phần sở hữu trong bản sáng tác có thể liên kết với nhiều bản ghi âm.

  Tài nguyên assetShare xác định mối quan hệ giữa một khung hiển thị thành phần và một thành phần được chia sẻ. Phương thức assetShares.list mới cho phép bạn làm một trong những việc sau:

  • Cung cấp mã nhận dạng của một khung hiển thị thành phần và truy xuất phần thành phần tương ứng thuộc sở hữu của đối tác uỷ quyền yêu cầu, nếu có phần như vậy.
  • Cung cấp mã nhận dạng của một phần sở hữu trong bản sáng tác do đối tác nội dung sở hữu và truy xuất danh sách tất cả các chế độ xem bản sáng tác mà phần sở hữu đó được liên kết.

• Hướng dẫn mới về Quản lý tài sản bản sáng tác giải thích cách các phương thức API khác nhau xử lý yêu cầu, tuỳ thuộc vào việc mã tài sản được gửi đến các phương thức đó xác định chế độ xem bản sáng tác hay phần sở hữu trong bản sáng tác.

• Thuộc tính claimedVideoOptions.autoGeneratedBreaks mới của tài nguyên contentOwnerAdvertisingOptions cho biết liệu YouTube có tự động tạo điểm chèn quảng cáo trong những video đã được xác nhận quyền sở hữu và dài hơn 10 phút hay không. Mặc dù thuộc tính này ảnh hưởng đến tất cả video dài hơn 10 phút của chủ sở hữu nội dung, nhưng nếu một video có nhiều thông báo xác nhận quyền sở hữu, thì đối tác đầu tiên xác nhận quyền sở hữu video đó sẽ đặt hành vi mặc định cho thuộc tính này liên quan đến video đó.

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

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

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

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

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

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

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

  • Phương thức validator.validate mới cho phép bạn xác định xem một tệp siêu dữ liệu có chứa lỗi xác thực khiến YouTube không thể xử lý thành công hay không. Nếu tệp chứa lỗi, thuộc tính errors trong phản hồi của API sẽ chứa danh sách lỗi xác thực, xác định mức độ nghiêm trọng, nguyên nhân và vị trí của từng lỗi.

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

  • Các phương thức assets.patch và assets.update hiện hỗ trợ lỗi sau. Xin lưu ý rằng một phương thức có thể hỗ trợ nhiều lỗi có cùng loại lỗi. Vui lòng tham khảo tài liệu về lỗi cho từng phương thức hoặc trang lỗi để xem danh sách đầy đủ các lỗi có thể xảy ra.

    Lỗi
    invalidValue (400)	parameters.assetId Yêu cầu không thành công vì tài sản đang được cập nhật đã được hợp nhất với một tài sản khác. Gửi lại yêu cầu bằng cách sử dụng mã nhận dạng của tài sản đó (được trả về trong thông báo lỗi) làm giá trị của tham số assetId.

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

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

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

  • Thuộc tính matchInfo.matchSegments[] mới của tài nguyên claim chứa một danh sách, trong đó mỗi mục mô tả một đoạn của video bị xác nhận quyền sở hữu trùng khớp với một phần của video tham chiếu. Một yêu cầu xác nhận quyền sở hữu có thể có nhiều đoạn trùng khớp. Ví dụ: nếu nội dung âm thanh và video của một video được tải lên khớp với nội dung của một video đối chiếu, thì sẽ có 2 đoạn trùng khớp. Một đoạn sẽ mô tả kết quả trùng khớp về âm thanh và đoạn còn lại sẽ mô tả kết quả trùng khớp về video.

    Đối với mỗi đoạn trùng khớp, API sẽ trả về thời lượng và loại (âm thanh hoặc video) của nội dung trùng khớp. API này cũng xác định độ lệch thời gian mà mỗi phân đoạn trùng khớp bắt đầu và kết thúc trong cả video đã được xác nhận quyền sở hữu và video đối chiếu.

  • Giờ đây, bạn có thể cập nhật giá trị thuộc tính claimedVideoOptions.newVideoDefaults[] của tài nguyên contentOwnerAdvertisingOptions khi gọi phương thức contentOwnerAdvertisingOptions.patch hoặc contentOwnerAdvertisingOptions.update.

  • Thuộc tính allowedOptions.autoGeneratedBreaks chỉ có thể đọc của tài nguyên contentOwnerAdvertisingOptions đã không được dùng nữa.

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

  • Phương thức claims.update của API hiện hỗ trợ lỗi sau. Xin lưu ý rằng một phương thức có thể hỗ trợ nhiều lỗi có cùng loại lỗi. Vui lòng tham khảo tài liệu về lỗi cho từng phương thức hoặc trang lỗi để xem danh sách đầy đủ các lỗi có thể xảy ra.

    Lỗi
    badRequest (400)	alreadyClaimed Thông báo xác nhận quyền sở hữu này trùng lặp với một thông báo xác nhận quyền sở hữu khác hiện có và không thể cập nhật.

  • Phương thức assets.list đôi khi hết thời gian chờ và trả về mã phản hồi HTTP 500 (Internal Server Error), đặc biệt là khi yêu cầu truy xuất dữ liệu cho nhiều tài sản và giá trị của tham số fetchMatchPolicy là effective. Nếu yêu cầu assets.list của bạn chỉ định nhiều mã nhận dạng thành phần và trả về lỗi 500, hãy thử gửi lại yêu cầu cho một thành phần hoặc một số lượng thành phần nhỏ hơn.

  • Tài liệu về lỗi references.insert đã được cập nhật để lưu ý rằng nếu yêu cầu tải một tệp đối chiếu bị hỏng lên, thì vấn đề đó sẽ không được xác định cho đến khi chính tệp đối chiếu đó được xử lý. Vì vậy, ngay cả khi yêu cầu references.insert trả về một phản hồi thành công, thì có thể yêu cầu tham chiếu vẫn chưa được xử lý thành công. Sau khi chèn một tham chiếu, bạn nên thăm dò bằng phương thức references.list để xác nhận rằng tham chiếu được kích hoạt như mong đợi.

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

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

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

  • API hiện hỗ trợ quảng cáo trang thông tin sản phẩm. Quảng cáo trang thông tin sản phẩm làm nổi bật những sản phẩm có liên quan đến hoặc xuất hiện trong nội dung của một video. Những quảng cáo này là thẻ được tài trợ hiển thị trong video. Thẻ được thêm vào tự động bởi hệ thống quảng cáo. Người xem sẽ thấy quảng cáo xem trước video cho thẻ trong vài giây và cũng có thể nhấp vào biểu tượng ở góc trên cùng bên phải của video để duyệt qua các thẻ của video.

    Do thay đổi này, giờ đây, bạn có thể thêm product_listing vào giá trị của các thuộc tính sau:

    Phương thức Tài nguyên/API	Thuộc tính
    contentOwnerAdvertisingOptions	allowedOptions.licAdFormats[]
    contentOwnerAdvertisingOptions	allowedOptions.ugcAdFormats[]
    contentOwnerAdvertisingOptions	claimedVideoOptions.newVideoDefaults[]
    videoAdvertisingOptions	adFormats[]
    videoAdvertisingOptions.getEnabledAds	countriesRestriction[].adFormats[]

  • createdBefore và createdAfter mới của phương thức assetSearch.list hướng dẫn API chỉ trả về những thành phần được tạo trước và/hoặc sau một ngày nhất định.

  • Trong phản hồi API cho một yêu cầu assetSearch.list, thuộc tính type hiện hỗ trợ giá trị art_track_video. Trung tâm trợ giúp của YouTube cung cấp thêm thông tin về video nhạc chỉ có ảnh bìa.

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

    Thông số
    referenceId	Tham số bộ lọc này chỉ định mã nhận dạng video tham chiếu trên YouTube của video tham chiếu mà bạn đang truy xuất thông báo xác nhận quyền sở hữu.
    inactiveReasons	Tham số không bắt buộc này cho phép bạn giới hạn phản hồi của API để chỉ bao gồm những thông báo xác nhận quyền sở hữu không còn hiệu lực dựa trên các lý do cụ thể khiến thông báo đó không còn hiệu lực. Định nghĩa tham số liệt kê các loại yêu cầu không hoạt động mà bạn có thể tìm kiếm.
    partnerUploaded	Tham số Boolean không bắt buộc này cho phép bạn chỉ định rằng phản hồi của API chỉ nên bao gồm thông báo xác nhận quyền sở hữu do đối tác tải lên hoặc không do đối tác tải lên.

  • Đối tượng references#origination mới của tài nguyên reference chứa thông tin mô tả nguồn của thông tin tham chiếu.

  • Phương thức references.insert hiện hỗ trợ khả năng tải lên các bản tham chiếu được tạo bằng phần mềm gfp_gen của YouTube. Nếu bạn cung cấp một dấu vân tay được tạo sẵn, hãy đặt giá trị thuộc tính fpDirect thành true trong tài nguyên reference đã tải lên.

    Xin lưu ý rằng với thay đổi này, API sẽ không trả về lỗi nếu bạn cố gắng đặt thuộc tính fpDirect khi tải một tài liệu tham khảo lên.

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

  Tài liệu hiện liệt kê các lỗi do các phương thức của tài nguyên whitelist tr�� về.

  Ngoài ra, bảng sau đây xác định các lỗi mới mà API hỗ trợ và các phương thức có thể trả về từng lỗi. Xin lưu ý rằng một phương thức có thể trả về nhiều lỗi có cùng loại lỗi. Vui lòng tham khảo tài liệu về lỗi cho từng phương thức hoặc trang lỗi để biết thêm thông tin.

  Lỗi
  badRequest (400)	inappropriateCampaignTarget Các phương thức campaigns.insert và campaigns.update sẽ trả về lỗi này nếu một chiến dịch cố gắng làm nổi bật một video có thể không phù hợp với một số người dùng. Để khắc phục lỗi này, vui lòng chọn nội dung khác để làm nổi bật.
  badRequest (400)	canNotCreatePartnerUploadedClaimOnCompositionOrSoundRecordingAssets Phương thức claims.insert sẽ trả về lỗi này nếu bạn cố gắng tạo thông báo xác nhận quyền sở hữu đối với nội dung do đối tác tải lên bằng tài sản bản sáng tác hoặc tài sản Bản ghi âm.
  badRequest (400)	existingSoundRecordingOrMusicVideoClaim Phương thức claims.insert sẽ trả về lỗi này nếu đã có thông báo xác nhận quyền sở hữu đối với bản ghi âm trên video được chỉ định. Bạn không thể thêm yêu cầu xác nhận quyền sở hữu trực tiếp đối với bản sáng tác thông qua API.
  badRequest (400)	asset_id Phương thức references.insert sẽ trả về lỗi này nếu yêu cầu cố gắng tạo một mối tham chiếu thông qua một tệp nhưng yêu cầu đó không chỉ định assetId.
  badRequest (400)	canNotBeActivated Phương thức references.update trả về lỗi này nếu không thể kích hoạt tham chiếu, có thể là do trạng thái của tham chiếu hoặc do các điều kiện về quyền sở hữu.
  badRequest (400)	videoNotClaimed Phương thức videoAdvertisingOptions.get sẽ trả về lỗi này nếu bạn chưa xác nhận quyền sở hữu video mà bạn đang cố gắng truy xuất các lựa chọn quảng cáo, do đó bạn sẽ không thể truy cập vào thông tin được yêu cầu.

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

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

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

• Tài nguyên campaign mới đại diện cho một chiến dịch cụ thể của chủ sở hữu nội dung. Nhờ đó, chủ sở hữu nội dung có thể sử dụng chú thích để quảng bá nội dung trên những video đã được xác nhận quyền sở hữu do người dùng tải lên. Ví dụ: chủ sở hữu nội dung có thể tạo một chiến dịch để thêm đường liên kết đến trang xem phim cho mọi video do người dùng tải lên đã được xác nhận quyền sở hữu có chứa cảnh trong phim đó.

  API này hỗ trợ các phương thức để get, list, insert, update, patch và delete campaign tài nguyên.

• API này hỗ trợ một số lỗi mới cho các phương thức campaigns.get, campaigns.insert, campaigns.update và campaigns.delete mới.

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

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

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

  • Tham số isrcs mới của phương thức assetSearch.list cho phép bạn chỉ định một danh sách gồm tối đa 50 mã ISRC. Phản hồi của API sẽ bao gồm các tài sản được liên kết với những mã ISRC đó.

  • Thuộc tính event[].reason của tài nguyên claimHistory hỗ trợ các giá trị mới sau đây. Mỗi lý do giải thích tại sao một sự kiện cụ thể liên quan đến đơn khiếu nại xảy ra:

    • closed_audio_claim_on_visual_reference
    • closed_partner_exclusion
    • closed_reference_conflict

  • Tham số sort mới của phương thức claimSearch.list chỉ định phương thức sẽ được dùng để sắp xếp các tài nguyên trong phản hồi API. Theo mặc định, các tài nguyên được sắp xếp theo thứ tự thời gian đảo ngược (từ mới nhất đến cũ nhất) dựa trên ngày tạo. Bạn cũng có thể sắp xếp các tài nguyên theo số lượt xem từ cao nhất đến thấp nhất cho nội dung được xác nhận quyền sở hữu.

    Xin lưu ý rằng nếu yêu cầu claimSearch.list cũng đặt giá trị tham số status thành appealed, disputed, pending, potential hoặc routedForReview, thì kết quả sẽ được sắp xếp theo thời gian hết hạn của khoảng thời gian xem xét khiếu nại.

  • Các phương thức ownership.update và ownership.patch hiện liệt kê chính xác tất cả các thuộc tính có thể được cập nhật khi gọi các phương thức này. Thay đổi này là một nội dung điều chỉnh đối với tài liệu API và không xác định thay đổi đối với chức năng API.

  • Các tham số fetchMatchPolicy cho phương thức assets.get và assets.list hiện liệt kê effective là một giá trị được hỗ trợ. Giá trị này hướng dẫn máy chủ API truy xuất chính sách trùng khớp mà YouTube áp dụng cho tài sản.

  • Các tham số id cho các phương thức assets.list, claims.list, contentOwners.list, policies.list, publishers.list và references.list hiện đều lưu ý rằng giá trị tham số của chúng có thể chứa tối đa 50 mã nhận dạng được phân tách bằng dấu phẩy.

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

  Bảng dưới đây xác định các lỗi mới mà API hỗ trợ và các phương thức có thể trả về từng lỗi. Xin lưu ý rằng một phương thức có thể trả về nhiều lỗi có cùng loại lỗi.

  Vui lòng tham khảo tài liệu về lỗi cho từng phương thức hoặc trang lỗi để biết thêm thông tin.

  Loại lỗi	Thông tin chi tiết về lỗi	Mô tả
  badRequest (400)	tooManyIsrcs	Phương thức assetSearch.list sẽ trả về lỗi này nếu tham số isrcs chỉ định hơn 50 mã ISRC.
  badRequest (400)	videoIsPrivate	Phương thức claims.insert sẽ trả về lỗi này nếu bạn cố gắng xác nhận quyền sở hữu một video riêng tư. Bạn chỉ có thể xác nhận quyền sở hữu video nếu video đó ở trạng thái riêng tư public hoặc không công khai unlisted.
  notModified (304)	blockOutsideOwnershipUnchanged	Phương thức claims.update sẽ trả về lỗi này nếu cờ blockOutsideOwnership trên yêu cầu xác nhận quyền sở hữu không được sửa đổi thành công. Có một số lý do có thể khiến lỗi này xảy ra. Một ví dụ thường gặp là do nội dung sửa đổi được chỉ định không ảnh hưởng đến video bị xác nhận quyền sở hữu.

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

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

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

  • Tham số status của phương thức claimSearch.list hiện hỗ trợ giá trị routedForReview. Giá trị này giới hạn kết quả ở những thông báo xác nhận quyền sở hữu cần được xem xét thủ công dựa trên một quy tắc trong chính sách trùng khớp của tài sản.

  • Thuộc tính event[].reason của tài nguyên claimHistory hỗ trợ các giá trị mới sau đây. Mỗi lý do giải thích tại sao một sự kiện cụ thể liên quan đến đơn khiếu nại xảy ra:

    • closed_invalid_reference_segment
    • closed_noadsense
    • suspended_monetization_on_channel
    • video_content_modified

  • Thuộc tính origin.source của tài nguyên claim (xác định nguồn của một tuyên bố) hiện hỗ trợ giá trị melodyMatch. Thông báo xác nhận quyền sở hữu do trùng khớp giai điệu cho biết video đã được xác nhận quyền sở hữu có cùng bản sáng tác nhạc với một tệp tham chiếu.

  • Tài liệu về phương thức references.insert đã được cập nhật để phản ánh chính xác rằng API này sử dụng 2 điểm cuối khác nhau cho phương thức đó. Đây không phải là thay đổi về chức năng API mà chỉ là nội dung điều chỉnh đối với tài liệu hiện có.

    • Nếu yêu cầu là tải một tệp đối chiếu mới lên, thì điểm cuối chính xác là:

      POST https://www.googleapis.com/upload/youtube/partner/v1/references

    • Nếu yêu cầu là tạo tệp đối chiếu bằng cách sử dụng một video đã được xác nhận quyền sở hữu làm nội dung đối chiếu, thì điểm cuối chính xác là:

      POST https://www.googleapis.com/youtube/partner/v1/references

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

  Bảng dưới đây xác định các lỗi mới mà API hỗ trợ và các phương thức có thể trả về từng lỗi. Xin lưu ý rằng một phương thức có thể trả về nhiều lỗi có cùng loại lỗi.

  Vui lòng tham khảo tài liệu về lỗi cho từng phương thức hoặc trang lỗi để biết thêm thông tin.

  Loại lỗi	Thông tin chi tiết về lỗi	Mô tả
  badRequest (400)	invalidLabelName	Các phương thức assets.insert, assets.update và assetLabels.insert sẽ trả về lỗi này nếu tên của nhãn thành phần không hợp lệ. Tên nhãn phải có từ 2 đến 30 ký tự. Tên nhãn không được chứa dấu ngoặc nhọn, dấu phẩy, dấu hai chấm, ký hiệu "&" hoặc dấu gạch đứng (|).
  badRequest (400)	ownerHaveMaximumNumberOfLabels	Các phương thức assets.insert, assets.update và assetLabels.insert sẽ trả về lỗi này nếu chủ sở hữu nội dung đã xác định 2.500 nhãn tài sản riêng biệt (hiện là số lượng tối đa được phép).
  badRequest (400)	tooManyLabelsOnOneAsset	Các phương thức assets.insert và assets.update sẽ trả về lỗi này nếu một tài sản đã được liên kết với 30 nhãn tài sản (số lượng tối đa hiện được cho phép).
  badRequest (400)	channelMonetizationSuspended	Các phương thức claims.insert và claims.update sẽ trả về lỗi này nếu kênh của một video bị tạm ngưng do có đơn kiện của đối tác.
  badRequest (400)	channelNotActive	Phương thức claims.update trả về lỗi này nếu kênh của một video không hoạt động.

• Các phương thức assets.insert và assets.update không còn trả về lỗi badRequest cho một số tài sản nếu tài nguyên trong nội dung yêu cầu không chứa thuộc tính metadataMine.contentType.

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

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

• Thay đổi về mã nhận dạng chủ sở hữu nội dung

  Những thay đổi về mã nhận dạng chủ sở hữu nội dung được thông báo trong nhật ký sửa đổi vào ngày 9 tháng 7 năm 2014 đã có hiệu lực. Do thay đổi này, API hiện trả về một mã nhận dạng duy nhất được tạo để xác định chủ sở hữu nội dung được liên kết với người dùng đã xác thực hoặc một tài nguyên được quản lý thông qua API. Trước đây, API này trả về một tên mà con người có thể đọc được dưới dạng mã nhận dạng, chẳng hạn như "qrs_network".

  Thay đổi này ảnh hưởng đến chức năng API sau đây và có thể ảnh hưởng đến những đối tác đã mã hoá cứng Mã đối tác trong ứng dụng của họ.

  • Giờ đây, API sẽ trả về mã nhận dạng mới dưới dạng giá trị của các thuộc tính tài nguyên trước đây đã trả về Mã đối tác, chẳng hạn như thuộc tính id của tài nguyên contentOwner.
  • Tất cả các phương thức của API đều hỗ trợ tham số onBehalfOfContentOwner. Tham số này xác định chủ sở hữu nội dung mà yêu cầu API được thực hiện thay mặt. Sau khi thay đổi, bạn nên đặt tham số thành mã nhận dạng mới thay vì Mã đối tác. Để tránh làm gián đoạn mã, tham số sẽ chấp nhận một trong hai giá trị trong thời gian chuyển đổi.
  • Sau khi thay đổi, tham số contentOwnerId của phương thức contentOwners.list phải chỉ định mã nhận dạng mới thay vì Mã đối tác.

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

  • Tham số metadataSearchFields mới của phương thức assetSearch.list cho phép bạn chỉ định các trường siêu dữ liệu tài sản mà bạn muốn tìm kiếm cũng như các giá trị mà bạn muốn tìm kiếm trong các trường đó. Giá trị tham số là một danh sách được phân tách bằng dấu phẩy gồm các cặp trường và giá trị; trong một cặp, trường và giá trị được phân tách bằng dấu hai chấm.

  • Đối tượng appliedPolicy mới của tài nguyên claim chỉ định chính sách mà YouTube thực sự áp dụng cho thông báo xác nhận quyền sở hữu. Giá trị của đối tượng là một tài nguyên policy. Tài nguyên đó chứa thông tin về chính sách của những quốc gia nơi chủ sở hữu nội dung đã gửi yêu cầu sở hữu tài sản được xác nhận quyền sở hữu.

    Chính sách được áp dụng có thể khác với chính sách mà chủ sở hữu nội dung đã xác định theo hai cách:

    1. Chính sách này tính đến những chính sách do các chủ sở hữu khác đặt ra khi họ có quyền sở hữu một phần đối với tài sản được xác nhận quyền sở hữu ở một số lãnh thổ giống với chủ sở hữu nội dung đã gửi yêu cầu API.

    2. Chính sách này có tính đến các chính sách quản trị của YouTube áp dụng ở những lãnh thổ nơi chủ sở hữu nội dung sở hữu tài sản đã được xác nhận quyền sở hữu.

  • Thuộc tính uploaderChannelId mới của tài nguyên claimHistory xác định mã nhận dạng kênh của kênh đã tải video đã được xác nhận quyền sở hữu lên.

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

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

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

  • Tài nguyên assetLabel mới xác định một nhãn văn bản có thể được chỉ định cho một tài sản. Nhãn thành phần giúp bạn sắp xếp thành phần vào các danh mục tuỳ chỉnh, nhờ đó bạn sẽ dễ dàng sắp xếp thư viện thành phần của mình. Bạn có thể tìm kiếm nội dung dựa trên nhãn nội dung, cách này cũng có thể đơn giản hóa các trường hợp sử dụng yêu cầu bạn cập nhật nhóm nội dung cụ thể.

    • Phương thức assetLabels.list cho phép bạn truy xuất danh sách nhãn của một chủ sở hữu nội dung.
    • Phương thức assetLabels.insert cho phép bạn tạo một nhãn tài sản mới. Bạn cũng có thể tạo nhãn mới bằng cách gọi phương thức assets.update và cập nhật nhãn cho một tài sản. Máy chủ API sẽ tự động tạo một tài nguyên assetLabel mới cho mọi nhãn chưa xác định trước đó.

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

  • Thuộc tính label[] của tài nguyên asset đã được cập nhật để lưu ý rằng bạn có thể gọi phương thức assets.update để cập nhật nhãn của một tài sản. Tuy nhiên, bạn không thể đặt nhãn cho tài sản khi gọi phương thức assets.insert.

    Hướng dẫn mới về Sử dụng nhãn tài sản giải thích cách tạo và truy xuất nhãn tài sản, cũng như cách cập nhật nhãn của tài sản hoặc tìm kiếm tài sản được liên kết với các nhãn cụ thể.

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

  API này hỗ trợ một số lỗi mới cho các phương thức assetLabels.list và assetLabels.insert mới.

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

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

• Thay đổi về mã nhận dạng chủ sở hữu nội dung

  Trước đây, API này đã sử dụng Mã đối tác mà con người có thể đọc được, chẳng hạn như "qrs_network", để xác định riêng biệt chủ sở hữu nội dung được liên kết với người dùng đã xác thực hoặc một tài nguyên được quản lý thông qua API. Trong quý 3 năm 2014, API sẽ chuyển sang sử dụng một mã nhận dạng duy nhất gồm 22 ký tự để xác định chủ sở hữu nội dung. Thay đổi này ảnh hưởng đến chức năng API sau đây và có thể ảnh hưởng đến những đối tác đã mã hoá cứng Mã đối tác trong ứng dụng của họ.

  • API này sẽ trả về mã nhận dạng gồm 22 ký tự dưới dạng giá trị của các thuộc tính tài nguyên trước đây trả về Mã đối tác, chẳng hạn như thuộc tính id của tài nguyên contentOwner.
  • Tất cả các phương thức của API đều hỗ trợ tham số onBehalfOfContentOwner. Tham số này xác định chủ sở hữu nội dung mà yêu cầu API được thực hiện thay mặt. Sau khi thay đổi, bạn nên đặt tham số thành mã gồm 22 ký tự thay vì Mã đối tác. Để tránh làm gián đoạn mã, tham số sẽ chấp nhận một trong hai giá trị trong thời gian chuyển đổi.
  • Sau khi thay đổi, tham số contentOwnerId của phương thức contentOwners.list phải chỉ định mã nhận dạng gồm 22 ký tự thay vì Mã đối tác.

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

  • Tài nguyên asset hiện hỗ trợ thuộc tính label. Thuộc tính này chỉ định danh sách nhãn tài sản được liên kết với tài sản. Bạn có thể áp dụng nhãn cho nhiều nội dung để nhóm chúng lại. Bạn có thể sử dụng nhãn làm bộ lọc tìm kiếm để cập nhật hàng loạt, tải báo cáo xuống hoặc lọc YouTube Analytics.

  • Phương thức assetSearch.list hiện hỗ trợ các tham số không bắt buộc sau:

    • labels: Chỉ bao gồm những tài sản được liên kết với nhãn đã chỉ định trong kết quả. Theo mặc định, API sẽ trả về những tài sản khớp với tất cả nhãn được chỉ định. Tuy nhiên, bạn có thể dùng tham số includeAnyProvidedLabel để hướng dẫn API trả về những thành phần phù hợp với bất kỳ nhãn nào được chỉ định.
    • includeAnyProvidedLabel: Được dùng kết hợp với tham số labels, tham số này hướng dẫn API trả về những tài sản được liên kết với bất kỳ nhãn nào được chỉ định trong giá trị tham số labels.

  • Tài nguyên claimHistory hiện có các thuộc tính mới sau:

    • Thuộc tính event[].source.userEmail cung cấp địa chỉ email của người dùng đã bắt đầu sự kiện.
    • Thuộc tính event[].typeDetails.disputeNotes chứa ghi chú về việc tranh chấp cho một sự kiện dispute_create.

  • Phương thức claimSearch.list hiện hỗ trợ các tham số không bắt buộc sau:

    • createdAfter: Chỉ bao gồm những yêu cầu bồi thường được tạo sau ngày chỉ định.
    • createdBefore: Chỉ bao gồm những kết quả là các yêu cầu bồi thường được tạo trước ngày đã chỉ định.
    • includeThirdPartyClaims: Được dùng cùng với tham số videoId, tham số này cho biết có nên đưa các thông tin xác nhận của bên thứ ba vào kết quả API hay không.

• Thông tin chi tiết hơn về lỗi

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

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

  Bảng dưới đây xác định các lỗi mới mà API hỗ trợ và các phương thức có thể trả về từng lỗi. Xin lưu ý rằng một phương thức có thể trả về nhiều lỗi có cùng loại lỗi. Ví dụ: lỗi required sẽ được trả về nếu bạn cố gắng chèn một tài nguyên asset bị thiếu một trường siêu dữ liệu bắt buộc. Trên thực tế, có thể có nhiều trường siêu dữ liệu bắt buộc, mỗi trường sẽ trả về một lỗi với thông báo hơi khác.

  Vui lòng tham khảo tài liệu về lỗi cho từng phương thức hoặc trang lỗi để biết thêm thông tin.

  Phương thức	Lỗi
  assetSearch.list	invalidValue – API không hỗ trợ khả năng tìm kiếm thành phần chương trình hoặc mùa. Thay đổi giá trị của tham số type thành một giá trị được hỗ trợ.
  assets.insert	conflict – Đã có quá nhiều tài sản có cùng giá trị nhận dạng (ví dụ: mã tuỳ chỉnh, mã ISRC, v.v.). conflict – Đã có quá nhiều bản sao của tài sản được chỉ định. invalidValue – Người dùng gọi API không có quyền tạo thành phần thuộc loại được chỉ định.
  assets.patch assets.update	badRequest – API không hỗ trợ việc chuyển đổi loại thành phần mà bạn đã thử.
  claimSearch.list	badRequest – Bạn chỉ có thể dùng tham số includeThirdPartyClaims kết hợp với bộ lọc videoId.
  ownership.patch ownership.update	badRequest – Bạn không thể cập nhật quyền sở hữu đối với tài sản về video nhạc chỉ có ảnh bìa.
  references.patch references.update	badRequest – Tệp đối chiếu đang ở trạng thái không hợp lệ đối với thao tác mà bạn đang cố gắng thực hiện.

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

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

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

  • Tài nguyên asset hiện có thể có giá trị type là art_track_video.

  • Tài nguyên claimSearch hiện có các thuộc tính mới sau:

    • Đối tượng origin chứa thông tin mô tả cách tạo ra tuyên bố.
    • Thuộc tính thirdPartyClaim chứa một giá trị Boolean cho biết liệu thông báo xác nhận quyền sở hữu có phải do một chủ sở hữu nội dung khác với chủ sở hữu nội dung liên kết với người dùng thực hiện tìm kiếm đưa ra hay không.

  • Phương thức claimSearch.list hiện hỗ trợ các tham số không bắt buộc sau:

    • contentType: Chỉ trả về kết quả là thông báo xác nhận quyền sở hữu chỉ có âm thanh, chỉ có video hoặc cả âm thanh và video.
    • origin: Chỉ định một hoặc nhiều nguồn gốc của thông báo xác nhận quyền sở hữu, chẳng hạn như descriptiveSearch hoặc videoMatch, mà bạn muốn tìm thông báo xác nhận quyền sở hữu.
    • status: Chỉ hiển thị những kết quả có trạng thái được chỉ định.

  • Thuộc tính status của tài nguyên claim hiện hỗ trợ các giá trị bổ sung sau: appealed, disputed, potential, takedown và unknown.

  • Thuộc tính blockOutsideOwnership mới của tài nguyên claim cho biết liệu video được xác nhận quyền sở hữu có nên bị chặn ở những lãnh thổ nơi video đó không thuộc quyền sở hữu rõ ràng hay không. Theo mặc định, video đã được xác nhận quyền sở hữu vẫn có thể xem được ở những quốc gia mà dữ liệu quyền sở hữu chưa được xác định cho tài sản liên kết với thông báo xác nhận quyền sở hữu.

  • Thuộc tính allowedOptions.autoGeneratedBreaks mới của tài nguyên contentOwnerAdvertisingOption cho biết liệu đối tác có thể chọn hiển thị quảng cáo trong video và quảng cáo trong luồng phát tại những thời điểm quảng cáo được YouTube xác định tự động hay không.

  • Giờ đây, bạn có thể gọi phương thức contentOwners.list bằng mã thông báo uỷ quyền chỉ định phạm vi https://www.googleapis.com/auth/youtubepartner-content-owner-readonly.

  • Thuộc tính timeUpdated mới của tài nguyên policy chỉ định thời điểm chính sách được cập nhật lần gần đây nhất.

  • Phương thức policies.list hiện hỗ trợ một tham số sort không bắt buộc. Bạn có thể dùng tham số này để chỉ định rằng kết quả phải được sắp xếp theo thứ tự tăng dần hoặc giảm dần của thời gian cập nhật gần đây nhất.

  • Thuộc tính expiryTime mới của tài nguyên referenceConflict chỉ định thời gian kết thúc giai đoạn xem xét xung đột tham chiếu, khiến xung đột hết hạn.

  • Thuộc tính autoGeneratedBreaks mới của tài nguyên videoAdvertisingOption cho biết liệu video có nên tự động hiển thị quảng cáo trong luồng phát và quảng cáo chèn giữa tại thời điểm quảng cáo do YouTube xác định hay không.

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

  Bảng dưới đây xác định các lỗi mới mà API hỗ trợ và các phương thức có thể trả về từng lỗi. Xin lưu ý rằng một phương thức có thể trả về nhiều lỗi có cùng loại lỗi. Ví dụ: lỗi required sẽ được trả về nếu bạn cố gắng chèn một tài nguyên asset bị thiếu một trường siêu dữ liệu bắt buộc. Trên thực tế, có thể có nhiều trường siêu dữ liệu bắt buộc, mỗi trường sẽ trả về một lỗi với thông báo hơi khác.

  Vui lòng tham khảo tài liệu về lỗi cho từng phương thức hoặc trang lỗi để biết thêm thông tin.

  Phương thức	Lỗi
  assets.insert assets.update	badRequest – API này không hỗ trợ các thao tác ghi trên tài sản video nhạc chỉ có ảnh bìa.
  claimSearch.list	invalidValue – Tham số pageToken trong yêu cầu chỉ định một mã thông báo trang không hợp lệ.
  claims.insert	badRequest – Yêu cầu xác nhận quyền sở hữu mà bạn đang cố gắng tạo là không hợp lệ vì kênh của video đó không hoạt động. badRequest – Video mà bạn đang cố gắng xác nhận quyền sở hữu được miễn áp dụng chính sách gỡ bỏ. Nếu có thắc mắc, vui lòng liên hệ với copyright@youtube.com badRequest – Chúng tôi không thể xử lý yêu cầu của bạn vì bạn không thể tạo thông báo xác nhận quyền sở hữu của bên thứ ba đối với video được chỉ định. conflict – YouTube không thể tạo đơn kiện theo yêu cầu vì video đã kháng nghị thông báo gỡ bỏ. conflict – YouTube không thể tạo đơn kiện theo yêu cầu vì video có đơn kiện gỡ bỏ đang hoạt động.
  references.insert	badRequest – Video đã được xác nhận quyền sở hữu mà bạn đang cố gắng sử dụng đã bị xoá hoặc bị từ chối, hoặc quá trình xử lý video đó không thành công.

• Lỗi contentOwnerNotProvided và internalError không dành riêng cho một phương thức API cụ thể, sẽ không còn xuất hiện trên mọi trang phương thức nữa. Bạn vẫn có thể tìm thấy nội dung mô tả của các lỗi này trong phần Lỗi chung của tài liệu lỗi của API.

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

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

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

  • Tài nguyên referenceConflict mới xác định xung đột giữa hai tệp đối chiếu và liệt kê những điểm trùng khớp giữa các tệp đó khi xung đột được xác định. Phương thức referenceConflicts.list cho phép bạn truy xuất danh sách các xung đột chưa được giải quyết về tệp đối chiếu liên quan đến chủ sở hữu nội dung được uỷ quyền. Phương thức referenceConflicts.get cho phép bạn truy xuất một xung đột tham chiếu bằng cách chỉ định mã xung đột tham chiếu duy nhất của xung đột đó.

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

  • API này hiện hỗ trợ khả năng truy xuất chính sách trùng khớp có hiệu lực cho một thành phần. Thay đổi này tương tự như những thay đổi được phát hành vào ngày 16 tháng 7 năm 2013, bao gồm cả việc hỗ trợ truy xuất tập hợp siêu dữ liệu và dữ liệu quyền sở hữu chuẩn cho một tài sản.

    Để truy xuất chính sách trùng khớp có hiệu lực cho một tài sản, hãy đặt giá trị tham số fetchMatchPolicy thành effective khi gọi phương thức assets.get hoặc assets.list. Trong phản hồi của API, đối tượng matchPolicyEffective trong mỗi tài nguyên asset được trả về sẽ chứa chính sách trùng khớp có hiệu lực cho tài sản đó.

  • Đối tượng ownershipConflicts mới của tài nguyên asset chứa thông tin về các xung đột quyền sở hữu tài sản. Cấu trúc của đối tượng này tương tự như cấu trúc của tài nguyên ownership, giúp xác định từng loại quyền mà chủ sở hữu tài sản có thể nắm giữ. (Đối với hầu hết các loại tài sản, chủ sở hữu chỉ cần có quyền sở hữu tài sản chung, nhưng đối với tài sản bản sáng tác, chủ sở hữu có thể liệt kê quyền sở hữu của họ đối với quyền biểu diễn, quyền đồng bộ hoá hoặc quyền tái sản xuất âm thanh.)

    Tương tự, đối tượng ownershipConflicts chứa các danh sách riêng biệt xác định xung đột đối với quyền sở hữu chung, quyền biểu diễn, quyền đồng bộ hoá và quyền tái sản xuất âm thanh. Đối với mỗi trường hợp xung đột, dữ liệu sẽ xác định những lãnh thổ xảy ra xung đột, những chủ sở hữu đã cung cấp dữ liệu quyền sở hữu xung đột và tỷ lệ phần trăm tài sản mà mỗi chủ sở hữu xung đột tuyên bố sở hữu.

  • Các phương thức assets.get và assets.get hiện hỗ trợ tham số fetchOwnershipConflicts mới. Tham số này có giá trị boolean cho biết liệu yêu cầu API có nên truy xuất các xung đột về quyền sở hữu đối với tài sản trong phản hồi API hay không. Giá trị mặc định là false, tức là không trả về các trường hợp xung đột quyền sở hữu.

  • Định nghĩa về tham số q của phương thức assetSearch.list đã được cập nhật để xác định các trường siêu dữ liệu mà YouTube tìm kiếm.

  • Tài liệu về nội dung yêu cầu cho phương thức references.insert hiện cho biết rằng bạn phải đặt giá trị của thuộc tính contentType. Thay đổi này cập nhật tài liệu để phản ánh đúng chức năng thực tế của API nhưng không thể hiện sự thay đổi về chức năng của API.

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

  • API hỗ trợ một lỗi forbidden mới (không dành riêng cho một phương thức nhất định) cho biết rằng tài khoản dịch vụ không thể uỷ quyền cho thao tác được yêu cầu.

  • Giờ đây, phương thức assets.insert xác định các lỗi siêu dữ liệu xảy ra trong các thuộc tính trong đối tượng metadataMine thay vì trong đối tượng metadata (đã ngừng hoạt động kể từ khi API cập nhật vào ngày 16 tháng 7 năm 2013).

  • Trang errors (lỗi) đã được cập nhật để đối với mỗi tài nguyên hỗ trợ phương thức update và patch, trang này sẽ chứa một bảng liệt kê các lỗi do hai phương thức đó trả về. Trước đây, trang này liệt kê riêng các lỗi cho từng phương thức, mặc dù các danh sách này luôn giống nhau.

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

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

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

  • Phương thức claimHistory.get mới cho phép bạn xác định và truy xuất thông tin về một đơn khiếu kiện cụ thể. Tài nguyên claimHistory được trả về chứa danh sách các sự kiện liên quan đến đơn kiện, chẳng hạn như đơn kiện được tạo, cập nhật, tranh chấp hoặc đóng.

  • Phương thức claimSearch.list mới cho phép bạn tìm kiếm những thông báo xác nhận quyền sở hữu đáp ứng một số hoặc tất cả các tiêu chí sau:

    • Thông báo xác nhận quyền sở hữu được liên kết với một tài sản cụ thể.
    • Thông báo xác nhận quyền sở hữu được liên kết với một video cụ thể.
    • Các câu lệnh khớp với một chuỗi truy vấn được cung cấp trong yêu cầu.

    Mỗi tài nguyên claimSnippet trong phản hồi API đều chứa thông tin chi tiết về một đơn khiếu kiện, bao gồm cả mã đơn khiếu kiện duy nhất, trạng thái, loại (audio, video hoặc audiovisual), cũng như tài sản và video được liên kết với đơn khiếu kiện đó. Tài nguyên này cũng chỉ định số lượt xem và tiêu đề của video đã được xác nhận quyền sở hữu.

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

  • Giờ đây, tài liệu liệt kê các giá trị được hỗ trợ cho những thuộc tính có một tập hợp các giá trị được liệt kê. Các thuộc tính như vậy bao gồm thuộc tính type của tài nguyên asset và thuộc tính status của tài nguyên claim.

  • Đối với các phương thức assets.get và assets.list, API hiện hỗ trợ các giá trị được phân tách bằng dấu phẩy cho các tham số yêu cầu fetchMetadata và fetchOwnership, cho phép bạn truy xuất nhiều bộ siêu dữ liệu hoặc dữ liệu quyền sở hữu.

    Danh sách dưới đây giải thích các thay đổi tương ứng đối với cấu trúc của tài nguyên asset cũng như tác động của những thay đổi đó đối với các phương thức API get, list, insert, update hoặc patch tài nguyên asset.

    • Đối tượng metadata đã ngừng hoạt động và được thay thế bằng các đối tượng metadataMine và metadataEffective. Các đối tượng mới cho phép tài nguyên asset bao gồm cả bộ siêu dữ liệu do chủ sở hữu nội dung đưa ra khi gửi yêu cầu API cũng như bộ siêu dữ liệu chuẩn mà YouTube xác định là bộ siêu dữ liệu chính xác và đầy đủ nhất cho tài sản.

    • Tương tự, đối tượng ownership đã được thay thế bằng các đối tượng ownershipMine và ownershipEffective.

    • Đối tượng matchPolicy đã được thay thế bằng đối tượng matchPolicyMine. (API hiện không hỗ trợ khả năng truy xuất chính sách trùng khớp có hiệu lực cho một tài sản.)

    Lưu ý: Để đảm bảo khả năng tương thích ngược, nếu bạn chỉ yêu cầu một phiên bản siêu dữ liệu, một bộ dữ liệu quyền sở hữu hoặc một chính sách trùng khớp cho một tài sản, thì phản hồi API sẽ bao gồm cả đối tượng không dùng nữa và đối tượng mới được hỗ trợ. Ví dụ: nếu một yêu cầu đặt tham số fetchMetadata thành mine, thì phản hồi API sẽ chứa một đối tượng metadata và một đối tượng metadataMine, cả hai đối tượng này đều chứa cùng một dữ liệu. (Khả năng đặt fetchMetadata=mine được hỗ trợ trước khi có bản cập nhật tính năng cho phép bạn truy xuất nhiều phiên bản siêu dữ liệu.)
    
    Tuy nhiên, nếu bạn đặt tham số fetchMetadata thành mine,effective, thì phản hồi API sẽ chứa các đối tượng metadataMine và metadataEffective, nhưng sẽ không chứa đối tượng metadata. (Khả năng đặt fetchMetadata=mine,effective không được hỗ trợ trước bản cập nhật tính năng này, nên bạn không cần trả về đối tượng metadata để tương thích ngược.) Nguyên tắc tương tự cũng áp dụng cho các tham số fetchOwnership và fetchMatchPolicy.
    
    Tương tự, để đảm bảo khả năng tương thích ngược, yêu cầu đối với insert, update hoặc patch một tài nguyên asset có thể bao gồm đối tượng metadataMine hoặc đối tượng metadata. Nguyên tắc tương tự cũng áp dụng cho việc thiết lập dữ liệu quyền sở hữu hoặc chính sách trùng khớp của tài nguyên asset.

  • Các tham số assetId, q và videoId của phương thức claims.list không còn được dùng nữa. Để tìm kiếm thông báo xác nhận quyền sở hữu bằng cách sử dụng bất kỳ tiêu chí nào trong số này, hãy sử dụng phương thức claimSearch.list. Phương thức này hỗ trợ tất cả các tham số đó.

  • Trong tài nguyên ownership, các giá trị của thuộc tính general[].ratio, performance[].ratio, synchronization[].ratio và mechanical[].ratio hiện có định dạng nội dung là double thay vì integer.

  • Định nghĩa của thuộc tính rules[].action trong tài nguyên policy hiện liệt kê các giá trị hợp lệ cho thuộc tính đó: block, monetize, takedown và track. Tuy nhiên, xin lưu ý rằng bạn không thể dùng API để áp dụng chính sách gỡ bỏ đối với một đơn khiếu kiện.

  • Thuộc tính claimId mới của tài nguyên reference sẽ xuất hiện nếu tệp đối chiếu được tạo bằng cách liên kết một tài sản với một video trên YouTube hiện có được tải lên một kênh YouTube liên kết với tài khoản CMS của bạn. Trong trường hợp đó, trường này chứa mã nhận dạng của thông báo xác nhận quyền sở hữu thể hiện mối liên kết giữa tài sản và video.

  • Thuộc tính excludedIntervals[] mới của tài nguyên reference chỉ định một danh sách các khoảng thời gian trong tệp đối chiếu mà YouTube sẽ bỏ qua khi cố gắng so khớp tệp đối chiếu. Mỗi khoảng thời gian chỉ định thời gian bắt đầu và thời gian kết thúc được đo bằng giây tính từ đầu video.

  • API không còn yêu cầu bạn đặt thuộc tính status trong tài nguyên reference được gửi trong nội dung của yêu cầu references.update hoặc references.patch.

  • Tài liệu đã được chỉnh sửa để mô tả đúng định dạng phản hồi API cho phương thức videoAdvertisingOptions.getEnabledAds. Phản hồi này là một tài nguyên youtubePartner#videoAdvertisingOptionGetEnabledAds và chứa những thông tin sau:

    • id – Mã nhận dạng mà YouTube dùng để xác định video đã được xác nhận quyền sở hữu liên kết với chế độ cài đặt.

    • adBreaks – Danh sách các đối tượng, trong đó mỗi đối tượng chứa thông tin về một điểm trước, trong hoặc sau khi phát video mà quảng cáo được phép chạy. Mỗi đối tượng cũng có thể chỉ định các thuộc tính khác của điểm chèn quảng cáo, chẳng hạn như các vùng quảng cáo xuất hiện trong điểm chèn và các loại quảng cáo được phép chạy trong mỗi vùng quảng cáo.

    • adsOnEmbeds – Một trường boolean cho biết liệu YouTube có thể hiển thị quảng cáo khi video được phát trong trình phát được nhúng hay không.

    • countriesRestriction – Danh sách các đối tượng, trong đó mỗi đối tượng xác định một danh sách các lãnh thổ và định dạng quảng cáo được dùng trong quá trình phát video ở những lãnh thổ đó.

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

  • Bảng dưới đây xác định các lỗi mới mà API hỗ trợ và các phương thức có thể trả về từng lỗi. Báo cáo này cũng xác định những lỗi đã thay đổi. Xin lưu ý rằng một phương thức có thể trả về nhiều lỗi có cùng loại lỗi. Ví dụ: lỗi required sẽ được trả về nếu bạn cố gắng chèn một tài nguyên asset bị thiếu một trường siêu dữ liệu bắt buộc. Trên thực tế, có thể có nhiều trường siêu dữ liệu bắt buộc, mỗi trường sẽ trả về một lỗi với thông báo hơi khác.

    Vui lòng tham khảo tài liệu về lỗi cho từng phương thức hoặc trang lỗi để biết thêm thông tin.

    Phương thức	Lỗi
    assets.insert assets.update assets.patch	Các lỗi invalidValue và required trước đây được liên kết với các thuộc tính con của đối tượng metadata hiện được liên kết với các thuộc tính con tương tự trong đối tượng metadataMine.
    claimHistory.get	notFound – Không tìm thấy yêu cầu xác nhận quyền sở hữu mà bạn đang cố gắng truy xuất nhật ký. required – Yêu cầu không chỉ định giá trị cho tham số claimId.
    claimSearch.list claims.list	badRequest – Yêu cầu chỉ định tiêu chí không hợp lệ. Bạn có thể chỉ định tối đa một trong các tham số bộ lọc sau: q, assetId, videoId.
    claims.insert	badRequest – Thông báo xác nhận quyền sở hữu mà bạn đang cố gắng tạo là không hợp lệ vì chủ sở hữu nội dung được yêu cầu không phải là chủ sở hữu của tài sản được liên kết với thông báo xác nhận quyền sở hữu đó. badRequest – Chủ sở hữu nội dung mà bạn đang thay mặt không có quyền tạo chính sách với hành động được chỉ định. invalidValue – Chủ sở hữu nội dung mà bạn đang đại diện không có quyền xác nhận quyền sở hữu video do người dùng tải lên thông qua API.
    contentOwners.list	badRequest – Yêu cầu chỉ định tiêu chí không hợp lệ. Bạn phải chỉ định chính xác một trong các tham số bộ lọc sau: fetchMine, id. (Trước đây, lỗi này liệt kê một nhóm tham số bộ lọc khác – has_conflicts_with, restrict_to_user, name_prefix và id.)
    ownership.update ownership.patch	badRequest – Yêu cầu cập nhật dữ liệu quyền sở hữu của một tài sản bản sáng tác phải chỉ định dữ liệu quyền sở hữu thật chi tiết (mechanical, performance, synchronization và/hoặc lyric) thay vì quyền sở hữu general. Chúng tôi mới hỗ trợ loại quyền lyric.
    policies.insert policies.update policies.patch	invalidValue – Yêu cầu chứa một quy tắc chính sách không hợp lệ vì API không hỗ trợ việc tạo hoặc sửa đổi các chính sách chỉ định hành động takedown. Lỗi này (báo cáo lý do là invalidPolicyTakedownAction) sẽ thay thế lỗi invalidPolicyConditionalTakedown đã ngừng hoạt động.
    references.insert	badRequest – Yêu cầu phải gửi một tệp đa phương tiện hoặc chỉ định một giá trị cho tham số yêu cầu claimId. Tuy nhiên, một yêu cầu không thể gửi tệp đa phương tiện và chỉ định một giá trị cho tham số yêu cầu claimId. badRequest – Một tệp đối chiếu cho cùng nội dung đã được tạo từ một đơn kiện khác trên cùng một video trên YouTube. badRequest – API không hỗ trợ khả năng đặt giá trị cho thuộc tính fpDirect khi tạo một giá trị tham chiếu. internalError – Tệp nội dung nghe nhìn đã tải lên bị lỗi. invalidValue – Giá trị của tham số yêu cầu contentType, assetId hoặc claimId không hợp lệ. Lỗi này xác định giá trị không hợp lệ. notFound – Không tìm thấy thành phần hoặc thông báo xác nhận quyền sở hữu mà bạn chỉ định. Vui lòng kiểm tra các giá trị tham số assetId và claimId trong yêu cầu của bạn. required – Yêu cầu phải chỉ định một giá trị cho tham số contentType.
    references.insert references.update references.patch	invalidValue – excludedIntervals được chỉ định cho giá trị tham chiếu không hợp lệ. Xin lưu ý rằng bạn không thể chỉ định khoảng thời gian loại trừ khi huỷ kích hoạt tệp đối chiếu.

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

Bản cập nhật này có các 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 nữa. Thay vào đó, chúng tôi hiện cung cấp danh sách các API của YouTube chịu sự điều chỉnh của chính sách ngừng cung cấp.

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

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

• API này đã được đổi tên thành API Content ID của YouTube.

• Một số thuộc tính đã thay đổi trong tài nguyên assetMatchPolicy:

  • Giá trị thuộc tính kind đã thay đổi từ youtubePartner#policy thành youtubePartner#assetMatchPolicy.
  • Thuộc tính policyId mới chứa một giá trị nhận dạng duy nhất tài nguyên chính sách đã lưu.
  • Giá trị thuộc tính rules[].subaction hiện là một danh sách chuỗi thay vì một chuỗi.
  • Giá trị thuộc tính rules[].conditions.contentMatchType hiện là một danh sách chuỗi thay vì một chuỗi.
  • Các thuộc tính id, name và description đã bị xoá.

• Tài liệu về phương thức assetMatchPolicy.update đã được cập nhật để phản ánh việc bạn có thể đặt giá trị cho thuộc tính policyId hoặc đối tượng rules[] khi gọi phương thức này.

• Tài nguyên claims hiện hỗ trợ một số thuộc tính mới:

  Tên tài sản	Giá trị	Mô tả
  timeCreated	datetime	Ngày và giờ tạo thông báo xác nhận quyền sở hữu.
  matchInfo	object	Đối tượng matchInfo chứa thông tin về nội dung trùng khớp đã tạo ra đơn khiếu kiện. Thông tin này chỉ có trong tài nguyên claim nếu thông báo xác nhận quyền sở hữu được tạo tự động do video tải lên khớp với một tệp đối chiếu hiện có.
  matchInfo.referenceId	string	Mã nhận dạng duy nhất mà YouTube dùng để xác định reference tham chiếu đã tạo ra kết quả trùng khớp.
  matchInfo.longestMatch	object	Đối tượng longestMatch chứa thông tin về phần trùng khớp dài nhất giữa tệp đối chiếu và video tải lên.
  matchInfo.longestMatch.durationSecs	unsigned long	Thời lượng của trận đấu, tính bằng giây.
  matchInfo.longestMatch.userVideoOffset	unsigned long	Độ lệch thời gian khi trận đấu bắt đầu, tính bằng giây kể từ đầu video được tải lên.
  matchInfo.longestMatch.referenceOffset	unsigned long	Độ lệch thời gian khi trận đấu bắt đầu, tính bằng giây kể từ khi bắt đầu đoạn video tham chiếu.
  matchInfo.totalMatch	object	Đối tượng totalMatch chứa thông tin về tổng lượng nội dung trong video tải lên trùng khớp với tệp đối chiếu và tổng lượng nội dung trong tệp đối chiếu trùng khớp với video tải lên. Những giá trị này có thể khác nhau nếu nội dung trùng khớp chạy lặp lại trong video đã tải lên hoặc tệp đối chiếu. Ví dụ: Nếu một video được tải lên có một đoạn trích dài 10 giây trong một tệp đối chiếu, nhưng đoạn trích đó được lặp lại 6 lần, thì tổng thời lượng nội dung trùng khớp trong video được tải lên là 60 giây, nhưng tổng thời lượng nội dung trùng khớp trong tệp đối chiếu chỉ là 10 giây.
  matchInfo.totalMatch.userVideoDurationSecs	unsigned long	Tổng thời lượng (tính bằng giây) của nội dung trong video đã tải lên trùng khớp với tệp đối chiếu.
  matchInfo.totalMatch.referenceDurationSecs	unsigned long	Tổng thời lượng tính bằng giây của nội dung trong tệp đối chiếu trùng khớp với video đã tải lên.
  origin	object	Đối tượng origin chứa thông tin mô tả nguồn của tuyên bố.
  origin.source	string	Nguồn của thông báo xác nhận quyền sở hữu.

• Thuộc tính policy trong tài nguyên claims đã được cập nhật để lưu ý rằng bạn không thể cập nhật giá trị cho yêu cầu bản quyền Hoán đổi âm thanh.

• Thuộc tính timeProvidedMs của tài nguyên metadataHistory đã được đổi tên thành timeProvided.

• Thuộc tính timeProvidedMs của tài nguyên ownershipHistory đã được đổi tên thành timeProvided.

• Định nghĩa về phương thức ownershipHistory.list đã được cập nhật để lưu ý rằng phương thức này chỉ truy xuất dữ liệu quyền sở hữu gần đây nhất cho mỗi chủ sở hữu nội dung. Tuy nhiên, nếu chủ sở hữu nội dung đã gửi dữ liệu quyền sở hữu thông qua nhiều nguồn dữ liệu (API, nguồn cấp dữ liệu nội dung, v.v.), thì danh sách sẽ chứa dữ liệu gần đây nhất cho mỗi chủ sở hữu nội dung và nguồn dữ liệu.

• Một số thuộc tính đã thay đổi trong tài nguyên policy:

  • Thuộc tính rule đã được đổi tên thành rules.
  • Giá trị thuộc tính rules[].subaction hiện là một danh sách chuỗi thay vì một chuỗi.
  • Giá trị thuộc tính rules[].conditions.contentMatchType hiện là một danh sách chuỗi thay vì một chuỗi.

• Tài liệu cho các phương thức policies.insert và policies.update đã được cập nhật để phản ánh việc bạn có thể đặt các giá trị cho đối tượng rules[] khi gọi các phương thức đó.

• Một số phương thức API hỗ trợ các loại lỗi mới. Bảng bên dưới xác định phương thức và xác định ngắn gọn các loại lỗi mới được hỗ trợ. Trong nhiều trường hợp, có thể có nhiều lỗi cho một loại lỗi nhất định. Ví dụ: lỗi required sẽ được trả về nếu bạn cố gắng chèn một tài nguyên asset bị thiếu một trường siêu dữ liệu bắt buộc. Trên thực tế, có thể có nhiều trường siêu dữ liệu bắt buộc, mỗi trường sẽ trả về một lỗi với thông báo hơi khác.

  Vui lòng tham khảo tài liệu về lỗi cho từng phương thức hoặc trang lỗi để biết thêm thông tin.

  Phương thức	Lỗi
  assets.insert	invalidValue – Một trường siêu dữ liệu tài sản chứa giá trị không hợp lệ. required – Thiếu một trường siêu dữ liệu bắt buộc của tài sản.
  assets.update assets.patch	forbidden – Đối tác đang cố gắng hoàn tất việc cập nhật không sở hữu tài sản đang được cập nhật. invalidValue – Một trường siêu dữ liệu tài sản chứa giá trị không hợp lệ. notFound – Thành phần đang được liên kết với một thành phần mùa hoặc thành phần chương trình không tìm thấy. required – Thiếu một trường siêu dữ liệu bắt buộc của tài sản.
  claims.insert	badRequest – Yêu cầu cố gắng xác nhận quyền sở hữu một video, nhưng yêu cầu này không được phép.
  ownership.update ownership.patch	badRequest – Yêu cầu xác định tổng tỷ lệ quyền sở hữu lớn hơn 100% trong một lãnh thổ.
  policies.insert policies.patch policies.update	conflictingPolicyRules – Chính sách có các quy tắc chính sách mâu thuẫn với nhau.

• Trang lỗi mới liệt kê những lỗi mà API có thể trả về. Trang này bao gồm các lỗi chung (có thể xảy ra đối với nhiều phương thức API khác nhau) cũng như các lỗi dành riêng cho phương thức.

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

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

• Phương thức videoAdvertisingOptions.getEnabledAds mới được ghi lại cho phép bạn truy xuất thông tin chi tiết về các loại quảng cáo được phép cho một video do đối tác hoặc người dùng tải lên cụ thể.

• Định nghĩa về tham số ownershipRestriction của phương thức assetSearch.list đã được cập nhật để lưu ý rằng giá trị tham số mặc định là mine, cho biết rằng API chỉ nên truy xuất những tài sản thuộc sở hữu của người dùng hiện tại.

• Tài liệu về phương thức assets.list phản ánh những thay đổi sau:

  • Tham số id hiện là tham số bắt buộc.

  • Tham số fetchMatchPolicy mới được hỗ trợ cho phép bạn cho biết liệu yêu cầu API cũng nên truy xuất chính sách trùng khớp mà bạn đã đặt cho tài sản hay không.

  • Tham số fetchOwnership mới được hỗ trợ cho phép bạn cho biết liệu yêu cầu API cũng nên truy xuất dữ liệu quyền sở hữu cho tài sản hay không.

  • Danh sách thành phần mà API trả về không còn chứa dữ liệu phân trang nữa. Do đó, thuộc tính nextPageToken và đối tượng pageInfo đều đã bị xoá khỏi phản hồi API. Đối tượng pageInfo chứa các thuộc tính totalResults, resultsPerPage và startIndex.

• Tài liệu về tài nguyên claims đã được cập nhật để lưu ý rằng bạn phải chỉ định một chính sách khi tạo một đơn kiện. (YouTube hiện không áp dụng chính sách sử dụng mặc định của bạn nếu một yêu cầu xác nhận quyền sở hữu được chèn không chỉ định chính sách, mặc dù trước đây tài liệu có nêu rằng điều đó đã xảy ra.)

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

• Tham số id mới được hỗ trợ của phương thức policies.list cho phép bạn xác định những chính sách đã lưu mà yêu cầu API sẽ truy xuất. Bạn chỉ có thể truy xuất những chính sách thuộc về chủ sở hữu nội dung hiện đang được xác thực.

• Định nghĩa về tham số releaseClaims cho cả phương thức references.patch và references.update đã được cập nhật để lưu ý rằng tham số này chỉ hoạt động khi trạng thái của yêu cầu đang được cập nhật thành inactive. Trong trường hợp đó, bạn cũng có thể đặt giá trị của tham số releaseClaims thành true để giải phóng tất cả các yêu cầu trùng khớp do tài liệu tham khảo tạo ra.

• Cả hai phương thức references.patch và references.update đều đã được cập nhật để lưu ý rằng bạn phải chỉ định trạng thái của tham chiếu khi thực hiện một trong hai thao tác này.

• 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	Thông tin chi tiết về lỗi	Mô tả
  guideCategories.list	notFound	Unavailable	Không tìm thấy tài sản mà bạn đang cố gắng truy xuất chính sách trùng khớp.
  claims.get	notFound	Unavailable	Không tìm thấy yêu cầu mà bạn đang cố gắng truy xuất.
  ownership.patch	invalidValue	Unavailable	Dữ liệu về quyền sở hữu mà bạn cung cấp có chứa một giá trị không hợp lệ.
  ownership.update	invalidValue	Unavailable	Dữ liệu về quyền sở hữu mà bạn cung cấp có chứa một giá trị không hợp lệ.