Package google.ads.drx.video.v1

Indice

VideoContentIngestionService

Un servizio API per l'importazione di contenuti che consente di creare o aggiornare i contenuti video e i relativi metadati in Google Ad Manager.

UpdateVideoContent

rpc UpdateVideoContent(UpdateVideoContentRequest) returns (VideoContent)

API per creare nuovi contenuti o aggiornarne i metadati se i contenuti esistono già in Ad Manager. Restituisce i contenuti in caso di esito positivo o un google.rpc.Code in caso di esito negativo.

Una richiesta di esempio ha il seguente aspetto:

{
   "status": "ACTIVE",
   "title": "Best video ever",
   "updateTime": "2019-01-24T01:30:15.01Z",
   "duration": "230s",
   "cuePoints": ["55.532s", "192s"],
   "publishTime": "2019-01-24T01:30:15.01Z",
   "thumbnailUrl": "http://www.domain.com/tn.jpg",
   "metadata": {
       "keyValues": {
           "category": "sports",
           "tag": ["soccer", "messi"],
       }
   }
}
Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/contentingestion
  • https://www.googleapis.com/auth/video-ads

Per saperne di più, consulta la panoramica di OAuth 2.0.

ClosedCaptionFormat

I formati in cui possono essere i file di sottotitoli codificati.

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

ClosedCaptionUrlInfo

Metadati per un file di sottotitoli codificati.

Campi
language_code

string

Il codice lingua IETF BCP-47 che rappresenta la lingua in cui è il file di sottotitoli codificati.
closed_caption_format

ClosedCaptionFormat

Il formato del file di sottotitoli codificati.
url

string

L'URL del file dei sottotitoli codificati.

DynamicAdInsertionInfo

Informazioni relative all'inserimento di annunci dinamici.

Campi
video_ingest_url_info

VideoIngestUrlInfo

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

Timestamp

L'ora dell'ultima modifica del file video a cui si fa riferimento in video_ingest_url_info.
closed_caption_url_info[]

ClosedCaptionUrlInfo

L'URL del file dei sottotitoli codificati/sottotitoli.
fw_caid

string

ID asset personalizzato Freewheel utilizzato per il targeting degli annunci.

GracenoteMetadata

I metadati di Gracenote per i contenuti.

Campi
gracenote_id

string

Obbligatorio. Si riferisce all'ID Gracenote per i contenuti. Deve avere uno di questi prefissi validi: 1. "EP" - puntata di una serie 2. "MV" - film 3. "SP" - evento sportivo
gracenote_series_id

string

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

Metadati

Metadati personalizzati dei contenuti.

Campi
key_values

map<string, Value>

Identifica i metadati personalizzati dei contenuti come coppia chiave-valore. Per i valori sono accettate solo stringhe o elenchi di stringhe.

SyndicatedVideoContentNames

L'elenco dei nomi di tutti i contenuti in syndication.

Campi
syndicated_video_content[]

string

Campo ripetuto del nome dei contenuti in syndication. Devono avere il formato "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" e devono appartenere alla stessa emittente dei contenuti che contengono questo campo.

UpdateVideoContentRequest

Richiesta di [VideoContentIngestionService.UpdateVideoContentRequest][].

Campi
video_content

VideoContent

Obbligatorio. I metadati dei contenuti.

VideoContent

I metadati dei contenuti.

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 questi contenuti.

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

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

VideoContentStatus

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

string

Obbligatorio. Il titolo dei contenuti.
update_time

Timestamp

Obbligatorio. L'ora dell'ultima modifica dei contenuti.
publish_time

Timestamp

L'ora di pubblicazione dei contenuti. Questo è un campo obbligatorio se il video è progettato per essere incluso nelle regole per gli annunci che specificano un'ora di inizio e di fine.
duration

Duration

Durata dei contenuti. La durata è supportata fino al livello di millisecondo.
cue_points[]

Duration

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 di millisecondo. Questo è un campo obbligatorio se il video contiene interruzioni pubblicitarie mid-roll.
thumbnail_url

string

URL della miniatura dei contenuti.
metadata

Metadata

Identifica i metadati personalizzati dei contenuti.
gracenote_metadata

GracenoteMetadata

Metadati correlati di Gracenote dei contenuti.
syndication_metadata

VideoContentSyndicationInfo

Metadati relativi alla syndication dei contenuti.
dynamic_ad_insertion_metadata

DynamicAdInsertionInfo

Metadati correlati all'inserimento di annunci dinamici dei contenuti.

VideoContentStatus

Opzioni di stato per pubblicare o meno annunci mirati per un contenuto.

Enum
ACTIVE Verranno pubblicati annunci con targeting per contenuti.
BLOCKED Se lo stato è BLOCCATO, non verranno pubblicati annunci in questi contenuti.
DELETED I contenuti verranno archiviati in Ad Manager. Se Ad Manager riceve una richiesta di annuncio per un contenuto contrassegnato come ELIMINATO, è comunque possibile pubblicare annunci autopromozionali o annunci indirizzati a unità di inventario o altri criteri di targeting. Per bloccare gli annunci, imposta lo stato su BLOCCATO.

VideoContentSyndicationInfo

I metadati per specificare le relazioni tra contenuti canonici e contenuti in syndication.

Campi
Campo unione syndication. VideoContentSyndicationMetadata può contenere solo uno dei seguenti valori. syndication può essere solo uno dei seguenti tipi:
canonical_video_content

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 emittente dei contenuti che contengono questo campo.
syndicated_video_content_names

SyndicatedVideoContentNames

Una raccolta di contenuti distribuiti in syndication

VideoFormat

I formati in cui possono essere codificati i contenuti video.

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

VideoIngestUrlInfo

Metadati che specificano il link al file m3u8 utilizzato per condizionare e generare playlist.

Campi
video_format

VideoFormat

Il formato del video.
video_preconditioned

VideoPreconditioned

Per indicare se i contenuti sono già condizionati per gli annunci mid-roll, il che significa che i segmenti sono già divisi al momento delle interruzioni pubblicitarie.
url

string

Il link al file m3u8.

VideoPreconditioned

Lo stato di condizionamento dei contenuti video.

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