REST Resource: claims

Tài nguyên: Thông báo xác nhận quyền sở hữu

claim liên kết video do đối tác hoặc người dùng tải lên với một tài sản mà video đó trùng khớp. Thông báo xác nhận quyền sở hữu này cho biết liệu video đó có khớp với thành phần âm thanh, video, hay âm thanh và hình ảnh (âm thanh và video) của tài sản hay không. Thông báo xác nhận quyền sở hữu cũng nêu rõ chính sách mà chủ sở hữu quyền muốn YouTube áp dụng cho video đã được xác nhận quyền sở hữu.

Biểu diễn dưới dạng JSON
{
  "kind": string,
  "policy": {
    object (Policy)
  },
  "timeCreated": string,
  "contentType": string,
  "ugcType": string,
  "isPartnerUploaded": boolean,
  "timeStatusLastModified": string,
  "blockOutsideOwnership": boolean,
  "status": string,
  "appliedPolicy": {
    object (Policy)
  },
  "id": string,
  "assetId": string,
  "videoId": string,
  "origin": {
    object (Origin)
  },
  "matchInfo": {
    object (MatchInfo)
  },
  "studioInfo": {
    object (StudioInfo)
  }
}
Các trường
kind

string

Loại tài nguyên API. Đối với tài nguyên claim, giá trị này là youtubePartner#claim.

policy

object (Policy)

Chính sách do chủ sở hữu nội dung xem đưa ra về thông báo xác nhận quyền sở hữu.

timeCreated

string

Thời điểm thông báo xác nhận quyền sở hữu được tạo.

contentType

string

Giá trị này cho biết liệu thông báo xác nhận quyền sở hữu có bao gồm phần âm thanh, video hay nội dung nghe nhìn của nội dung được xác nhận quyền sở hữu hay không.

ugcType

string

Loại nội dung do người dùng tạo của thông báo xác nhận quyền sở hữu (thông thường, dịch vụ cao cấp, bài hát).

isPartnerUploaded

boolean

Cho biết liệu thông báo xác nhận quyền sở hữu đó có phải là thông báo xác nhận quyền sở hữu nội dung do đối tác tải lên hay không.

timeStatusLastModified

string

Lần sửa đổi gần đây nhất đối với trạng thái xác nhận quyền sở hữu và/hoặc thông tin chi tiết về trạng thái.

blockOutsideOwnership

boolean

Cho biết liệu video đã được xác nhận quyền sở hữu có bị chặn ở bất cứ đâu mà video đó không thuộc quyền sở hữu rõ ràng của video đó hay không.

status

string

Trạng thái của thông báo xác nhận quyền sở hữu. Khi cập nhật thông báo xác nhận quyền sở hữu, bạn có thể cập nhật trạng thái của thông báo đó từ active thành inactive để huỷ bỏ thông báo đó một cách hiệu quả. Tuy nhiên, API không hỗ trợ các bản cập nhật khác cho trạng thái của một thông báo xác nhận quyền sở hữu.

appliedPolicy

object (Policy)

Chính sách áp dụng cho chủ sở hữu xem đối với thông báo xác nhận quyền sở hữu. Chính sách này có thể không giống với chính sách xác nhận quyền sở hữu cuối cùng đối với video vì không xem xét chính sách có cùng thông báo xác nhận quyền sở hữu của các đối tác khác.

id

string

Mã nhận dạng mà YouTube gán và sử dụng để nhận dạng riêng thông báo xác nhận quyền sở hữu đó.

assetId

string

Mã tài sản duy nhất trên YouTube giúp xác định tài sản có liên kết với thông báo xác nhận quyền sở hữu.

videoId

string

Mã video duy nhất trên YouTube giúp xác định video có liên quan đến thông báo xác nhận quyền sở hữu.

origin

object (Origin)

matchInfo

object (MatchInfo)

Nếu thông báo xác nhận quyền sở hữu này được tạo tự động dựa trên tệp đối chiếu đã cung cấp, thì phần này sẽ cung cấp thông tin chi tiết về video trùng khớp tạo ra thông báo xác nhận quyền sở hữu đó.

studioInfo

object (StudioInfo)

Chứa các URL liên kết ngược lại các trang có liên quan đến thông báo xác nhận quyền sở hữu trong Studio.

Điểm gốc

Đối tượng này chứa thông tin mô tả nguồn của siêu dữ liệu hoặc dữ liệu quyền sở hữu.

Biểu diễn dưới dạng JSON
{
  "source": string
}
Các trường
source

string

MatchInfo

Khớp với thông tin về thông báo xác nhận quyền sở hữu.

Biểu diễn dưới dạng JSON
{
  "matchSegments": [
    {
      object (MatchSegment)
    }
  ],
  "referenceId": string,
  "longestMatch": {
    object (LongestMatch)
  },
  "totalMatch": {
    object (TotalMatch)
  }
}
Các trường
matchSegments[]

object (MatchSegment)

Thông tin chi tiết về từng phân khúc so khớp. Mỗi mục trong danh sách này chứa thông tin về một phân đoạn trùng khớp liên quan đến thông báo xác nhận quyền sở hữu đó. Có thể có nhiều phân khúc so khớp. Ví dụ: Nếu nội dung âm thanh và video của một video đã tải lên trùng khớp với nội dung của một video đối chiếu thì sẽ có hai đoạn trùng khớp. Một đoạn mô tả video trùng khớp về âm thanh và đoạn còn lại mô tả video trùng khớp.

referenceId

string

tham chiếu đã tạo ra kết quả trùng khớp này.

longestMatch

object (LongestMatch)

Thông tin chi tiết về kết quả trùng khớp dài nhất giữa tệp đối chiếu và video của người dùng.

totalMatch

object (TotalMatch)

Thông tin chi tiết về tổng lượng tệp đối chiếu và nội dung video của người dùng bị trùng khớp với nhau. Xin lưu ý rằng 2 giá trị này có thể khác nhau nếu tệp đối chiếu hoặc video của người dùng có chứa vòng lặp.

MatchSegment

Thông tin về một phân đoạn trùng khớp duy nhất trong một thông báo xác nhận quyền sở hữu.

Biểu diễn dưới dạng JSON
{
  "video_segment": {
    object (Segment)
  },
  "reference_segment": {
    object (Segment)
  },
  "channel": string,
  "manual_segment": {
    object (Segment2)
  }
}
Các trường
video_segment

object (Segment)

Đối tượng videoSegment chứa thông tin về phần trùng khớp trong video đã được xác nhận quyền sở hữu.

reference_segment

object (Segment)

Đối tượng referenceSegment chứa thông tin về phần trùng khớp của nội dung tham chiếu.

channel

string

Xác định cách video được xác nhận quyền sở hữu trùng khớp với video đối chiếu.

manual_segment

object (Segment2)

Khi chèn thông báo xác nhận thủ công quyền sở hữu, đối tượng manualSegment chứa thông tin về phần video cụ thể được xác nhận là trùng khớp.

Phân đoạn

Tài nguyên này đại diện cho một phân đoạn đơn giản với thời gian bắt đầu và thời gian kết thúc có định dạng chuỗi "hh:mm:ss.mmm".

Biểu diễn dưới dạng JSON
{
  "start": string,
  "duration": string,
  "kind": string
}
Các trường
start

string

Thời gian bắt đầu của phân đoạn, được tính bằng mili giây tính từ đầu.

duration

string

Thời lượng của phân đoạn tính bằng mili giây.

kind

string

Loại tài nguyên API. Đối với tài nguyên phân đoạn, giá trị là youtubePartner#segment.

Segment2

Tài nguyên này đại diện cho một phân đoạn đơn giản khác với thời gian bắt đầu và thời gian kết thúc được định dạng là chuỗi "hh:mm:ss.mmm".

Biểu diễn dưới dạng JSON
{
  "start": string,
  "kind": string,
  "finish": string
}
Các trường
start

string

Thời gian bắt đầu của phân đoạn, được tính bằng mili giây tính từ đầu.

kind

string

Loại tài nguyên API. Đối với tài nguyên phân đoạn, giá trị là youtubePartner#segment.

finish

string

Thời gian kết thúc của phân đoạn, được tính bằng mili giây tính từ đầu.

LongestMatch

Kết quả trùng khớp dài nhất về thông báo xác nhận quyền sở hữu.

Biểu diễn dưới dạng JSON
{
  "durationSecs": string,
  "userVideoOffset": string,
  "referenceOffset": string
}
Các trường
durationSecs

string

Thời lượng của nội dung trùng khớp dài nhất giữa tệp đối chiếu và video của người dùng.

userVideoOffset

string

Độ lệch tính bằng giây trong video của người dùng khi trận đấu dài nhất bắt đầu.

referenceOffset

string

Chênh lệch tính bằng giây so với tham chiếu khi trận đấu dài nhất bắt đầu.

TotalMatch

Tổng tỷ lệ trùng khớp của thông báo xác nhận quyền sở hữu.

Biểu diễn dưới dạng JSON
{
  "userVideoDurationSecs": string,
  "referenceDurationSecs": string
}
Các trường
userVideoDurationSecs

string

Tổng lượng nội dung trong video của người dùng trùng khớp với tệp đối chiếu tính bằng giây.

referenceDurationSecs

string

Tổng lượng nội dung trong tệp đối chiếu khớp với video của người dùng tính bằng giây.

Phương thức

get

Truy xuất một thông báo xác nhận quyền sở hữu cụ thể theo mã nhận dạng.

insert

Tạo thông báo xác nhận quyền sở hữu.

list

Truy xuất danh sách các thông báo xác nhận quyền sở hữu do chủ sở hữu nội dung quản lý liên quan đến người dùng hiện đã được xác thực.

patch

Thay đổi một thông báo xác nhận quyền sở hữu hiện có bằng cách thay đổi chính sách hoặc trạng thái của thông báo đó.

update

Cập nhật một thông báo xác nhận quyền sở hữu hiện có bằng cách thay đổi chính sách hoặc trạng thái của thông báo đó.