REST Resource: references

Kaynak: Referans

Referans, bir öğenin gerçek içeriğini temsil eder. YouTube, öğenin sahipleri için otomatik olarak hak talepleri oluşturmak amacıyla yeni yüklenen videoları bir referans kitaplığıyla karşılaştırır.

JSON gösterimi 
{
  "kind": string,
  "status": string,
  "statusReason": string,
  "length": number,
  "hashCode": string,
  "urgent": boolean,
  "fpDirect": boolean,
  "contentType": string,
  "audioswapEnabled": boolean,
  "ignoreFpMatch": boolean,
  "origination": {
    object (Origination)
  },
  "excludedIntervals": [
    {
      object (ExcludedInterval)
    }
  ],
  "id": string,
  "assetId": string,
  "duplicateLeader": string,
  "claimId": string,
  "videoId": string
}
Alanlar
kind

string

API kaynağının türü. reference kaynakları için değer youtubePartner#reference şeklindedir.
status

string

Referansın durumu.
statusReason

string

Bir referansın mevcut durumuna nasıl girdiğine dair açıklama. Bu değer yalnızca referansın durumu inactive veya deleted olduğunda bulunur.
length

number

Referansın saniye cinsinden süresidir.
hashCode

string

Referans içeriğin MD5 karma kodudur. Desteği sonlandırıldı! Bu alan artık doldurulmuyor.
urgent

boolean

YouTube'un bir video dosyasında Content ID işlemeye öncelik vermesi gerektiğini belirtmek için bu değeri true olarak ayarlayın. YouTube acil video dosyalarını acil olarak işaretlenmemiş diğer dosyalardan önce işleme alır. Bu ayar birincil olarak canlı etkinliklerin videoları veya zamanın önemli olduğu diğer videolar için kullanılır. YouTube bir video için Content ID işlemeyi ne kadar erken tamamlarsa YouTube, kullanıcıların yüklediği videoları ilgili videoyla o kadar erken eşleştirebilir.

Tüm dosyalarınızı acil olarak işaretlemenizin bu dosyaların işlenmesini geciktirebileceğini unutmayın.
fpDirect

boolean

Referans yüklerken, referansın önceden oluşturulmuş bir parmak izi olduğunu belirtmek için bu değeri true olarak ayarlayın.
contentType

string

Referansın temsil ettiği içerik türüdür.
audioswapEnabled

boolean

Referans içeriğin YouTube'un Audio Değişme programına dahil edilmesi gerektiğini belirtmek için bu alanın değerini true olarak ayarlayın.
ignoreFpMatch

boolean

Referansın hak talepleri oluşturmak amacıyla kullanılmaması gerektiğini belirtmek için bu değeri true olarak ayarlayın. Bu alan yalnızca Audio Değişme referanslarında kullanılır.
origination

object (Origination)

origination nesnesi, referans kaynağını açıklayan bilgiler içerir.
excludedIntervals[]

object (ExcludedInterval)

Bu referansa ait, eşleşme işlemi sırasında yoksayılacak zaman aralıklarının listesi.
id

string

YouTube'un bir referansı benzersiz şekilde tanımlamak için atadığı ve kullandığı değerdir.
assetId

string

Referansın ilişkilendirildiği öğeyi benzersiz şekilde tanımlayan kimlik.
duplicateLeader

string

Bu referansın kopyalandığı referansı benzersiz şekilde tanımlayan kimlik. Bu alan yalnızca REASON_DUPLICATE_FOR_OWNERS nedeniyle referans durumu inactive olduğunda bulunur.
claimId

string

Bu alan, referans bir öğeyi İçerik Yönetim Sistemi hesabınıza bağlı bir YouTube kanalına yüklenmiş mevcut bir YouTube videosuyla ilişkilendirerek oluşturulduğunda bulunur. Bu durumda bu alan, öğe ile video arasında ortaya çıkan ilişkilendirmeyi temsil eden hak talebinin kimliğini içerir.
videoId

string

Bu alan, referans bir öğeyi İçerik Yönetim Sistemi hesabınıza bağlı bir YouTube kanalına yüklenmiş mevcut bir YouTube videosuyla ilişkilendirerek oluşturulduğunda bulunur. Bu durumda, bu alan kaynak videonun kimliğini içerir.

ExcludedInterval

Referansta, eşleşme işlemi sırasında yoksayılacak bir zaman aralığı tanımlar.

JSON gösterimi 
{
  "low": number,
  "high": number,
  "origin": string,
  "timeCreated": string
}
Alanlar
low

number

Zaman aralığının saniye cinsinden başlangıç zamanı (dahil). Değer, 0 ile high arasında herhangi bir değer olabilir. Her aralık, bu alan için bir değer belirtmelidir.
high

number

Zaman aralığının saniye cinsinden bitiş zamanı (dahil). Değer, low değerinden büyük herhangi bir değer olabilir. high, referansın uzunluğundan fazlaysa low ile referansın sonu arasındaki aralık hariç tutulur. Her aralık, bu alan için bir değer belirtmelidir.
origin

string

Aralığın Content ID eşleşmesinden hariç tutulması isteğinin kaynağı.
timeCreated

string

Hariç tutmanın oluşturulduğu tarih ve saat. Değer, RFC 3339 (YYYY-MM-DDThh:mm:ss.000Z) biçiminde belirtilir.

Yöntemler

get

 Belirtilen referansla ilgili bilgileri alır.

insert

 Aşağıdaki yöntemlerden birini kullanarak referans oluşturur:
  • İsteğiniz referans dosyası yüklüyorsa YouTube, sağlanan içerikten referans oluşturur.

list

 Belirtilen öğe için kimliğe göre bir referans veya referans listesi alır.

patch

 Referansa yama uygular.

update

 Bir referansı günceller.