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

Lưu ý: API Content ID của YouTube dành cho các đối tác nội dung của YouTube. Không phải nhà phát triển hoặc người dùng YouTube nào cũng có thể sử dụng API này. Nếu bạn không thấy API Content ID của YouTube trong danh sách dịch vụ trên Google API Console, hãy xem Trung tâm trợ giúp của YouTube để tìm hiểu thêm về Chương trình Đối tác YouTube.

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

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 lượt xem video Shorts. Trước đây, đối với video ngắn, lượt xem được tính sau khi người dùng phát một video ngắn trong số lượng giây nhất định. Giờ đây, lượt xem sẽ là số lần video ngắn 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

Kể 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 đây theo thay đổi này:

• 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 tính số lượt xem trước đây.
  • LIFETIME_ENGAGED_VIEWS sẽ được thêm vào số lượt xem trong vòng đời dựa trên phương pháp tính 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 tính số lượt xem trước đây.

Kể từ ngày 30 tháng 9 năm 2025, Content ID API sẽ được cập nhật theo những cách sau đây theo thay đổi này:

• Sắp xếp thứ tự assetSearch.list.sort VIEWS sẽ không được dùng nữa.
• Sắp xếp thứ tự claimSearch.list.sort 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 cho 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 số 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 bạn đặt autoGeneratedBreaks thành true trên một video đã xác định adBreaks, 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.

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 đó. Các định dạng quảng cáo sau đây không còn được hỗ trợ: 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 đối với 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.
    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.
  • Các trường category và showCustomId không còn được dùng nữa của tài nguyên asset đã bị xoá.
  • Trường timeStatusLastModified của tài nguyên claim mới báo cáo thời gian sửa đổi gần nhất của một thông báo xác nhận quyền sở hữu.
  • Bạn có thể dùng tham số isVideoShortsEligible của phương thức claimSearch.list mới để lọc video đã được xác nhận quyền sở hữu theo điều kiện xuất hiện trên YouTube Shorts.

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

  • API hiện hỗ trợ việc liệt kê các tài nguyên 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 của 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 về tài liệu này không phản ánh sự thay đổi về 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êm thông tin về khả năng cấp phép vào asset resource.

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

Tài liệu về inactiveReasons của phương thức claimSearch.list đã được cập nhật để phản ánh các đ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 và hiện không được ghi nhận.
• 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ợ.
• Các giá trị closed_disabled_monetization, closed_manually, closed_no_adsense, closed_own_video_match, reference_removed, replaced và video_modified hiện đượ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 hai thuộc tính mới: isrcs[] và iswcs[]. Mỗi giá trị thuộc tính isrcs[] và iswcs[] mới 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 thích hợp) liên kết đến 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 thuộc tính mới thay vì các thuộc tính isrc và iswc đã có trong tài nguyên assetSearch vì các thuộc tính 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 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 thư viện ứng dụng API của Google chuẩn. 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ề đơn khiếu nại 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 các đ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ả pageInfo.totalResults đề cập rõ ràng 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 nhận 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 hai trường hợp sử dụng mà phương thức này đề cập:

• Tìm kiếm theo mã (tài sản, tài liệu tham khảo 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 tham số truy vấn khác nhau. Tài liệu của phương thức claimSearch.list đã được cập nhật để giải thích những tham 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:

• Phương thức claims.update hiện hỗ trợ khả năng cập nhật trạng thái của một đơn khiếu nại không hoạt động hoặc tiềm năng thành active. Định nghĩa của 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 về tài nguyên claim và claimSearch đã được cập nhật để phản ánh việc thêm đối tượng studioInfo mới. Đối tượng này chứa các đường liên kết đến các trang YouTube Studio liên quan đến thông báo xác nhận quyền sở hữu.
• 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ợ thêm 4 giá trị: 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 về 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 nhiều 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 tệp tham chiếu đến tài nguyên contentOwnerAdvertisingOptions và các phương thức của tài nguyên đó. Các 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 bao gồm các thay đổi sau:

• Giờ đây, bạn phải đặt thuộc tính metadataMine.artist mỗi khi chèn, cập nhật hoặc sửa lỗi một video nhạc hoặc tài sản bản ghi âm. Giờ đây, API sẽ trả về lỗi nếu bạn không đặt thuộc tính này 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 video nhạc và bản ghi âm của nghệ sĩ.

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

Bản cập nhật này bao gồm 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 hỗ trợ hai 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 của 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 đang 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ệp tham chiếu trùng lặp với một tệp tham chiếu khác. Thay vào đó, nếu một tệp tham chiếu là tệp trùng lặp, 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 nếu tệp đối chiếu là trùng lặp. Nếu bạn đặt thuộc tính này, thì giá trị của thuộc tính đó sẽ xác định tệp tham chiếu trùng lặp.

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

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

• Tài nguyên assetShare mới chỉ liên quan đến các thành phần kết hợp, xác định mối quan hệ giữa hai cách trình bày của một tài nguyên thành phầ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 sẽ liên kết với đúng một tài sản duy nhất, được gọi là thành phần hiển thị. Siêu dữ liệu của tài sản đó đại diện cho tập hợp thông tin chuẩn mà YouTube hiển thị về quyền đối với bản sáng tác liên kết với một bản ghi âm cụ thể, đồng thời 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 của 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 đại diện cho thông tin mà một nhà xuất bản cụ thể đã cung cấp cho một thành phần sáng tác. Phần sở hữu trong bản sáng tác có thể được 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 thành phần hiển thị và phần chia sẻ thành phần. 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 thành phần hiển thị và truy xuất phần chia sẻ thành phần tương ứng do đối tác uỷ quyền cho yêu cầu sở hữu, nếu có phần chia sẻ như vậy.
  • Cung cấp mã 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ả thành phần hiển thị trong 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ý thành phần sáng tác giải thích cách các phương thức API khác nhau xử lý các 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 thành phần hiển thị 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 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ẽ thiết lập 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 bao gồm các thay đổi sau:

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

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

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

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

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

  • Phương thức validator.validate mới cho phép bạn xác định xem 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 tệp đó hay không. Nếu tệp chứa lỗi, thuộc tính errors của phản hồi 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.

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

  • 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ì thành phần đang được cập nhật đã được hợp nhất với một thành phần khác. Gửi lại yêu cầu bằng cách sử dụng mã của thành phầ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 bao gồm các thay đổi sau:

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

  • 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 được xác nhận quyền sở hữu khớp với một phần của video đối chiếu. Một thông báo xác nhận quyền sở hữu có thể có nhiều đoạn khớp. Ví dụ: nếu nội dung âm thanh và video của một video tải lên khớp với nội dung của một video đối chiếu, thì sẽ có hai phân đoạn trùng khớp. Một phân đoạn sẽ mô tả nội dung trùng khớp về âm thanh và phân đoạn còn lại sẽ mô tả nội dung trùng khớp về video.

    Đối với mỗi phân đ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òn được dùng nữa.

• 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 đang có hiệu lực nên không thể cập nhật.

  • Phương thức assets.list thỉnh thoảng 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 thành phầ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ã 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 số lượng thành phần ít 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 tham chiếu bị hỏng lên, thì vấn đề đó sẽ không được xác định cho đến khi chính tệp tham chiếu đó được xử lý. Vì vậy, ngay cả khi yêu cầu references.insert trả về phản hồi thành công, tệp tham chiếu có thể không được xử lý thành công. Sau khi chèn tệp tham chiếu, bạn nên thăm dò ý kiến bằng phương thức references.list để xác nhận rằng tệp tham chiếu đó được kích hoạt như dự kiến.

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

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

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

  • API hiện hỗ trợ quảng cáo danh sách 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 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ể đưa product_listing vào các 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 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ã tham chiếu trên YouTube của tệp đối chiếu mà bạn đang truy xuất thông báo xác nhận quyền sở hữu.
    inactiveReasons	Thông số không bắt buộc này cho phép bạn hạn chế phản hồi API chỉ bao gồm các thông báo xác nhận quyền sở hữu không hoạt động dựa trên lý do cụ thể khiến các thông báo xác nhận quyền sở hữu đó không hoạt động. Phần định nghĩa thông số liệt kê các loại thông báo xác nhận quyền sở hữu không hoạt động mà bạn có thể tìm kiếm.
    partnerUploaded	Thông 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ỉ được 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 phải 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 tệp tham chiếu.

  • Phương thức references.insert hiện hỗ trợ tính năng tải các tệp tham chiếu được tạo bằng phần mềm gfp_gen của YouTube lên. Nếu bạn cung cấp 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 còn trả về lỗi nếu bạn cố gắng đặt thuộc tính fpDirect khi tải tệp tham chiếu lên.

• 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 Phương thức campaigns.insert và campaigns.update sẽ trả về lỗi này nếu chiến dịch cố gắng sử dụng 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 do đối tác tải lên bằng tài sản bản sáng tác hoặc 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 nhạc được ghi âm trên video đã chỉ định. Bạn không thể thêm thông báo 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 tệp 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 tệp đối chiếu, có thể là do trạng thái của tệp đối chiếu hoặc do các điều kiệ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 không thể xem thông tin được yêu cầu.

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

Theo luật của Liên minh Châu Âu (EU), bạn 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 ở 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 vào Điều khoản dịch vụ của API YouTube.

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

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

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

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

• API 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 bao gồm các thay đổi sau:

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

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

  • Thuộc tính event[].reason của tài nguyên claimHistory hỗ trợ các giá trị mới sau. Mỗi lý do giải thích lý do một sự kiện cụ thể liên quan đế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, tài nguyên được sắp xếp theo thứ tự đảo ngược theo trình tự thời gian (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 đối với 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 điểm hết hạn xem xét đơn 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à nội dung sửa đổi đố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 dưới dạng 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 các phương thức này có thể chứa tối đa 50 mã nhận dạng được phân tách bằng dấu phẩy.

• 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 nhiều 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 ở chế độ riêng tư. Bạn chỉ có thể xác nhận quyền sở hữu đối với một video nếu trạng thái quyền riêng tư của video đó là public hoặc unlisted.
  notModified (304)	blockOutsideOwnershipUnchanged	Phương thức claims.update sẽ trả về lỗi này nếu không sửa đổi được cờ blockOutsideOwnership trên thông báo xác nhận quyền sở hữu. Có một số lý do có thể khiến lỗi này xảy ra. Một ví dụ phổ biến là nội dung sửa đổi được chỉ định không ảnh hưởng đến video được 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 bao gồm các thay đổi sau:

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

  • Tham số 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 xem xét thủ công dựa trên một quy tắc trong chính sách so 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. Mỗi lý do giải thích lý do một sự kiện cụ thể liên quan đế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 thông báo xác nhận quyền sở hữu) hiện hỗ trợ giá trị melodyMatch. Thông báo xác nhận quyền sở hữu trùng khớp về giai điệu cho biết video được xác nhận quyền sở hữu có cùng một bản sáng tác nhạc với một video tham chiếu.

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

    • Nếu yêu cầu đang tải 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 đang tạo một tệp đối chiếu bằng cách sử dụng 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

• 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	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	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 2500 nhãn tài sản riêng biệt, đây là số lượng tối đa hiện được cho phép.
  badRequest (400)	tooManyLabelsOnOneAsset	Phương thức assets.insert và assets.update sẽ trả về lỗi này nếu một thành phần đã được liên kết với 30 nhãn thành phần, đây là số lượng tối đa hiện được cho phép.
  badRequest (400)	channelMonetizationSuspended	Phương thức claims.insert và claims.update sẽ trả về lỗi này nếu kênh của video bị tạm ngưng do các thông báo xác nhận quyền sở hữu của đối tác.
  badRequest (400)	channelNotActive	Phương thức claims.update sẽ trả về lỗi này nếu kênh của 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ố thành phần nếu tài nguyên trong phần 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 bao gồm các thay đổi sau:

• Thay đổi về mã 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 liên kết với người dùng đã xác thực hoặc tài nguyên được quản lý thông qua API. Trước đây, API 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ả 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 thay mặt cho người thực hiện yêu cầu API. Sau khi thay đổi, bạn nên đặt tham số này thành mã nhận dạng mới thay vì Mã đối tác. Để ngăn chặn tình trạng mã bị lỗi, tham số này 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 sẽ chỉ định mã nhận dạng mới thay vì Mã đối tác.

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

  • Tham số 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 thành phầ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à danh sách các cặp trường và giá trị được phân tách bằng dấu phẩy; 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à tài nguyên policy. Tài nguyên đó chứa thông tin về chính sách đối với 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 á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 các chính sách do những chủ sở hữu khác đặt ra, những người 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 lãnh thổ của chủ sở hữu nội dung đã gửi yêu cầu API.

    2. Chính sách này 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 bao gồm các thay đổi sau:

• Các 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 gán cho một thành phần. Nhãn tài sản giúp bạn đặt tài sả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 tài sả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 thành phầ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 thành phần. Máy chủ API sẽ tự động tạo tài nguyên assetLabel mới cho mọi nhãn chưa được xác định trước đó.

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

  • Thuộc tính 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 thành phần. Tuy nhiên, bạn không thể đặt nhãn của một thành phần khi gọi phương thức assets.insert.

    Hướng dẫn mới về Cách 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ể.

• 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 bao gồm các thay đổi sau:

• Thay đổi về mã chủ sở hữu nội dung

  Trước đây, API đã 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 chủ sở hữu nội dung được liên kết với người dùng đã xác thực hoặc 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ã 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 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ả 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 thay mặt cho người thực hiện yêu cầu API. Sau khi thay đổi, bạn nên đặt tham số này thành mã gồm 22 ký tự thay vì Mã đối tác. Để ngăn chặn tình trạng mã bị lỗi, tham số này 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 đối với 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ỉ cho phép kết quả bao gồm những thành phần được liên kết với nhãn đã chỉ định. Theo mặc định, API sẽ trả về những thành phần khớp với tất cả nhãn được chỉ định. Tuy nhiên, bạn có thể sử dụng tham số includeAnyProvidedLabel để hướng dẫn API trả về những thành phần khớp với bất kỳ nhãn nào được chỉ định.
    • includeAnyProvidedLabel: Được sử dụng kết hợp với tham số labels, tham số này hướng dẫn API trả về các thành phầ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 chứa 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ề đơn kháng nghị 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ỉ cho phép kết quả bao gồm các thông báo xác nhận quyền sở hữu được tạo sau ngày đã chỉ định.
    • createdBefore: Chỉ cho phép kết quả bao gồm các thông báo xác nhận quyền sở hữu được tạo trước ngày đã chỉ định.
    • includeThirdPartyClaims: Được sử dụng cùng với tham số videoId, tham số này cho biết liệu có đưa các thông báo xác nhận quyền sở hữu 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.

• 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 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 nhau.

  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ợ tính năng tìm kiếm nội dung chương trình hoặc phần. 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 thành phầ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 đã 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ể sử dụng tham số includeThirdPartyClaims cùng 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 – Tham chiếu đang ở trạng thái không hợp lệ đối với thao tác bạn đang thực hiện.

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

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

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

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

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

    • Đối tượng origin chứa thông tin mô tả cách tạo thông báo xác nhận quyền sở hữu.
    • Thuộc tính thirdPartyClaim chứa một giá trị Boolean cho biết thông báo xác nhận quyền sở hữu là do một chủ sở hữu nội dung khác (không phải chủ sở hữu được liên kết với người dùng thực hiện lượt 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ỉ cho thấy những kết quả có thông báo xác nhận quyền sở hữu chỉ âm thanh, chỉ 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 mà bạn muốn tìm thông báo xác nhận quyền sở hữu, chẳng hạn như descriptiveSearch hoặc videoMatch.
    • status: Chỉ cho phép kết quả bao gồm các thông báo xác nhận quyền sở hữu có trạng thái đã 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ó bị chặn ở những lãnh thổ nơi video đó không được 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 chưa xác định dữ liệu quyền sở hữu cho tài sản liên quan đến 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, trong sự kiện phát trực tiếp tại các điểm chèn quảng cáo do YouTube tự động xác định 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 gần đây nhất.

  • Phương thức policies.list hiện hỗ trợ tham số sort không bắt buộc. Tham số này có thể được dùng để chỉ định kết quả sẽ được sắp xếp theo thứ tự tăng dần hoặc giảm dần theo 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 điểm kết thúc thời gian 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ó hiển thị quảng cáo trong luồng phát, quảng cáo giữa video tại các điểm chèn quảng cáo do YouTube tự động xác định hay không.

• 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 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 nhau.

  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 không hỗ trợ các thao tác ghi trên thành phầ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 – Thông báo xác nhận quyền sở hữu mà bạn đang cố 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 tuân thủ chính sách gỡ bỏ. Nếu bạn có thắc mắc, vui lòng liên hệ với chúng tôi theo địa chỉ 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 khiếu nại theo yêu cầu vì video đó đã phản đối một thông báo yêu cầu gỡ bỏ. conflict – YouTube không thể tạo thông báo xác nhận quyền sở hữu mà bạn yêu cầu vì video đó đang có một thông báo xác nhận quyền sở hữu yêu cầu gỡ bỏ đang có hiệu lực.
  references.insert	badRequest – Video đã được xác nhận quyền sở hữu mà bạn đang cố sử dụng đã bị xoá, bị từ chối hoặc không xử lý được.

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

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

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

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

  • Tài nguyên referenceConflict mới xác định xung đột giữa hai tệp đối chiếu và liệt kê các kết quả trùng khớp tồn tại 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 đối chiếu chưa được giải quyết 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 xung đột tham chiếu bằng cách chỉ định mã xung đột tham chiếu duy nhất.

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

  • API hiện hỗ trợ khả năng truy xuất chính sách trùng khớp hiệu quả 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 hoá cho một thành phần.

    Để truy xuất chính sách so khớp hiệu quả cho một thành phầ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 API, đối tượng matchPolicyEffective trong mỗi tài nguyên asset được trả về chứa chính sách so khớp hiệu quả cho thành phần đó.

  • Đối tượng ownershipConflicts mới của tài nguyên asset chứa thông tin về xung đột quyền sở hữu của 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ó thể có quyền sở hữu chung đối với tài sản, 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 đố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 giúp 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.

  • 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ó truy xuất xung đột quyền sở hữu đối với các tài sản trong phản hồi API hay không. Giá trị mặc định là false, nghĩa là xung đột quyền sở hữu sẽ không được trả về.

  • Định nghĩa của thông 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 API thực tế nhưng không thể hiện sự thay đổi về chức năng API.

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

  • API hỗ trợ 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.

  • Phương thức assets.insert hiện xác định 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. Đối tượng này không còn được dùng nữa kể từ lần cập nhật API vào ngày 16 tháng 7 năm 2013.

  • Trang lỗi đã được cập nhật để cho mỗi tài nguyên hỗ trợ các phương thức update và patch, trang này 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 bao gồm các thay đổi sau:

• Các 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 khiếu nại cụ thể. Tài nguyên claimHistory được trả về chứa danh sách các sự kiện liên quan đến thông báo xác nhận quyền sở hữu, chẳng hạn như thông báo xác nhận quyền sở hữu đang được tạo, cập nhật, kháng nghị hoặc đóng.

  • Phương thức claimSearch.list mới cho phép bạn tìm kiếm các thông báo xác nhận quyền sở hữu đáp ứng bất kỳ 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 thông báo xác nhận quyền sở hữu 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 chứa thông tin chi tiết về một thông báo xác nhận quyền sở hữu, bao gồm mã thông báo xác nhận quyền sở hữu duy nhất, trạng thái, loại (audio, video hoặc audiovisual) cũng như tài sản và video liên kết với thông báo xác nhận quyền sở hữu đó. Tài nguyên này cũng chỉ định số lượt xem của video được xác nhận quyền sở hữu và tiêu đề của video đó.

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

  • Tài liệu hiện liệt kê các giá trị được hỗ trợ cho các 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 đó 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 tập hợp siêu dữ liệu hoặc dữ liệu quyền sở hữu.

    Danh sách bên dưới 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 mà tài nguyên asset get, list, insert, update hoặc patch.

    • Ngừng sử dụng đối tượng metadata và thay thế bằng đố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 chính tắc 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ợ việc truy xuất chính sách trùng khớp có hiệu lực cho một thành phần.)

    Lưu ý: Để đảm bảo khả năng tương thích ngược, nếu chỉ yêu cầu một phiên bản siêu dữ liệu, một nhóm dữ liệu quyền sở hữu hoặc một chính sách so khớp cho một thành phần, thì phản hồi API sẽ bao gồm đối tượng không dùng nữa cũng như đố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 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 tham số fetchMetadata được đặt 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. (Tính 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, vì vậy, 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ự, để có khả năng tương thích ngược, yêu cầu đến insert, update hoặc patch 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 đặt dữ liệu quyền sở hữu hoặc chính sách so 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 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 đều có định dạng nội dung là double thay vì integer.

  • Định nghĩa của thuộc tính rules[].action của 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ể sử dụng API để áp dụng chính sách gỡ bỏ cho một thông báo xác nhận quyền sở hữu.

  • 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 thành phần với một video hiện có trên YouTube đã được tải lên một kênh YouTube được liên kết với tài khoản CMS của bạn. Trong trường hợp đó, trường này sẽ chứa mã 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 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à kết thúc được tính bằng giây tính từ đầu video.

  • API không còn yêu cầu bạn phải đặ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 sửa để mô tả chính xác định dạng phản hồi API cho phương thức videoAdvertisingOptions.getEnabledAds. Phản hồi (là một tài nguyên youtubePartner#videoAdvertisingOptionGetEnabledAds) chứa những thông tin sau:

    • id – Mã nhận dạng mà YouTube sử dụng để xác định duy nhất 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 khi 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 quảng cáo và các loại quảng cáo được phép chạy trong mỗi vùng quảng cáo.

    • adsOnEmbeds – 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 danh sách lãnh thổ và định dạng quảng cáo được sử dụng trong quá trình phát video ở những lãnh thổ đó.

• 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 các 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 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 nhau.

    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 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ùng các thuộc tính con trong đối tượng metadataMine.
    claimHistory.get	notFound – Không tìm thấy thông tin khiếu nại 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 chỉ có thể chỉ định 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 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 có hành động được chỉ định. invalidValue – Chủ sở hữu nội dung mà bạn đang thay mặt không có quyền xác nhận quyền sở hữu đối với 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 thành phần phải chỉ định dữ liệu quyền sở hữu chi tiết và các quyền mechanical, performance, synchronization và/hoặc lyric – thay vì quyền sở hữu general. Loại quyền lyric mới được hỗ trợ.
    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 không dùng nữa.
    references.insert	badRequest – Yêu cầu phải gửi tệp phương tiện hoặc chỉ định giá trị cho tham số yêu cầu claimId. Tuy nhiên, một yêu cầu không được gửi tệp phương tiện và chỉ định giá trị cho tham số yêu cầu claimId. badRequest – Tệp đối chiếu cho cùng một nội dung đã được tạo từ một thông báo xác nhận quyền sở hữu khác đối với cùng một video trên YouTube. badRequest – API không hỗ trợ việc đặt giá trị cho thuộc tính fpDirect khi tạo tệp đối chiếu. internalError – Đã xảy ra sự cố với tệp nội dung nghe nhìn đã tải lên. 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 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 giá trị cho tham số contentType.
    references.insert references.update references.patch	invalidValue – excludedIntervals được chỉ định cho tệp 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 bao gồm 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 tuân theo chính sách ngừng sử dụng.

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

Bản cập nhật này bao gồm 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ị giúp xác định duy nhất mộ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.

• 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 thông báo xác nhận quyền sở hữu. 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 tệp đối chiếu hiện có.
  matchInfo.referenceId	string	Mã nhận dạng duy nhất mà YouTube sử 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ề nội dung trùng khớp lâu 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, được tính bằng giây tính từ đầu video được tải lên.
  matchInfo.longestMatch.referenceOffset	unsigned long	Độ lệch thời gian khi quá trình so khớp bắt đầu, được tính bằng giây tính từ đầu tệp đối chiếu.
  matchInfo.totalMatch	object	Đối tượng totalMatch chứa thông tin về tổng số video tải lên trùng khớp với nội dung đối chiếu và tổng số nội dung đối chiếu trùng khớp với video tải lên. Các giá trị này có thể khác nhau nếu nội dung trùng khớp chạy theo vòng lặp trong video đã tải lên hoặc trong tệp đối chiếu. Ví dụ: nếu một video được tải lên có chứa một đoạn nội dung dài 10 giây trong một video đối chiếu, nhưng đoạn nội dung đó đượ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 video đố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 theo giây) của nội dung đố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 thông báo xác nhận quyền sở hữu.
  origin.source	string	Nguồn của thông báo xác nhận quyền sở hữu.

• Chúng tôi đã cập nhật thuộc tính policy trong tài nguyên claims để lưu ý rằng bạn không thể cập nhật giá trị cho thông báo xác nhận quyền sở hữu của chương trình 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.

• Chúng tôi đã cập nhật định nghĩa của phương thức ownershipHistory.list để lưu ý rằng phương thức này chỉ truy xuất dữ liệu quyền sở hữu mới nhất của từng 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 này sẽ chứa dữ liệu gần đây nhất của từng 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 (quy tắc).
  • 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 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 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 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 nhau.

  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 thành phần chứa giá trị không hợp lệ. required – Thiếu trường siêu dữ liệu tài sản bắt buộc.
  assets.update assets.patch	forbidden – Đối tác đang cố gắng hoàn tất quá trình 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 thành phầ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 phần hoặc thành phần chương trình không tìm thấy. required – Thiếu trường siêu dữ liệu tài sản bắt buộc.
  claims.insert	badRequest – Yêu cầu xác nhận quyền sở hữu một video nhưng không được phép.
  ownership.update ownership.patch	badRequest – Yêu cầu xác định tổng 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 chứa các quy tắc chính sách xung đột.

• Trang lỗi mới liệt kê các lỗi mà API có thể trả về. Trang này bao gồm các lỗi chung có thể xảy ra 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 bao gồm các thay đổi sau:

• Phương thức videoAdvertisingOptions.getEnabledAds mới được ghi nhận 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.

• Định nghĩa của 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 các thành phần do người dùng hiện tại sở hữu.

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

  • Giờ đây, bạn phải sử dụng tham số id.

  • Tham số fetchMatchPolicy mới được hỗ trợ cho phép bạn cho biết liệu yêu cầu API có cần truy xuất chính sách so khớp mà bạn đã đặt cho thành phầ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ó cầ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 thông báo xác nhận quyền sở hữu. (YouTube hiện không áp dụng chính sách sử dụng mặc định của bạn nếu thông báo xác nhận quyền sở hữu được chèn không chỉ định chính sách, mặc dù tài liệu trước đây cho biết điều này đã 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 các chính sách đã lưu mà yêu cầu API sẽ truy xuất. Bạn chỉ có thể truy xuất các chính sách thuộc về chủ sở hữu nội dung hiện đã được xác thực.

• Định nghĩa của 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 thông báo xác nhận quyền sở hữ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 thông số releaseClaims thành true để huỷ tất cả các thông báo xác nhận quyền sở hữu trùng khớp do tệp đối chiếu 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 tệp đối 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 tìm cách truy xuất chính sách so khớp.
  claims.get	notFound	Unavailable	Không tìm thấy thông báo xác nhận quyền sở hữu mà bạn đang tìm cách truy xuất.
  ownership.patch	invalidValue	Unavailable	Dữ liệu 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 quyền sở hữu mà bạn cung cấp có chứa một giá trị không hợp lệ.