Package google.ads.dai.v1

Indice

PartnerDiscoveryService

Gestisce l'importazione DAI e il caricamento delle creatività su YouTube.

CreateCreative

rpc CreateCreative(CreateCreativeRequest) returns (Operation)

Crea una creatività. Restituisce una creatività nel campo response al termine dell'operazione o un google.rpc.Code in caso di errore. Restituisce CreateCreativeOperationMetadata, incluso lo stato dell'importazione, nel campo metadata.
DeleteCreative

rpc DeleteCreative(DeleteCreativeRequest) returns (Empty)

Consente di eliminare una creatività.
GetCreative

rpc GetCreative(GetCreativeRequest) returns (Creative)

Riceve una creatività.

CreateCreativeOperationMetadata

Metadati per l'operazione a lungo termine restituita da CreateCreative. Presenta come metadata.

Campi
creative_url

string

L'URL della creatività utilizzata per l'importazione. Si tratta dell'URL mezzanine o dell'URL di rappresentazione multimediale selezionato, scelto in base alle proprietà fornite nella richiesta.
gv_registry_id

string

Un identificatore univoco per la creatività video, se l'importazione è riuscita. Il nome della risorsa Creative è creatives/gv_registry_id.
create_time

Timestamp

Ora in cui è stata creata la richiesta di importazione.
youtube_status

IngestionStatus

Stato attuale dell'importazione su YouTube.

CreateCreativeRequest

Richiesta per PartnerDiscoveryService.CreateCreative.

Campi
creative

Creative

La creatività da importare.
dynamic_creative_info

DynamicCreativeInfo

Informazioni sulla creatività dinamica. Obbligatorio se la creatività da importare è dinamica.

Creatività

Una risorsa creativa. Presentati come response al termine di PartnerDiscoveryService.CreateCreative.

Campi
name

string

Solo output. Il nome univoco (ID video di Google) della risorsa Creatività, nel formato creatives/id.
advertiser

string

Il nome dell'inserzionista presente in questa creatività.
ad_system

string

Obbligatorio. Il nome del sistema pubblicitario che genera la richiesta di importazione.
ad_title

string

Il titolo della pubblicità.
ad_description

string

La descrizione dell'annuncio.
mezzanines[]

MediaFile

Gli URL dei file mezzanine dell'annuncio e le relative proprietà. È obbligatorio specificare almeno uno tra mezannines o media_files.
media_files[]

MediaFile

Gli URL dei file multimediali dell'annuncio e le relative proprietà. È obbligatorio specificare almeno uno tra mezannines o media_files.
network_code

string

Facoltativo. Il codice di rete Google Ad Manager del publisher per cui è destinata la creatività. Obbligatorio se la creatività è dinamica e DynamicCreativeInfo è compilato in CreateCreativeRequest.

DeleteCreativeRequest

Richiesta per PartnerDiscoveryService.DeleteCreative.

Campi
name

string

L'ID video di Google della creatività da eliminare.

DynamicCreativeInfo

Informazioni necessarie per consentire a una creatività dinamica di eseguire l'elaborazione VCL.

Campi
dynamic_group_id

string

Un ID che rappresenta l'annuncio video principale della creatività. Tutte le creatività dinamiche nello stesso ID gruppo dinamico possono essere considerate come aventi gli stessi contenuti, ma con aspetti dinamici diversi.
active_duration

Duration

La durata per la quale questa creatività è considerata attiva e in uso. Dopo questo periodo, la creatività verrà pianificata per l'eliminazione nel repository delle creatività video. La durata massima sarà di 180 giorni. Se questo campo non viene specificato, verrà applicata una durata predefinita di 30 giorni.

FailureReason

Motivo dell'errore di importazione della creatività.

Campi
reason

Reason

Descrizione dell'errore di importazione della creatività.
code

int32

Codice di stato HTTP dell'errore se il motivo è DOWNLOAD_ERROR.

Motivo

Possibili motivi dell'errore di importazione delle creatività.

Enum
REASON_UNSPECIFIED Valore predefinito.
DOWNLOAD_ERROR Download HTTP non riuscito.
INTERNAL_ERROR Errore interno.
INVALID_MEDIA Contenuti multimediali non validi.

GetCreativeRequest

Richiesta per PartnerDiscoveryService.GetCreative.

Campi
name

string

L'ID video Google della creatività.

IngestionStatus

Lo stato di importazione della richiesta Crea creatività.

Campi
state

State

Lo stato attuale dell'importazione di una creatività video.
failure_reason

FailureReason

Il motivo dell'importazione non riuscita della creatività, se l'importazione non va a buon fine.
update_time

Timestamp

L'ora dell'ultimo aggiornamento del job di importazione.

Stato

Stato importazione.

Enum
STATE_UNSPECIFIED Valore predefinito.
PROCESSING L'elaborazione della creatività video è ancora in corso.
SUCCESS L'elaborazione della creatività video è stata completata correttamente.
FAILURE Impossibile importare la creatività video. Consulta FailureReason.

MediaFile

Le proprietà relative a un determinato file multimediale.

Campi
uri

string

Obbligatorio. L'URL univoco del file multimediale della creatività.
delivery

Delivery

Obbligatorio. Il tipo di pubblicazione della creatività.
height

int32

L'altezza nativa del file video, in pixel.
width

int32

La larghezza nativa del file video, in pixel.
mime_type

string

Obbligatorio. Il tipo MIME del contenitore del file. I tipi MIME più diffusi sono "video/x-flv" per i video Flash e "video/mp4" per i video MP4.
min_bitrate

int32

La velocità in bit minima del file multimediale. Per i video con caricamento progressivo, questo valore deve corrispondere alla velocità in bit media.
max_bitrate

int32

La velocità in bit massima del file multimediale. Per i video con caricamento progressivo, questo valore deve corrispondere alla velocità in bit media.

Delivery

Tipi di pubblicazione.

Enum
DELIVERY_UNSPECIFIED Valore di importazione predefinito.
DELIVERY_PROGRESSIVE Pubblicazione video progressiva.
DELIVERY_STREAMING Pubblicazione di video in streaming.