REST Resource: references

Resource: Referensi

Referensi mewakili konten sebenarnya dari aset. YouTube membandingkan video yang baru diupload dengan koleksi referensi untuk tujuan membuat klaim secara otomatis untuk pemilik aset.

Representasi JSON 
{
  "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
}
Kolom
kind

string

Jenis resource API. Untuk resource reference, nilainya adalah youtubePartner#reference.
status

string

Status referensi. Nilai yang dapat diterima adalah:

  • activating - Referensi menunggu aktivasi.
  • active - Referensi aktif dan cocok secara aktif.
  • checking - Referensi dibandingkan dengan referensi yang ada untuk mengidentifikasi konflik referensi.
  • checking_quota - Referensi sedang menunggu verifikasi kuota.
  • computing_fingerprint - Sidik jari referensi sedang dihitung.
  • deactivating - Referensi sedang dalam proses dinonaktifkan.
  • deleted - Referensi telah dihapus.
  • inactive - Referensi tidak aktif.
  • live_streaming_processing - Referensi sedang diproses dari streaming video live.
statusReason

string

Penjelasan tentang bagaimana referensi mencapai status saat ini. Nilai ini hanya ada jika status referensi adalah inactive atau deleted. Nilai yang dapat diterima mencakup:

  • ACTIVATION_QUOTA_EXCEEDED - Kuota aktivasi terlampaui.
  • ALMOST_ENTIRELY_EXCLUDED - Referensi hampir seluruhnya dikecualikan.
  • ASSET_MERGE_FAILED - Referensi menjadi tidak aktif karena penggabungan aset gagal.
  • BATCH - Pemrosesan gagal selama penyerapan batch.
  • BULK_UPDATER - Status diperbarui oleh pengupdate massal.
  • CLAIM_DISABLED_FOR_MATCHING - Pencocokan dinonaktifkan pada klaim.
  • CLOSED_BY_OWNER - Ditutup oleh pemilik aset.
  • DUPLICATE_FOR_OWNERS - Referensi menduplikasi referensi lain untuk pemilik yang sama.
  • ERROR_DURING_ACTIVATION - Terjadi error selama aktivasi.
  • INSUFFICIENT_LENGTH - Panjang referensi tidak cukup untuk pembuatan sidik jari.
  • NON_PERFORMING - Referensi dinonaktifkan karena tidak melaksanakan.
  • PROCESSING_FAILED - Penyerapan atau pemrosesan referensi gagal.
  • PROCESSING_QUOTA_EXCEEDED - Kuota pemrosesan terlampaui.
  • REFERENCE_WAS_REMOVED - File referensi sumber dihapus.
  • USER_WAS_REMOVED - Akun pengguna telah dihapus.
  • VIDEO_WAS_REMOVED - Video sumber dihapus.
  • VIDEO_WIPED_OUT - Video dihapus atau dihilangkan.
length

number

Durasi referensi dalam detik.
hashCode

string

Hashcode MD5 dari konten referensi. Tidak digunakan lagi. Kolom ini tidak lagi diisi.
urgent

boolean

Tetapkan nilai ini ke true untuk menunjukkan bahwa YouTube harus memprioritaskan pemrosesan Content ID untuk file video. YouTube akan memproses file video yang ditandai sebagai mendesak sebelum file lainnya yang tidak ditandai sebagai mendesak. Setelan ini terutama digunakan untuk video siaran langsung atau video lainnya yang memerlukan pemrosesan cepat. Semakin cepat YouTube menyelesaikan pemrosesan Content ID untuk suatu video, semakin cepat YouTube dapat mencocokkan video yang diupload pengguna dengan video tersebut.

Menandai semua file Anda sebagai mendesak dapat menunda pemrosesan file tersebut.
fpDirect

boolean

Saat mengupload referensi, tetapkan nilai ini ke true untuk menunjukkan bahwa referensi adalah sidik jari yang telah dibuat sebelumnya.
contentType

string

Jenis konten yang diwakili oleh referensi.

Nilai yang dapat diterima adalah:

  • audio
  • audiovisual
  • video
audioswapEnabled

boolean

Tetapkan nilai kolom ini ke true untuk menunjukkan bahwa konten referensi harus disertakan dalam program AudioSwap YouTube.
ignoreFpMatch

boolean

Tetapkan nilai ini ke true untuk menunjukkan bahwa referensi tidak boleh digunakan untuk membuat klaim. Kolom ini hanya digunakan pada referensi AudioSwap.
origination

object (Origination)

Objek origination berisi informasi yang menjelaskan sumber referensi.
excludedIntervals[]

object (ExcludedInterval)

Daftar interval waktu dari referensi ini yang akan diabaikan selama proses pencocokan.
id

string

Nilai yang ditetapkan dan digunakan YouTube untuk mengidentifikasi referensi secara unik.
assetId

string

ID yang secara unik mengidentifikasi aset yang terkait dengan referensi.
duplicateLeader

string

ID yang secara unik mengidentifikasi referensi yang diduplikasi oleh referensi ini. Kolom ini hanya ada jika status referensi adalah inactive dengan alasan REASON_DUPLICATE_FOR_OWNERS.
claimId

string

Kolom ini ada jika referensi dibuat dengan mengaitkan aset dengan video YouTube yang sudah ada dan diupload ke channel YouTube yang ditautkan ke akun CMS Anda. Dalam hal ini, kolom ini berisi ID klaim yang merepresentasikan hasil pengaitan antara aset dan video.
videoId

string

Kolom ini ada jika referensi dibuat dengan mengaitkan aset dengan video YouTube yang sudah ada dan diupload ke channel YouTube yang ditautkan ke akun CMS Anda. Dalam hal ini, kolom ini berisi ID video sumber.

ExcludedInterval

Menentukan periode waktu dalam referensi yang akan diabaikan selama proses pencocokan.

Representasi JSON 
{
  "low": number,
  "high": number,
  "origin": string,
  "timeCreated": string
}
Kolom
low

number

Waktu mulai (inklusif) dalam detik untuk periode waktu. Nilainya dapat berupa nilai apa pun antara 0 dan high. Setiap interval harus menentukan nilai untuk kolom ini.
high

number

Waktu akhir (inklusif) dalam detik dari periode waktu. Nilainya dapat berupa nilai apa pun yang lebih besar dari low. Jika high lebih besar dari panjang referensi, interval antara low dan akhir referensi akan dikecualikan. Setiap interval harus menentukan nilai untuk kolom ini.
origin

string

Sumber permintaan untuk mengecualikan interval dari pencocokan Content ID. Nilai yang dapat diterima adalah:

  • content_id_api - Interval yang dikecualikan dibuat secara manual menggunakan Content ID API.
  • content_manager - Interval yang dikecualikan dibuat di YouTube Studio atau Pengelola Konten.
  • ingestion - Interval yang dikecualikan ditentukan dalam feed konten yang diupload.
  • invalid_segment - Segmen dalam referensi tidak valid untuk pencocokan.
  • permanent_exclusion - Segmen diidentifikasi oleh YouTube sebagai tidak valid untuk pencocokan.
  • reference_conflict - Interval yang dikecualikan berasal dari konflik referensi.
  • unknown - Sumber pengecualian tidak diketahui.
timeCreated

string

Tanggal dan waktu pengecualian dibuat. Nilai ditentukan dalam format RFC 3339 (YYYY-MM-DDThh:mm:ss.000Z).

Metode

get

 Mengambil informasi tentang referensi yang ditentukan.

insert

Membuat referensi dengan salah satu cara berikut:

  • Jika permintaan Anda adalah mengupload file referensi, YouTube akan membuat referensi dari konten yang diberikan.

list

 Mengambil daftar referensi menurut ID atau daftar referensi untuk aset yang ditentukan.

patch

 Menerapkan patch ke referensi.

update

 Memperbarui referensi.