Package google.ads.dai.v1

Índice

PartnerDiscoveryService

Administra la transferencia de DAI y la carga de creatividades a YouTube.

CreateCreative

rpc CreateCreative(CreateCreativeRequest) returns (Operation)

Crea una creatividad. Muestra una creatividad en el campo response cuando se completa correctamente o un google.rpc.Code cuando falla. Muestra CreateCreativeOperationMetadata, incluido el estado de transferencia en el campo metadata.
DeleteCreative

rpc DeleteCreative(DeleteCreativeRequest) returns (Empty)

Borra una creatividad.
GetCreative

rpc GetCreative(GetCreativeRequest) returns (Creative)

Obtiene una creatividad.

CreateCreativeOperationMetadata

Metadatos de la operación de larga duración que muestra CreateCreative Presenta como metadata.

Campos
creative_url

string

Es la URL de la creatividad que se usó para la transferencia. Esta es la URL de mezzanine o de renderización de contenido multimedia seleccionada, que se eligió en función de las propiedades proporcionadas en la solicitud.
gv_registry_id

string

Es un identificador único para la creatividad de video, si la transferencia se realiza correctamente. El nombre del recurso de creatividad es creatives/gv_registry_id.
create_time

Timestamp

Hora en la que se creó la solicitud de transferencia.
youtube_status

IngestionStatus

Estado actual de transferencia a YouTube.

CreateCreativeRequest

Solicitud para PartnerDiscoveryService.CreateCreative.

Campos
creative

Creative

Es la creatividad que se transferirá.
dynamic_creative_info

DynamicCreativeInfo

Información sobre la creatividad dinámica. Obligatorio si la creatividad que se transferirá es dinámica.

Creatividad

Un recurso de creatividad. Presenta como response cuando completes PartnerDiscoveryService.CreateCreative.

Campos
name

string

Solo salida. Es el nombre único (ID de video de Google) del recurso de creatividad, en el formato creatives/id.
advertiser

string

Es el nombre del anunciante que aparece en esta creatividad.
ad_system

string

Es obligatorio. Es el nombre del sistema de anuncios que genera la solicitud de transferencia.
ad_title

string

Es el título del anuncio.
ad_description

string

Es la descripción del anuncio.
mezzanines[]

MediaFile

Las URLs de los archivos de mezzanine del anuncio y sus propiedades Se requiere al menos uno de mezannines o media_files.
media_files[]

MediaFile

Las URLs de los archivos multimedia del anuncio y sus propiedades Se requiere al menos uno de mezannines o media_files.
network_code

string

Opcional. Es el código de red de Google Ad Manager del publicador para el que se diseñó la creatividad. Es obligatorio si la creatividad es dinámica y tiene DynamicCreativeInfo propagado en CreateCreativeRequest.

DeleteCreativeRequest

Solicitud para PartnerDiscoveryService.DeleteCreative.

Campos
name

string

Es el ID de video de Google de la creatividad que se borrará.

DynamicCreativeInfo

Es la información necesaria para que una creatividad dinámica realice el procesamiento de VCL.

Campos
dynamic_group_id

string

Es un ID que representa el anuncio de video principal de la creatividad. Se puede considerar que todas las creatividades dinámicas con el mismo ID de grupo dinámico tienen el mismo contenido, pero con diferentes aspectos dinámicos.
active_duration

Duration

Es la duración durante la cual esta creatividad se considera activa y en uso. Después de este tiempo, se programará la eliminación de la creatividad en el repositorio de creatividades de video. La duración se limitará a 180 días. Si no se especifica este campo, se aplicará un tiempo de duración predeterminado de 30 días.

FailureReason

Es el motivo por el que no se pudo transferir la creatividad.

Campos
reason

Reason

Descripción del error de transferencia de creatividades.
code

int32

Código de estado HTTP de error si el motivo es DOWNLOAD_ERROR.

Motivo

Posibles motivos del error de transferencia de creatividades

Enumeraciones
REASON_UNSPECIFIED Valor predeterminado
DOWNLOAD_ERROR No se pudo completar la descarga de HTTP.
INTERNAL_ERROR Error interno.
INVALID_MEDIA El contenido multimedia no es válido.

GetCreativeRequest

Solicitud para PartnerDiscoveryService.GetCreative.

Campos
name

string

Es el ID de video de Google de la creatividad.

IngestionStatus

Es el estado de transferencia de la solicitud Create Creative.

Campos
state

State

Es el estado de transferencia actual de una creatividad de video.
failure_reason

FailureReason

El motivo por el que no se pudo transferir la creatividad, si se produce un error de transferencia.
update_time

Timestamp

Es la hora en la que se actualizó por última vez el trabajo de transferencia.

Estado

Estado de transferencia.

Enumeraciones
STATE_UNSPECIFIED Valor predeterminado
PROCESSING La creatividad de video aún se está procesando.
SUCCESS Se completó correctamente el procesamiento de la creatividad de video.
FAILURE No se pudo transferir la creatividad de video. Consulta FailureReason.

MediaFile

Son las propiedades relacionadas con un archivo multimedia determinado.

Campos
uri

string

Es obligatorio. Es la URL única del archivo multimedia de la creatividad.
delivery

Delivery

Es obligatorio. Es el tipo de publicación de la creatividad.
height

int32

Es la altura nativa del archivo de video, en píxeles.
width

int32

Es el ancho nativo del archivo de video, en píxeles.
mime_type

string

Es obligatorio. Es el tipo MIME del contenedor de archivos. Entre los tipos de MIME populares, se incluyen "video/x-flv" para Flash Video y "video/mp4" para MP4.
min_bitrate

int32

Es la tasa de bits mínima del archivo multimedia. Para los videos de carga progresiva, este valor debe ser la tasa de bits promedio.
max_bitrate

int32

Es la tasa de bits máxima del archivo multimedia. Para los videos de carga progresiva, este valor debe ser la tasa de bits promedio.

Entrega

Tipos de publicación

Enumeraciones
DELIVERY_UNSPECIFIED Es el valor de publicación predeterminado.
DELIVERY_PROGRESSIVE Entrega de video progresiva
DELIVERY_STREAMING Publicación de video en streaming