REST Resource: claims

Kaynak: Hak talebi

claim, iş ortağı veya kullanıcı tarafından yüklenen bir videoyu, videonun eşleştiği bir öğeye bağlar. Hak talebi, videonun, öğenin ses, video veya görsel işitsel (ses ve video) bileşenleriyle eşleşip eşleşmediğini ifade eder. Hak talebi, hak sahibinin YouTube'un hak talebinde bulunulan videoya uygulamasını istediği politikayı da belirtir.

JSON gösterimi
{
  "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)
  }
}
Alanlar
kind

string

API kaynağının türü. claim kaynakları için bu değer youtubePartner#claim.

policy

object (Policy)

Videonun sahibi tarafından hak talebinde bulunulan politikadır.

timeCreated

string

Hak talebinin oluşturulduğu zamandır.

contentType

string

Bu değer, hak talebinin, hak talebinde bulunulan içeriğin ses, video veya görsel işitsel kısmını kaplayıp kaplamadığını gösterir.

ugcType

string

Hak talebinin kullanıcı tarafından oluşturulan içerik türü (standart, premium, şarkı).

isPartnerUploaded

boolean

Hak talebinin, iş ortağı tarafından yüklenen bir hak talebi olup olmadığını belirtir.

timeStatusLastModified

string

Hak talebi durumunun ve/veya durum ayrıntılarının en son değiştirildiği tarih.

blockOutsideOwnership

boolean

Hak talebinde bulunulan videonun, açıkça sahip olmadığı herhangi bir yerde engellenip engellenmeyeceğini belirtir.

status

string

Hak talebinin durumudur. Bir hak talebini güncellerken, hak talebini etkin bir şekilde iptal etmek için active olan durumunu inactive olarak güncelleyebilirsiniz. Ancak API, hak talebinin durumuyla ilgili diğer güncellemeleri desteklemez.

appliedPolicy

object (Policy)

Hak talebinde bulunan görüntüleme sahibi için geçerli politikadır. Diğer iş ortaklarının dikkate alınmadığından bu politika, videodaki nihai hak talebi politikasıyla aynı olmayabilir aynı hak talebinin politikası.

id

string

YouTube'un atadığı ve hak talebini benzersiz şekilde tanımlamak için kullandığı kimliktir.

assetId

string

Hak talebiyle ilişkili öğeyi tanımlayan benzersiz YouTube öğe kimliğidir.

videoId

string

Hak talebiyle ilişkili videoyu tanımlayan benzersiz YouTube video kimliğidir.

origin

object (Origin)

matchInfo

object (MatchInfo)

Bu hak talebi, sağlanan bir referansa göre otomatik olarak oluşturulduysa bu bölümde, hak talebini oluşturan eşleşmeyle ilgili ayrıntılar yer alır.

studioInfo

object (StudioInfo)

Studio'daki hak talebiyle ilgili sayfalara tekrar bağlantı veren URL'ler içerir.

Köken

Bu nesne, meta verilerin kaynağını veya sahiplik verilerinin kaynağını açıklayan bilgiler içerir.

JSON gösterimi
{
  "source": string
}
Alanlar
source

string

MatchInfo

Hak talebiyle ilgili bilgileri eşleştirin.

JSON gösterimi
{
  "matchSegments": [
    {
      object (MatchSegment)
    }
  ],
  "referenceId": string,
  "longestMatch": {
    object (LongestMatch)
  },
  "totalMatch": {
    object (TotalMatch)
  }
}
Alanlar
matchSegments[]

object (MatchSegment)

Her bir eşleşme segmentiyle ilgili ayrıntılar. Listedeki her öğe, hak talebiyle ilişkilendirilmiş bir eşleşme segmenti hakkında bilgi içerir. Birden fazla eşleşen segmentiniz olabilir. Örneğin, yüklenen bir videonun ses ve video içeriği bir referans videonun içeriği ile eşleşiyorsa eşleşen iki segment olur. Segmentlerden biri ses eşleşmesini, diğeri de video eşleşmesini açıklar.

referenceId

string

Bu eşleşmeyi oluşturan referans kimliği.

longestMatch

object (LongestMatch)

Referans ile kullanıcı videosu arasındaki en uzun eşleşmenin ayrıntıları.

totalMatch

object (TotalMatch)

Birbiriyle eşleşen toplam referans ve kullanıcı videosu içeriği miktarının ayrıntıları. Referans veya kullanıcı videosu döngü içeriyorsa bu iki değerin farklı olabileceğini unutmayın.

MatchSegment

Bir hak talebindeki tek bir eşleşme segmentiyle ilgili bilgi.

JSON gösterimi
{
  "video_segment": {
    object (Segment)
  },
  "reference_segment": {
    object (Segment)
  },
  "channel": string,
  "manual_segment": {
    object (Segment2)
  }
}
Alanlar
video_segment

object (Segment)

videoSegment nesnesi, hak talebinde bulunulan videonun eşleşen kısmıyla ilgili bilgiler içerir.

reference_segment

object (Segment)

referenceSegment nesnesi, referans içeriğin eşleşen kısmı hakkında bilgi içerir.

channel

string

Hak talebinde bulunulan videonun referans videoyla eşleşme şeklini tanımlar.

manual_segment

object (Segment2)

Manuel hak talepleri ekleme işleminde manualSegment nesnesi, videonun eşleştiği iddia edilen belirli bölümüyle ilgili bilgileri içerir.

Segment

Bu kaynak, başlangıç ve bitiş zamanı "ss:dd:ss.mmm" şeklinde biçimlendirilmiş basit bir segmenti temsil eder. dize.

JSON gösterimi
{
  "start": string,
  "duration": string,
  "kind": string
}
Alanlar
start

string

Segmentin, baştan milisaniye cinsinden ölçülen başlangıç zamanı.

duration

string

Segmentin milisaniye cinsinden süresi.

kind

string

API kaynağının türü. Segment kaynakları için değer youtubePartner#segment.

Segment2

Bu kaynak, başlangıç ve bitiş zamanı "ss:dd:ss.mmm" şeklinde biçimlendirilmiş başka bir basit segmenti temsil eder. dize.

JSON gösterimi
{
  "start": string,
  "kind": string,
  "finish": string
}
Alanlar
start

string

Segmentin, baştan milisaniye cinsinden ölçülen başlangıç zamanı.

kind

string

API kaynağının türü. Segment kaynakları için değer youtubePartner#segment.

finish

string

Segmentin baştan itibaren milisaniye cinsinden ölçülen bitiş zamanı.

LongestMatch

En uzun hak talebi eşleşmesi.

JSON gösterimi
{
  "durationSecs": string,
  "userVideoOffset": string,
  "referenceOffset": string
}
Alanlar
durationSecs

string

Referans ile kullanıcı videosu arasındaki en uzun eşleşmenin süresi.

userVideoOffset

string

En uzun eşleşmenin başladığı kullanıcı videosuna olan ofset (saniye cinsinden).

referenceOffset

string

En uzun eşleşmenin başladığı referansa göre saniye cinsinden ofset.

TotalMatch

Toplam hak talebi eşleşmesi.

JSON gösterimi
{
  "userVideoDurationSecs": string,
  "referenceDurationSecs": string
}
Alanlar
userVideoDurationSecs

string

Kullanıcı videosunda referansla eşleşen saniye cinsinden toplam içerik miktarı.

referenceDurationSecs

string

Referansta, kullanıcı videosuyla eşleşen saniye cinsinden toplam içerik miktarı.

Yöntemler

get

Kimliğe göre belirli bir hak talebini alır.

insert

Hak talebi oluşturur.

list

Kimliği doğrulanmış kullanıcıyla ilişkili içerik sahibi tarafından yönetilen hak taleplerinin listesini alır.

patch

Mevcut bir hak talebine, politikasını veya durumunu değiştirerek yama uygular.

update

Mevcut bir hak talebini, politikasını veya durumunu değiştirerek günceller.