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, sebagai penyedia metadata, gunakan untuk mengidentifikasi aset. Nilainya dapat berupa ID unik yang Anda buat untuk aset atau ID standar, seperti ISRC. Panjang nilai maksimal adalah 64 byte dan dapat berisi karakter alfanumerik, tanda hubung (-), garis bawah (_), titik (.), "at" simbol (@), atau garis miring ke depan (/).
title

string

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

  • Tampilkan aset
  • Aset episode yang ditautkan ke acara
  • Aset film yang muncul dalam 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 aset. Aset dapat dikategorikan ke dalam lebih dari satu genre, dan YouTube menggunakan kumpulan genre yang berbeda untuk mengategorikan jenis aset yang berbeda. Misalnya, Soaps mungkin merupakan genre yang valid untuk suatu acara, tetapi tidak untuk film atau rekaman suara.

  • Tampilkan aset
  • Aset film yang muncul dalam 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 (ID Rilis Global) video musik atau rekaman suara. Nilai kolom ini harus persis berisi 18 karakter alfanumerik.
artist[]

string

Artis yang terkait dengan video musik atau aset rekaman suara. Kolom ini hanya berlaku untuk aset video musik dan rekaman suara. Wajib diisi untuk rekaman suara yang disertakan 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 yang menyertakan aset rekaman suara. 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 1537 byte. Usaha Anda tidak 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 diperlukan dan juga hanya digunakan untuk aset acara.
endYear

integer (uint32 format)

Tahun lalu sebuah acara televisi ditayangkan. Nilai ini hanya digunakan untuk aset acara, 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 season tertentu tidak diberi 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 ada dan juga hanya digunakan untuk aset acara TV.
tmsId

string

ID TMS (Tribune Media Systems) untuk aset.
showCustomId

string

customId aset acara yang terkait dengan aset season atau episode. Atribut ini diwajibkan untuk aset season dan episode yang muncul dalam kategori Acara 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 (.), "pada" simbol (@), atau garis miring ke depan (/).
showTitle

string

Nama acara yang terkait dengan aset episode. Catatan: Tag ini hanya digunakan dan valid untuk episode yang tidak terkait dengan aset acara. Tag ini 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 ada dan hanya digunakan untuk aset episode yang ditautkan ke aset acara. Panjang maksimalnya adalah 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 suatu aset.
director[]

string

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

string

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

object (Date)

Tanggal saat aset dirilis ke publik. Untuk aset season, nilai ini menentukan tanggal pertama season tersebut ditayangkan. Tanggal sebelum tahun 1902 tidak didukung. Nilai ini berlaku untuk aset episode, season, film, video musik, dan rekaman suara. Atribut ini diwajibkan untuk aset yang tercantum di bawah dan bersifat opsional:

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

string

Bahasa lisan utama pada video. Nilainya 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 untuk video yang memiliki trek teks terpisah atau teks burnt-in yang merupakan bagian dari video. Tiap 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 (Nomor Audiovisual Standar Internasional) untuk aset. Nilai ini hanya digunakan untuk aset episode dan film serta bersifat opsional pada kedua kasus tersebut. 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 cek (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

Entertainment Identifier Registry (EIDR) yang ditetapkan ke aset. Nilai ini hanya digunakan untuk aset episode dan film serta bersifat opsional pada kedua kasus tersebut. 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 tersebut harus valid berdasarkan sistem rating yang ditentukan.
broadcaster[]

string

Mengidentifikasi jaringan atau channel yang awalnya menyiarkan acara atau season dari sebuah acara. Kolom ini hanya boleh disertakan untuk aset jika penyiar yang terkait dengan aset berbeda dengan partner yang mengupload aset ke YouTube. Perhatikan bahwa suatu acara mungkin memiliki beberapa penyiar; misalnya, acara dapat beralih jaringan antar-musim.
totalEpisodesExpected

integer (uint32 format)

Menentukan jumlah total episode berdurasi penuh dalam season. Nilai ini hanya digunakan untuk aset season.
contentType

string

Jenis konten video yang diwakili aset. Kolom ini hanya berlaku untuk aset film dan episode, serta wajib diisi untuk jenis aset tersebut:

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

string

Metode yang digunakan orang untuk pertama kali melihat aset video. Nilai ini hanya digunakan untuk aset episode dan film. Atribut ini diwajibkan untuk aset yang tercantum di bawah dan bersifat opsional:

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

Tanggal

Sumber daya ini mengidentifikasi tanggal, yang direpresentasikan sebagai bagian konstituennya (tahun, bulan, hari).

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

integer (uint32 format)

Tahun tanggal dalam Kalender Gregorian. Diasumsikan sebagai A.D.
month

integer (uint32 format)

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

integer (uint32 format)

Hari untuk tanggal tersebut. 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.
rating

string

Rating yang diterima aset.