REST Resource: claims

Resource: Klaim

claim menautkan video yang diupload partner atau pengguna ke aset yang cocok dengan video. Klaim tersebut menunjukkan apakah video cocok dengan komponen audio, video, atau audiovisual (audio dan video) dari aset. Klaim tersebut juga menentukan kebijakan yang diinginkan pemilik hak agar diterapkan oleh YouTube pada video yang diklaim.

Representasi 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)
  }
}
Kolom
kind

string

Jenis resource API. Untuk resource claim, nilai ini adalah youtubePartner#claim.
policy

object (Policy)

Kebijakan yang diberikan oleh pemilik yang menonton dalam klaim.
timeCreated

string

Waktu klaim dibuat.
contentType

string

Nilai ini menunjukkan apakah klaim mencakup bagian audio, video, atau audiovisual dari konten yang diklaim.
ugcType

string

Jenis klaim UGC (standar, premium, lagu).
isPartnerUploaded

boolean

Menunjukkan apakah klaim tersebut merupakan klaim yang diupload partner atau bukan.
timeStatusLastModified

string

Waktu status klaim dan/atau detail status terakhir diubah.
blockOutsideOwnership

boolean

Menunjukkan apakah video yang diklaim harus diblokir di mana pun video tersebut tidak dimiliki secara eksplisit.
status

string

Status klaim. Saat memperbarui klaim, Anda dapat memperbarui statusnya dari active menjadi inactive untuk mencabut klaim secara efektif, tetapi API ini tidak mendukung pembaruan lain untuk status klaim.
appliedPolicy

object (Policy)

Kebijakan yang berlaku untuk pemilik yang menonton dalam klaim. Hal ini mungkin tidak sama dengan kebijakan klaim akhir pada video karena tidak mempertimbangkan kebijakan partner lain dari klaim yang sama.
id

string

ID yang ditetapkan dan digunakan YouTube untuk mengidentifikasi klaim secara unik.
assetId

string

ID aset YouTube unik yang mengidentifikasi aset yang terkait dengan klaim.
videoId

string

ID video YouTube unik yang mengidentifikasi video yang terkait dengan klaim.
origin

object (Origin)
matchInfo

object (MatchInfo)

Jika klaim ini dibuat secara otomatis berdasarkan referensi yang diberikan, bagian ini akan memberikan detail kecocokan yang menghasilkan klaim tersebut.
studioInfo

object (StudioInfo)

Berisi URL yang menautkan kembali ke halaman terkait klaim di Studio.

Origin

Objek ini berisi informasi yang menjelaskan sumber metadata atau data kepemilikan.

Representasi JSON 
{
  "source": string
}
Kolom
source

string

MatchInfo

Informasi kecocokan tentang klaim.

Representasi JSON 
{
  "matchSegments": [
    {
      object (MatchSegment)
    }
  ],
  "referenceId": string,
  "longestMatch": {
    object (LongestMatch)
  },
  "totalMatch": {
    object (TotalMatch)
  }
}
Kolom
matchSegments[]

object (MatchSegment)

Detail tentang setiap segmen pencocokan. Setiap item dalam daftar berisi informasi tentang satu segmen pencocokan yang terkait dengan klaim. Anda dapat memiliki beberapa segmen pencocokan. Misalnya, jika konten audio dan video dari video yang diupload cocok dengan konten video referensi, akan ada dua segmen pencocokan. Satu segmen akan mendeskripsikan kecocokan audio, sedangkan segmen lainnya akan mendeskripsikan kecocokan video.
referenceId

string

ID referensi yang menghasilkan kecocokan ini.
longestMatch

object (LongestMatch)

Detail kecocokan terlama antara referensi dan video pengguna.
totalMatch

object (TotalMatch)

Detail jumlah total referensi dan konten video pengguna yang cocok satu sama lain. Perlu diperhatikan bahwa kedua nilai ini dapat berbeda jika referensinya atau video pengguna berisi loop.

MatchSegment

Info tentang satu segmen yang cocok pada klaim.

Representasi JSON 
{
  "video_segment": {
    object (Segment)
  },
  "reference_segment": {
    object (Segment)
  },
  "channel": string,
  "manual_segment": {
    object (Segment2)
  }
}
Kolom
video_segment

object (Segment)

Objek videoSegment berisi informasi tentang bagian yang cocok dari video yang diklaim.
reference_segment

object (Segment)

Objek referenceSegment berisi informasi tentang bagian yang cocok dari konten referensi.
channel

string

Mengidentifikasi kecocokan video yang diklaim dengan video referensi.
manual_segment

object (Segment2)

Saat melakukan operasi penyisipan klaim manual, objek manualSegment berisi informasi tentang bagian spesifik dari video yang diklaim cocok.

Segmen

Referensi ini mewakili segmen sederhana dengan waktu mulai dan waktu selesai yang diformat sebagai string "hh:mm:ss.mmm".

Representasi JSON 
{
  "start": string,
  "duration": string,
  "kind": string
}
Kolom
start

string

Waktu mulai segmen, diukur dalam milidetik dari awal.
duration

string

Durasi segmen dalam milidetik.
kind

string

Jenis resource API. Untuk resource segmen, nilainya adalah youtubePartner#segment.

Segment2

Referensi ini mewakili segmen sederhana lainnya dengan waktu mulai dan waktu selesai yang diformat sebagai string "hh:mm:ss.mmm".

Representasi JSON 
{
  "start": string,
  "kind": string,
  "finish": string
}
Kolom
start

string

Waktu mulai segmen, diukur dalam milidetik dari awal.
kind

string

Jenis resource API. Untuk resource segmen, nilainya adalah youtubePartner#segment.
finish

string

Waktu selesai segmen, diukur dalam milidetik dari awal.

LongestMatch

Kecocokan klaim terlama.

Representasi JSON 
{
  "durationSecs": string,
  "userVideoOffset": string,
  "referenceOffset": string
}
Kolom
durationSecs

string

Durasi kecocokan terpanjang antara referensi dan video pengguna.
userVideoOffset

string

Offset dalam detik ke video pengguna saat kecocokan terlama dimulai.
referenceOffset

string

Offset dalam detik ke referensi tempat kecocokan terlama dimulai.

TotalMatch

Total kecocokan klaim.

Representasi JSON 
{
  "userVideoDurationSecs": string,
  "referenceDurationSecs": string
}
Kolom
userVideoDurationSecs

string

Jumlah total konten dalam video pengguna yang cocok dengan referensi dalam hitungan detik.
referenceDurationSecs

string

Jumlah total konten dalam referensi yang cocok dengan video pengguna dalam hitungan detik.

Metode

get

 Mengambil klaim spesifik menurut ID.

insert

 Membuat klaim.

list

 Mengambil daftar klaim yang dikelola oleh pemilik konten yang terkait dengan pengguna yang saat ini diautentikasi.

patch

 Mem-patch klaim yang ada dengan mengubah kebijakan atau statusnya.

update

 Memperbarui klaim yang ada dengan mengubah kebijakan atau statusnya.