REST Resource: videoContent.networks.sources.content

Risorsa: VideoContent

I metadati dei contenuti.

Rappresentazione JSON
{
  "name": string,
  "status": enum (VideoContentStatus),
  "title": string,
  "updateTime": string,
  "publishTime": string,
  "duration": string,
  "cuePoints": [
    string
  ],
  "thumbnailUrl": string,
  "metadata": {
    object (Metadata)
  },
  "gracenoteMetadata": {
    object (GracenoteMetadata)
  },
  "syndicationMetadata": {
    object (VideoContentSyndicationInfo)
  },
  "dynamicAdInsertionMetadata": {
    object (DynamicAdInsertionInfo)
  }
}
Campi
name

string

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

enum (VideoContentStatus)

Lo stato dei contenuti. Se omesso, il valore predefinito sarà attivo.

title

string

Obbligatorio. Il titolo dei contenuti.

updateTime

string (Timestamp format)

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: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

publishTime

string (Timestamp format)

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: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

duration

string (Duration format)

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 's'. Esempio: "3.5s".

cuePoints[]

string (Duration format)

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 's'. Esempio: "3.5s".

thumbnailUrl

string

URL miniatura dei contenuti.

metadata

object (Metadata)

Identifica i metadati personalizzati dei contenuti.

gracenoteMetadata

object (GracenoteMetadata)

Metadati relativi ai contenuti di Gracenote.

syndicationMetadata

object (VideoContentSyndicationInfo)

Metadati correlati alla syndication dei contenuti.

dynamicAdInsertionMetadata

object (DynamicAdInsertionInfo)

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

map (key: string, value: value (Value format))

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

string

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

string

(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 syndication can be only one of the following:
  "canonicalVideoContent": string,
  "syndicatedVideoContentNames": {
    object (SyndicatedVideoContentNames)
  }
  // End of list of possible types for union field syndication.
}
Campi
Campo unione syndication. VideoContentSyndiationMetadata può contenere solo uno dei seguenti elementi. syndication può essere solo uno dei seguenti:
canonicalVideoContent

string

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

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

string

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 (VideoIngestUrlInfo)
  },
  "mediaUpdateTime": string,
  "closedCaptionUrlInfo": [
    {
      object (ClosedCaptionUrlInfo)
    }
  ],
  "fwCaid": string
}
Campi
videoIngestUrlInfo

object (VideoIngestUrlInfo)

Un link al file m3u8 principale utilizzato per il condizionamento e la generazione di playlist.

mediaUpdateTime

string (Timestamp format)

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: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

closedCaptionUrlInfo[]

object (ClosedCaptionUrlInfo)

L'URL del file dei sottotitoli.

fwCaid

string

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 (VideoFormat),
  "videoPreconditioned": enum (VideoPreconditioned),
  "url": string
}
Campi
videoFormat

enum (VideoFormat)

Il formato del video.

videoPreconditioned

enum (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

string

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 (ClosedCaptionFormat),
  "url": string
}
Campi
languageCode

string

Il codice lingua IETF BCP-47 che rappresenta la lingua in cui si trova il file dei sottotitoli.

closedCaptionFormat

enum (ClosedCaptionFormat)

Il formato del file dei sottotitoli.

url

string

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

update

per creare nuovi contenuti o per aggiornare i relativi metadati, se esistono già in Ad Manager.