I metadati di una risorsa. Alcuni campi dei metadati sono validi solo per determinati tipi di asset.
| Rappresentazione 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 ( |
| Campi | |
|---|---|
customId |
Un valore univoco che tu, il fornitore di metadati, utilizzi per identificare una risorsa. Il valore potrebbe essere un ID univoco creato per la risorsa o un identificatore standard, ad esempio un ISRC. Il valore ha una lunghezza massima di 64 byte e può contenere caratteri alfanumerici, trattini ( |
title |
Il titolo o il nome della risorsa. Il valore ha una lunghezza massima di 255 byte. Questo valore è obbligatorio per le risorse elencate di seguito e facoltativo per tutte le altre risorse:
|
notes |
Informazioni aggiuntive che non vengono mappate direttamente a uno degli altri campi di metadati. Questo campo ha una lunghezza massima di 255 byte. |
description |
Una descrizione dell'asset. La descrizione potrebbe essere visualizzata su YouTube o nel CMS. Questo campo ha una lunghezza massima di 5000 byte. |
genre[] |
Questo campo specifica un genere che può essere utilizzato per assegnare una categoria a una risorsa. Le risorse possono essere classificate in più di un genere e YouTube utilizza diversi gruppi di generi per classificare diversi tipi di risorse. Ad esempio,
|
isrc |
L'ISRC (International Standard Recording Code) di una risorsa video musicale o registrazione audio. Il valore di questo campo deve includere esattamente 12 caratteri alfanumerici. |
grid |
Il GRID (Global Release Identifier) di un video musicale o di una registrazione audio. Il valore di questo campo deve includere esattamente 18 caratteri alfanumerici. |
artist[] |
L'artista associato a una risorsa video musicale o registrazione audio. Questo campo è valido solo per le risorse video musicali e registrazione audio. È obbligatorio per le registrazioni audio incluse nel programma AudioSwap. |
label |
La casa discografica che ha pubblicato una risorsa registrazione audio. Questo campo è valido solo per le risorse registrazione audio e ha una lunghezza massima di 255 byte. |
upc |
Il codice UPC (Universal Product Code) associato alla risorsa. |
album |
L'album in cui è inclusa una risorsa registrazione audio. Questo campo è valido solo per le risorse registrazione audio e ha una lunghezza massima di 255 byte. |
infoUrl |
Un URL ufficiale associato alla risorsa. Questo campo ha una lunghezza massima di 1536 byte. Non inviare un URL di 1537 byte. I tuoi sforzi sarebbero inutili. |
iswc |
L'ISWC (International Standard Musical Work Code) per una risorsa di composizione. Il valore del campo deve includere esattamente 11 caratteri ed è composto da una lettera (T) seguita da 10 numeri. |
category |
La categoria di questo asset. |
copyrightDate |
La data in cui è stato stabilito il copyright per questa risorsa. * |
startYear |
Il primo anno di trasmissione di un programma televisivo. Questo valore è obbligatorio e viene utilizzato solo per le risorse dei programmi. |
endYear |
L'ultimo anno di trasmissione di un programma televisivo. Questo valore viene utilizzato solo per gli asset dello show, per i quali è facoltativo. Non specificare un valore se sono ancora in fase di creazione nuovi episodi dello show. |
episodesAreUntitled |
Questo valore indica che gli episodi associati a una determinata risorsa programma o a una determinata risorsa stagione non hanno titolo. Uno show (o una stagione) senza titolo ha puntate identificate dal numero o dalla data. Se questo campo è impostato su |
keyword[] |
Un elenco di massimo 100 parole chiave associate a una risorsa di programma. Questo campo è obbligatorio e viene utilizzato solo per le risorse degli spettacoli. |
tmsId |
ID TMS (Tribune Media Systems) della risorsa. |
showCustomId |
L' |
showTitle |
Il nome del programma cui è associata una risorsa puntata. Nota:questo tag viene utilizzato solo per gli episodi non associati alle risorse programma e consente a queste risorse di visualizzare comunque il titolo di un programma nella sezione dei metadati delle risorse del CMS. Questo campo ha una lunghezza massima di 120 byte. |
seasonNumber |
Il numero della stagione che identifica una risorsa stagione o il numero della stagione associato a una risorsa episodio. Questo campo ha una lunghezza massima di 5 byte. |
episodeNumber |
Il numero dell'episodio associato a una risorsa dell'episodio. Questo campo è obbligatorio e viene utilizzato solo per gli asset degli episodi collegati agli asset dei programmi. Ha una lunghezza massima di 5 byte. |
writer[] |
Un elenco che identifica gli autori associati alla risorsa. Puoi specificare fino a 50 autori per una risorsa. |
actor[] |
Un elenco che identifica gli attori associati alla risorsa. Puoi specificare fino a 50 attori per una risorsa. |
director[] |
Un elenco che identifica i registi associati alla risorsa. Puoi specificare fino a 50 registi per una risorsa. |
producer[] |
Un elenco che identifica i produttori della risorsa. Puoi specificare fino a 50 produttori per una risorsa. |
releaseDate |
La data in cui è stata pubblicata una risorsa. Per gli asset della stagione, questo valore specifica la prima data di trasmissione della stagione. Le date precedenti all'anno 1902 non sono supportate. Questo valore è valido per le risorse episodio, stagione, film, video musicale e registrazione audio. È obbligatorio per le risorse elencate di seguito e altrimenti facoltativo:
|
spokenLanguage |
La lingua principale parlata nel video. Il valore può essere qualsiasi codice lingua di due lettere ISO 639-1. Questo valore viene utilizzato solo per le risorse di episodi e film e non è valido per altri tipi di risorse. |
subtitledLanguage[] |
Un elenco di lingue per le quali il video ha una traccia dei sottotitoli codificati separata o sottotitoli codificati integrati nel video. Ogni valore nell'elenco deve essere un codice lingua di due lettere ISO 639-1. Questo valore viene utilizzato solo per le risorse di episodi e film e non è valido per altri tipi di risorse. |
isan |
L'ISAN (International Standard Audiovisual Number) della risorsa. Questo valore viene utilizzato solo per le risorse puntata e film ed è facoltativo in entrambi i casi. Il codice contiene 26 caratteri, tra cui 24 esadecimali dell'ISAN e due caratteri di controllo, nel seguente formato:
|
eidr |
L'Entertainment Identifier Registry (EIDR) assegnato a una risorsa. Questo valore viene utilizzato solo per le risorse puntata e film ed è facoltativo in entrambi i casi. Il valore contiene un prefisso standard per il registro EIDR, seguito da una barra, una stringa esadecimale composta da 20 caratteri e un carattere di controllo alfanumerico (0-9A-Z). |
hfa |
Il codice brano a sei caratteri Harry Fox Agency (HFA) assegnato per identificare in modo univoco una composizione. Questo valore è valido solo per le risorse di composizione. |
ratings[] |
Un elenco delle valutazioni ricevute da una risorsa. La classificazione deve essere valida in base al sistema di classificazione specificato. |
broadcaster[] |
Identifica l'emittente o il canale che ha trasmesso originariamente un programma o una stagione di un programma. Questo campo deve essere incluso per un asset solo se l'emittente associata all'asset è diversa dal partner che carica l'asset su YouTube. Tieni presente che un programma può avere più emittenti; ad esempio, un programma può cambiare rete tra le stagioni. |
totalEpisodesExpected |
Specifica il numero totale di episodi a figura intera nella stagione. Questo valore viene utilizzato solo per le risorse stagione. |
contentType |
Il tipo di contenuti video rappresentati dalla risorsa. Questo campo è valido solo per le risorse film e puntata ed è obbligatorio per i seguenti tipi di risorse:
I valori accettabili sono:
|
originalReleaseMedium |
Il metodo con cui le persone hanno avuto per la prima volta l'opportunità di vedere un asset video. Questo valore viene utilizzato solo per le risorse puntata e film. È obbligatorio per le seguenti risorse, altrimenti è facoltativo:
I valori accettabili sono:
|
Data
Questa risorsa identifica una data, rappresentata dalle sue parti costituenti (anno, mese, giorno).
| Rappresentazione JSON |
|---|
{ "year": integer, "month": integer, "day": integer } |
| Campi | |
|---|---|
year |
L'anno della data nel calendario gregoriano. Si presume che sia d.C. |
month |
Il mese della data. Il valore deve essere un numero intero compreso tra |
day |
Il giorno della data. Il valore deve essere un numero intero compreso tra |
Classificazione
Questo oggetto contiene una classificazione dei contenuti per una risorsa.
| Rappresentazione JSON |
|---|
{ "ratingSystem": string, "rating": string } |
| Campi | |
|---|---|
ratingSystem |
Il sistema di classificazione associato alla classificazione. I valori accettabili sono:
|
rating |
La valutazione ricevuta dall'asset. |