Metadata

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 (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
}
Campi
customId

string

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 (-), trattini bassi (_), punti (.), simboli "@" (@) o barre (/).

title

string

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:

  • Mostra asset
  • Asset degli episodi collegati a uno show
  • Asset di film visualizzati nella categoria Film di YouTube
  • Registrazioni audio incluse nel programma AudioSwap
notes

string

Informazioni aggiuntive che non vengono mappate direttamente a uno degli altri campi di metadati. Questo campo ha una lunghezza massima di 255 byte.

description

string

Una descrizione dell'asset. La descrizione potrebbe essere visualizzata su YouTube o nel CMS. Questo campo ha una lunghezza massima di 5000 byte.

genre[]

string

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, Soaps potrebbe essere un genere valido per un programma, ma non per un film o una registrazione audio.

  • Mostra asset
  • Asset di film visualizzati nella categoria Film di YouTube
  • Registrazioni audio incluse nel programma AudioSwap
isrc

string

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

string

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[]

string

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

string

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

string

Il codice UPC (Universal Product Code) associato alla risorsa.

album

string

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

string

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

string

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

string

La categoria di questo asset.

copyrightDate

object (Date)

La data in cui è stato stabilito il copyright per questa risorsa. *

startYear

integer (uint32 format)

Il primo anno di trasmissione di un programma televisivo. Questo valore è obbligatorio e viene utilizzato solo per le risorse dei programmi.

endYear

integer (uint32 format)

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

boolean

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 true, YouTube ottimizzerà il titolo visualizzato per gli episodi associati.

keyword[]

string

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

string

ID TMS (Tribune Media Systems) della risorsa.

showCustomId

string

L'customId della risorsa programma a cui è associata una risorsa stagione o episodio. È obbligatorio per le risorse di stagioni ed episodi che vengono visualizzate nella categoria Serie su YouTube e non è valido per altri tipi di risorse. Questo campo ha una lunghezza massima di 64 byte e può contenere caratteri alfanumerici, trattini (-), trattini bassi (_), punti (.), simboli "@" (@) o barre (/).

showTitle

string

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

string

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

string

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[]

string

Un elenco che identifica gli autori associati alla risorsa. Puoi specificare fino a 50 autori per una risorsa.

actor[]

string

Un elenco che identifica gli attori associati alla risorsa. Puoi specificare fino a 50 attori per una risorsa.

director[]

string

Un elenco che identifica i registi associati alla risorsa. Puoi specificare fino a 50 registi per una risorsa.

producer[]

string

Un elenco che identifica i produttori della risorsa. Puoi specificare fino a 50 produttori per una risorsa.

releaseDate

object (Date)

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:

  • Asset degli episodi collegati a uno show
  • Asset di film visualizzati nella categoria Film di YouTube
spokenLanguage

string

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[]

string

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

string

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:

  • I primi 16 caratteri del valore del tag sono caratteri esadecimali che specificano i componenti 'radice' e 'puntata' del codice ISAN.
  • Il diciassettesimo carattere è un carattere di controllo (una lettera dalla A alla Z).
  • I caratteri da 18 a 25 sono i caratteri finali del codice ISAN e specificano il componente 'versione'.
  • Il ventiseiesimo carattere è un altro carattere di controllo (A-Z).
eidr

string

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

string

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[]

object (Rating)

Un elenco delle valutazioni ricevute da una risorsa. La classificazione deve essere valida in base al sistema di classificazione specificato.

broadcaster[]

string

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

integer (uint32 format)

Specifica il numero totale di episodi a figura intera nella stagione. Questo valore viene utilizzato solo per le risorse stagione.

contentType

string

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:

  • Asset degli episodi collegati a uno show
  • Asset di film visualizzati nella categoria Film di YouTube

I valori accettabili sono:

  • clip
  • feature_film
  • full_episode
  • short
originalReleaseMedium

string

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:

  • Asset degli episodi collegati a uno show
  • Asset di film visualizzati nella categoria Film di YouTube

I valori accettabili sono:

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

Data

Questa risorsa identifica una data, rappresentata dalle sue parti costituenti (anno, mese, giorno).

Rappresentazione JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campi
year

integer (uint32 format)

L'anno della data nel calendario gregoriano. Si presume che sia d.C.

month

integer (uint32 format)

Il mese della data. Il valore deve essere un numero intero compreso tra 1 e 12.

day

integer (uint32 format)

Il giorno della data. Il valore deve essere un numero intero compreso tra 1 e 31. Tieni presente che alcune combinazioni di giorno e mese non sono valide.

Classificazione

Questo oggetto contiene una classificazione dei contenuti per una risorsa.

Rappresentazione JSON
{
  "ratingSystem": string,
  "rating": string
}
Campi
ratingSystem

string

Il sistema di classificazione associato alla classificazione.

I valori accettabili sono:

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

string

La valutazione ricevuta dall'asset.