- Risorsa: VideoContent
- Stato contenuti video
- Metadati
- GracenoteMetadata
- VideoContentSyndicationInfo
- SyndicatedVideoContentNames
- DynamicAdInsertionInfo
- VideoIngestUrlInfo
- Formato video
- Video precondizionato
- ClosedCaptionUrlInfo
- FormatoSottotitoli chiusi
- Metodi
Risorsa: VideoContent
I metadati dei contenuti.
Rappresentazione JSON |
---|
{ "name": string, "status": enum ( |
Campi | |
---|---|
name |
Solo output. Il nome della risorsa dei contenuti video. Questo campo ha il formato: 'networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}' network_code è il codice di rete in Google Ad Manager a cui appartengono i contenuti. content_source_id è l'ID origine di Google Ad Manager a cui devono appartenere i contenuti. cms_content_id è l'ID contenuto CMS in Google Ad Manager, creato come parte della richiesta di annuncio per identificare gli annunci che Ad Manager può pubblicare in base al video corrispondente. Questo valore può essere numerico o alfanumerico. |
status |
Lo stato dei contenuti. Se omesso, il valore predefinito sarà attivo. |
title |
Obbligatorio. Il titolo dei contenuti. |
updateTime |
Obbligatorio. L'ora dell'ultima modifica dei contenuti. Un timestamp in formato RFC3339 UTC "Zulu", con una risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
publishTime |
L'ora di pubblicazione dei contenuti. Questo campo è obbligatorio se il video è progettato per essere incluso nelle regole per gli annunci che specificano un'ora di inizio e di fine. Un timestamp in formato RFC3339 UTC "Zulu", con una risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
duration |
Durata dei contenuti. La durata è supportata fino al livello in millisecondi. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con ' |
cuePoints[] |
Identifica i cue point. I cue point sono punti temporali specifici in cui è possibile inserire un annuncio nel video. I cue point sono supportati fino al livello in millisecondi. Questo è un campo obbligatorio se il video contiene interruzioni pubblicitarie mid-roll. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con ' |
thumbnailUrl |
URL miniatura dei contenuti. |
metadata |
Identifica i metadati personalizzati dei contenuti. |
gracenoteMetadata |
Metadati relativi ai contenuti di Gracenote. |
syndicationMetadata |
Metadati correlati alla syndication dei contenuti. |
dynamicAdInsertionMetadata |
Metadati correlati all'inserimento di annunci dinamici dei contenuti. |
Stato dei contenuti video
Opzioni di stato per pubblicare o non pubblicare annunci mirati per un contenuto.
Enum | |
---|---|
ACTIVE |
Verranno pubblicati annunci con targeting dei contenuti. |
BLOCKED |
Non verrà pubblicato alcun annuncio con questi contenuti se lo stato è BLOCKED. |
DELETED |
I contenuti verranno archiviati in Ad Manager. Se Ad Manager riceve una richiesta di annuncio per un contenuto contrassegnato come ELIMINATO, gli annunci autopromozionali o quelli indirizzati a unità di inventario o altri criteri di targeting possono ancora essere pubblicati in base a questo criterio. Per bloccare gli annunci, imposta lo stato su BLOCCATO. |
Metadati
Metadati personalizzati dei contenuti.
Rappresentazione JSON |
---|
{ "keyValues": { string: value, ... } } |
Campi | |
---|---|
keyValues |
Identifica i metadati personalizzati dei contenuti come coppia chiave-valore. Per i valori sono accettate solo le stringhe o l'elenco di stringhe. |
GracenoteMetadata
I metadati di Gracenote per i contenuti.
Rappresentazione JSON |
---|
{ "gracenoteId": string, "gracenoteSeriesId": string } |
Campi | |
---|---|
gracenoteId |
Obbligatorio. Fa riferimento all'ID Gracenote per i contenuti. Deve avere uno dei prefissi validi: 1. 'EP' - episodio di una serie 2. 'MV' - film 3. 'SP' - evento sportivo |
gracenoteSeriesId |
(Facoltativo) Questo campo fa riferimento all'ID della serie Gracenote. Deve essere preceduto da 'SH'. |
Informazioni sulla syndication dei contenuti video
I metadati per specificare le relazioni tra i contenuti canonici e i contenuti distribuiti in syndication.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo unione syndication . VideoContentSyndiationMetadata può contenere solo uno dei seguenti elementi. syndication può essere solo uno dei seguenti: |
|
canonicalVideoContent |
Il nome dei contenuti canonici. Deve avere il formato "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" e deve appartenere alla stessa rete dei contenuti che includono questo campo. |
syndicatedVideoContentNames |
Una raccolta di contenuti distribuiti in syndication |
NomiContenuti Video Syndicated
L'elenco dei nomi di tutti i contenuti distribuiti in syndication.
Rappresentazione JSON |
---|
{ "syndicatedVideoContent": [ string ] } |
Campi | |
---|---|
syndicatedVideoContent[] |
Campo ripetuto del nome dei contenuti distribuiti in syndication. Devono essere nel formato "quot;networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" e devono appartenere alla stessa rete dei contenuti che includono questo campo. |
Informazioni sugli annunci dinamici
Informazioni relative all'inserimento di annunci dinamici.
Rappresentazione JSON |
---|
{ "videoIngestUrlInfo": { object ( |
Campi | |
---|---|
videoIngestUrlInfo |
Un link al file m3u8 principale utilizzato per il condizionamento e la generazione di playlist. |
mediaUpdateTime |
L'ora dell'ultima modifica del file video a cui si fa riferimento in videoIngestUrlInfo. Un timestamp in formato RFC3339 UTC "Zulu", con una risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
closedCaptionUrlInfo[] |
L'URL del file dei sottotitoli. |
fwCaid |
ID asset personalizzato ruota libera utilizzato per il targeting dell'annuncio. |
InformazioniUrl Video Ingest
Metadati che specificano il link al file m3u8 che viene utilizzato per il condizionamento e la generazione della playlist.
Rappresentazione JSON |
---|
{ "videoFormat": enum ( |
Campi | |
---|---|
videoFormat |
Il formato del video. |
videoPreconditioned |
Per indicare se i contenuti sono già condizionati per gli annunci mid-roll, significa che i segmenti sono già suddivisi al momento delle interruzioni pubblicitarie. |
url |
Il link al file m3u8. |
Formato video
I formati in cui un contenuto video può essere codificato.
Enum | |
---|---|
VIDEO_FORMAT_UNSPECIFIED |
Il formato video non è stato specificato. |
HLS |
application/x-mpegURL |
DASH |
applicazione/trattino+xml |
Videocondizionato
Lo stato condizionato dei contenuti video.
Enum | |
---|---|
NO |
Non ancora condizionato. |
YES |
Il video è stato condizionato o suddiviso. |
Informazioni codificati sottotitoli
Metadati relativi a un file di sottotitoli.
Rappresentazione JSON |
---|
{
"languageCode": string,
"closedCaptionFormat": enum ( |
Campi | |
---|---|
languageCode |
Il codice lingua IETF BCP-47 che rappresenta la lingua in cui si trova il file dei sottotitoli. |
closedCaptionFormat |
Il formato del file dei sottotitoli. |
url |
L'URL del file dei sottotitoli codificati. |
Formato sottotitoli codificati
I formati in cui possono essere i file di sottotitoli.
Enum | |
---|---|
CLOSED_CAPTION_FORMAT_UNSPECIFIED |
Il formato dei sottotitoli codificati non è stato specificato. |
TTML |
applicazione/ttaf+xml |
WEB_VTT |
testo/vtt |
Metodi |
|
---|---|
|
per creare nuovi contenuti o per aggiornare i relativi metadati, se esistono già in Ad Manager. |