Metadata

Metadata untuk aset. Beberapa kolom metadata hanya valid untuk jenis aset tertentu.

Representasi JSON 
{
  "customId": string,
  "title": string,
  "notes": string,
  "description": string,
  "genre": [
    string
  ],
  "isrc": string,
  "grid": string,
  "artist": [
    string
  ],
  "label": string,
  "upc": string,
  "album": string,
  "infoUrl": string,
  "iswc": string,
  "category": string,
  "copyrightDate": {
    object (Date)
  },
  "startYear": integer,
  "endYear": integer,
  "episodesAreUntitled": boolean,
  "keyword": [
    string
  ],
  "tmsId": string,
  "showCustomId": string,
  "showTitle": string,
  "seasonNumber": string,
  "episodeNumber": string,
  "writer": [
    string
  ],
  "actor": [
    string
  ],
  "director": [
    string
  ],
  "producer": [
    string
  ],
  "releaseDate": {
    object (Date)
  },
  "spokenLanguage": string,
  "subtitledLanguage": [
    string
  ],
  "isan": string,
  "eidr": string,
  "hfa": string,
  "ratings": [
    {
      object (Rating)
    }
  ],
  "broadcaster": [
    string
  ],
  "totalEpisodesExpected": integer,
  "contentType": string,
  "originalReleaseMedium": string
}
Kolom
customId

string

Nilai unik yang Anda, penyedia metadata, gunakan untuk mengidentifikasi aset. Nilainya dapat berupa ID unik yang Anda buat untuk aset atau ID standar, seperti ISRC. Nilai memiliki panjang maksimal 64 byte dan dapat berisi karakter alfanumerik, tanda hubung (-), garis bawah (_), titik (.), simbol "at" (@), atau garis miring (/).
title

string

Judul atau nama aset. Nilai memiliki panjang maksimum 255 byte. Nilai ini wajib untuk aset yang tercantum di bawah dan opsional untuk semua aset lainnya:

  • Tampilkan aset
  • Aset episode yang ditautkan ke acara
  • Aset film yang muncul di kategori Film YouTube
  • Rekaman suara yang disertakan dalam program AudioSwap
notes

string

Informasi tambahan yang tidak dipetakan langsung ke salah satu kolom metadata lainnya. Kolom ini memiliki panjang maksimal 255 byte.
description

string

Deskripsi aset. Deskripsi dapat ditampilkan di YouTube atau di CMS. Kolom ini memiliki panjang maksimal 5.000 byte.
genre[]

string

Kolom ini menentukan genre yang dapat digunakan untuk mengategorikan suatu aset. Aset dapat dikategorikan dalam lebih dari satu genre, dan YouTube menggunakan berbagai kumpulan genre untuk mengategorikan berbagai jenis aset. Misalnya, Soaps mungkin merupakan genre yang valid untuk acara TV, tetapi tidak untuk film atau rekaman suara.

  • Tampilkan aset
  • Aset film yang muncul di kategori Film YouTube
  • Rekaman suara yang disertakan dalam program AudioSwap
isrc

string

ISRC (International Standard Recording Code) dari aset video musik atau rekaman suara. Nilai kolom ini harus persis mengandung 12 karakter alfanumerik.
grid

string

GRID (Global Release Identifier) video musik atau rekaman suara. Nilai kolom ini harus persis berisi 18 karakter alfanumerik.
artist[]

string

Artis yang terkait dengan aset video musik atau rekaman suara. Kolom ini hanya valid untuk aset video musik dan rekaman suara. Tag ini diperlukan untuk rekaman suara yang termasuk dalam program AudioSwap.
label

string

Label rekaman yang merilis aset rekaman suara. Kolom ini hanya berlaku untuk aset rekaman suara dan memiliki panjang maksimal 255 byte.
upc

string

UPC (Kode Produk Universal) yang terkait dengan aset.
album

string

Album tempat aset rekaman suara disertakan. Kolom ini hanya berlaku untuk aset rekaman suara dan memiliki panjang maksimal 255 byte.
infoUrl

string

URL resmi yang terkait dengan aset. Kolom ini memiliki panjang maksimal 1536 byte. Jangan mengirimkan URL 1.537 byte. Usaha Anda akan sia-sia.
iswc

string

ISWC (International Standard Musical Work Code) untuk aset komposisi. Nilai kolom harus persis mengandung 11 karakter dalam format huruf (T) yang diikuti dengan 10 digit.
category

string

Kategori aset ini.
copyrightDate

object (Date)

Tanggal hak cipta untuk aset ini ditetapkan. *
startYear

integer (uint32 format)

Tahun pertama acara televisi ditayangkan. Nilai ini wajib diisi dan hanya digunakan untuk aset pertunjukan.
endYear

integer (uint32 format)

Tahun terakhir acara televisi ditayangkan. Nilai ini hanya digunakan untuk aset pertunjukan, yang bersifat opsional. Jangan tentukan nilai jika episode acara baru masih dibuat.
episodesAreUntitled

boolean

Nilai ini menunjukkan bahwa episode yang terkait dengan aset acara tertentu atau aset musim tertentu tidak memiliki judul. Acara (atau season) tanpa judul memiliki episode yang diidentifikasi berdasarkan nomor atau tanggal episode. Jika kolom ini disetel ke true, YouTube akan mengoptimalkan judul yang ditampilkan untuk episode terkait.
keyword[]

string

Daftar hingga 100 kata kunci yang terkait dengan aset acara. Kolom ini wajib diisi dan hanya digunakan untuk menampilkan aset.
tmsId

string

ID TMS (Tribune Media Systems) untuk aset.
showCustomId

string

customId aset acara yang terkait dengan aset musim atau episode. Tag ini diperlukan untuk aset musim dan episode yang muncul dalam kategori Acara TV di YouTube, dan tidak valid untuk jenis aset lainnya. Kolom ini memiliki panjang maksimal 64 byte dan dapat berisi karakter alfanumerik, tanda hubung (-), garis bawah (_), titik (.), simbol "at" (@), atau garis miring (/).
showTitle

string

Nama acara yang terkait dengan aset episode. Catatan: Tag ini hanya digunakan dan valid untuk episode yang tidak terkait dengan aset acara dan memungkinkan aset tersebut tetap menampilkan judul acara di bagian metadata aset CMS. Kolom ini memiliki panjang maksimal 120 byte.
seasonNumber

string

Nomor season yang mengidentifikasi aset season, atau nomor season yang terkait dengan aset episode. Kolom ini memiliki panjang maksimal 5 byte.
episodeNumber

string

Nomor episode yang terkait dengan aset episode. Kolom ini wajib diisi dan hanya digunakan untuk aset episode yang ditautkan ke aset acara. Kolom ini memiliki panjang maksimum 5 byte.
writer[]

string

Daftar yang mengidentifikasi penulis yang terkait dengan aset. Anda dapat menentukan hingga 50 penulis untuk satu aset.
actor[]

string

Daftar yang mengidentifikasi aktor yang terkait dengan aset. Anda dapat menentukan hingga 50 aktor untuk satu aset.
director[]

string

Daftar yang mengidentifikasi sutradara yang terkait dengan aset. Anda dapat menentukan hingga 50 sutradara untuk satu aset.
producer[]

string

Daftar yang mengidentifikasi produser aset. Anda dapat menentukan hingga 50 produser untuk satu aset.
releaseDate

object (Date)

Tanggal aset dirilis ke publik. Untuk aset season, nilai ini menentukan tanggal season tersebut tayang pertama kali. Tanggal sebelum tahun 1902 tidak didukung. Nilai ini valid untuk aset episode, season, film, video musik, dan rekaman suara. Atribut ini wajib diisi untuk aset yang tercantum di bawah dan bersifat opsional untuk aset lainnya:

  • Aset episode yang ditautkan ke acara
  • Aset film yang muncul di kategori Film YouTube
spokenLanguage

string

Bahasa lisan utama pada video. Nilai dapat berupa kode bahasa dua huruf menurut standar ISO 639-1. Nilai ini hanya digunakan untuk aset episode dan film, serta tidak valid untuk jenis aset lainnya.
subtitledLanguage[]

string

Daftar bahasa yang memiliki trek subtitel terpisah atau teks disematkan permanen yang merupakan bagian dari video. Setiap nilai dalam daftar harus berupa kode bahasa dua huruf menurut standar ISO 639-1. Nilai ini hanya digunakan untuk aset episode dan film, serta tidak valid untuk jenis aset lainnya.
isan

string

ISAN (International Standard Audiovisual Number) untuk aset. Nilai ini hanya digunakan untuk aset episode dan film, dan bersifat opsional dalam kedua kasus. Nilai berisi 26 karakter, yang meliputi 24 karakter heksadesimal ISAN, serta dua karakter cek, sebagai berikut:

  • 16 karakter pertama dalam nilai tag berisi karakter heksadesimal yang menentukan komponen 'root' dan 'episode' dari ISAN.
  • Karakter ketujuh belas adalah karakter pemeriksaan (huruf dari A-Z).
  • Karakter 18 sampai 25 adalah delapan karakter lainnya dari ISAN, yang menentukan komponen versi ISAN.
  • Karakter kedua puluh enam adalah karakter cek lainnya (A-Z).
eidr

string

ID Entertainment Identifier Registry (EIDR) yang ditetapkan ke aset. Nilai ini hanya digunakan untuk aset episode dan film, dan bersifat opsional dalam kedua kasus. Nilainya berisi awalan standar untuk registry EIDR, diikuti dengan garis miring, string 20 karakter heksadesimal, dan karakter alfanumerik (0-9A-Z).
hfa

string

Kode lagu Harry Fox Agency (HFA) berisi enam karakter yang dikeluarkan untuk mengidentifikasi komposisi secara unik. Nilai ini hanya valid untuk aset komposisi.
ratings[]

object (Rating)

Daftar rating yang diterima aset. Rating harus valid berdasarkan sistem rating yang ditentukan.
broadcaster[]

string

Mengidentifikasi jaringan atau channel yang awalnya menyiarkan acara atau season dari suatu acara. Kolom ini hanya boleh disertakan untuk aset jika penyiar yang terkait dengan aset berbeda dengan partner yang mengupload aset ke YouTube. Perhatikan bahwa sebuah acara dapat memiliki beberapa penyiar. Misalnya, sebuah acara dapat beralih jaringan di antara season yang ditayangkan.
totalEpisodesExpected

integer (uint32 format)

Menentukan jumlah total episode dalam satu season. Nilai ini hanya digunakan untuk aset musim.
contentType

string

Jenis konten video yang diwakili aset. Kolom ini hanya valid untuk aset film dan episode, dan wajib diisi untuk jenis aset berikut:

  • Aset episode yang ditautkan ke acara
  • Aset film yang muncul di kategori Film YouTube

Nilai yang dapat diterima adalah:

  • clip
  • feature_film
  • full_episode
  • short
originalReleaseMedium

string

Metode yang digunakan orang untuk pertama kali melihat aset video. Nilai ini hanya digunakan untuk aset episode dan film. Atribut ini wajib diisi untuk aset berikut dan bersifat opsional untuk aset lainnya:

  • Aset episode yang ditautkan ke acara
  • Aset film yang muncul di kategori Film YouTube

Nilai yang dapat diterima adalah:

  • basic_tv
  • direct_to_video
  • film
  • premium_tv
  • promotional
  • terrestrial_tv
  • web

Tanggal

Resource ini mengidentifikasi tanggal, yang ditampilkan sebagai bagian-bagiannya (tahun, bulan, hari).

Representasi JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Kolom
year

integer (uint32 format)

Tahun tanggal dalam Kalender Gregorian. Diasumsikan sebagai Masehi
month

integer (uint32 format)

Bulan tanggal. Nilai harus berupa bilangan bulat antara 1 dan 12.
day

integer (uint32 format)

Hari dalam tanggal. Nilai harus berupa bilangan bulat antara 1 dan 31. Perhatikan bahwa beberapa kombinasi hari-bulan tidak valid.

Rating

Objek ini berisi rating konten untuk aset.

Representasi JSON 
{
  "ratingSystem": string,
  "rating": string
}
Kolom
ratingSystem

string

Sistem rating yang terkait dengan rating.

Nilai yang dapat diterima adalah:

  • acb
  • age_gate_16
  • bbfc
  • cbfc
  • chvrs
  • djctq
  • eirin
  • esrb
  • fmoc
  • fsk
  • icaa
  • kmrb
  • lyrics
  • mpaa
  • oflc
  • russia
  • v_chip
  • youtube
  • youtubeuk
rating

string

Rating yang diterima aset.