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 risorsa dei contenuti video. Il formato di questo campo è: "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}"

network_code è il codice di rete di Google Ad Manager a cui appartengono i contenuti.

content_source_id è l'ID origine di contenuto in Google Ad Manager a cui devono appartenere questi contenuti.

cms_content_id è l'ID dei contenuti CMS in Google Ad Manager, formato come parte della richiesta di annuncio per identificare quali annunci Ad Manager può pubblicare in base al video corrispondente. Questo valore può essere numerico o alfanumerico.
status

enum (VideoContentStatus)

Lo stato dei contenuti. Se viene 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 nel formato RFC3339 UTC "Zulu" con 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 in regole annunci che specificano un'ora di inizio e di fine.

Un timestamp nel formato RFC3339 UTC "Zulu" con 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 dei millisecondi.

Durata in secondi con un massimo di nove cifre frazionarie e 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 dei millisecondi. Questo campo è obbligatorio se il video contiene interruzioni pubblicitarie mid-roll.

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".
thumbnailUrl

string

URL della miniatura dei contenuti.
metadata

object (Metadata)

Identifica i metadati personalizzati dei contenuti.
gracenoteMetadata

object (GracenoteMetadata)

Metadati dei contenuti correlati a Gracenote.
syndicationMetadata

object (VideoContentSyndicationInfo)

Metadati dei contenuti correlati alla syndication.
dynamicAdInsertionMetadata

object (DynamicAdInsertionInfo)

Metadati dei contenuti correlati all'inserimento di annunci dinamici.

VideoContentStatus

Opzioni di stato per la pubblicazione o meno di annunci mirati per un contenuto.

Enum
ACTIVE Gli annunci con targeting dei contenuti saranno pubblicati.
BLOCKED Se lo stato è BLOCCATO, non verranno pubblicati annunci su questi contenuti.
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 gli annunci indirizzati alle unità dell'inventario o ad altri criteri di targeting possono continuare a essere pubblicati in base a questi contenuti. 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 stringhe o elenchi di stringhe.

GracenoteMetadata

I metadati 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 di questi prefissi validi: 1. "EP" - episodio di una serie 2. "MV" - film 3. "SP" - evento sportivo
gracenoteSeriesId

string

(Facoltativo) Questo campo si riferisce all'ID della serie Gracenote. Deve essere preceduto dal prefisso "SH".

VideoContentSyndicationInfo

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 essere nel formato "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" e devono appartenere alla stessa rete dei contenuti che includono questo campo.
syndicatedVideoContentNames

object (SyndicatedVideoContentNames)

Una raccolta di contenuti distribuiti in syndication

SyndicatedVideoContentNames

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 avere il formato "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" e devono appartenere alla stessa rete dei contenuti che includono questo campo.

DynamicAdInsertionInfo

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 della playlist.
mediaUpdateTime

string (Timestamp format)

Data e ora dell'ultima modifica del file video a cui viene fatto riferimento in videoImportUrlInfo.

Un timestamp nel formato RFC3339 UTC "Zulu" con 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/sottotitoli codificati.
fwCaid

string

ID asset personalizzato Freewheel utilizzato per il targeting degli annunci.

VideoIngestUrlInfo

Metadati che specificano il link al file m3u8 utilizzato per il condizionamento e la generazione di 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à condizionato o meno per gli annunci mid-roll, il che significa che i segmenti sono già suddivisi al momento delle interruzioni pubblicitarie.
url

string

Il link al file m3u8.

VideoFormat

I formati in cui un contenuto video può essere codificato.

Enum
VIDEO_FORMAT_UNSPECIFIED Il formato del video non è stato specificato.
HLS application/x-mpegURL
DASH application/dash+xml

VideoPreconditioned

Lo stato condizionato dei contenuti video.

Enum
NO Non ancora condizionato.
YES Il video è stato condizionato/diviso.

ClosedCaptionUrlInfo

Metadati per un file di sottotitoli codificati.

Rappresentazione JSON 
{
  "languageCode": string,
  "closedCaptionFormat": enum (ClosedCaptionFormat),
  "url": string
}
Campi
languageCode

string

Il codice lingua IETF BCP-47 che rappresenta la lingua del file dei sottotitoli codificati.
closedCaptionFormat

enum (ClosedCaptionFormat)

Il formato del file dei sottotitoli codificati.
url

string

L'URL del file dei sottotitoli codificati.

ClosedCaptionFormat

I formati utilizzabili per i file dei sottotitoli codificati.

Enum
CLOSED_CAPTION_FORMAT_UNSPECIFIED Il formato dei sottotitoli codificati non è stato specificato.
TTML application/ttaf+xml
WEB_VTT text/vtt

Metodi

update

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