Package google.ads.dai.v1

Índice

PartnerDiscoveryService

Gerencia a transferência de criativos para o DAI e o envio deles ao YouTube.

CreateCreative

rpc CreateCreative(CreateCreativeRequest) returns (Operation)

Cria um criativo. Retorna um criativo no campo response quando ele é concluído ou um google.rpc.Code em caso de falha. Retorna CreateCreativeOperationMetadata, incluindo o status de transferência no campo metadata.
DeleteCreative

rpc DeleteCreative(DeleteCreativeRequest) returns (Empty)

Exclui um criativo.
GetCreative

rpc GetCreative(GetCreativeRequest) returns (Creative)

Recebe um criativo.

CreateCreativeOperationMetadata

Metadados da operação de longa duração retornada por CreateCreative. Apresente como metadata.

Campos
creative_url

string

O URL do criativo usado para transferência. É o URL de mezzanine ou de renderização de mídia selecionado, escolhido com base nas propriedades fornecidas na solicitação.
gv_registry_id

string

Um identificador exclusivo do criativo de vídeo, se a transferência for bem-sucedida. O nome do recurso de criativo é creatives/gv_registry_id.
create_time

Timestamp

Hora em que a solicitação de transferência foi criada.
youtube_status

IngestionStatus

Status atual de transferência para o YouTube.

CreateCreativeRequest

Solicitação de PartnerDiscoveryService.CreateCreative.

Campos
creative

Creative

O criativo a ser transferido.
dynamic_creative_info

DynamicCreativeInfo

Informações sobre o criativo dinâmico. Obrigatório se o criativo a ser transferido for dinâmico.

Criativo

Um recurso de criativo. Apresente como response após a conclusão de PartnerDiscoveryService.CreateCreative.

Campos
name

string

Apenas saída. O nome exclusivo (ID do vídeo do Google) do recurso de criativo, no formato creatives/id.
advertiser

string

O nome do anunciante que aparece neste criativo.
ad_system

string

Obrigatório. O nome do sistema de anúncios que gerou a solicitação de transferência.
ad_title

string

O título do anúncio.
ad_description

string

A descrição do anúncio.
mezzanines[]

MediaFile

Os URLs de arquivos mezzanine do anúncio e as propriedades deles. É necessário incluir pelo menos um dos seguintes campos: mezannines ou media_files.
media_files[]

MediaFile

Os URLs dos arquivos de mídia do anúncio e as propriedades deles. É necessário incluir pelo menos um dos seguintes campos: mezannines ou media_files.
network_code

string

Opcional. O código de rede do Google Ad Manager do publisher para quem o criativo é destinado. Obrigatório se o criativo for dinâmico e tiver o DynamicCreativeInfo preenchido no CreateCreativeRequest.

DeleteCreativeRequest

Solicitação de PartnerDiscoveryService.DeleteCreative.

Campos
name

string

O ID do vídeo do Google do criativo a ser excluído.

DynamicCreativeInfo

Informações necessárias para que um criativo dinâmico realize o processamento de VCL.

Campos
dynamic_group_id

string

Um ID que representa o anúncio em vídeo principal do criativo. Todos os criativos dinâmicos com o mesmo ID de grupo dinâmico podem ser considerados como tendo o mesmo conteúdo, mas com aspectos dinâmicos diferentes.
active_duration

Duration

A duração em que esse criativo é considerado ativo e em uso. Após esse período, o criativo será programado para exclusão no repositório de criativos de vídeo. A duração será limitada a 180 dias. Se esse campo não for especificado, será aplicado um período de duração padrão de 30 dias.

FailureReason

Motivo da falha na transferência do criativo.

Campos
reason

Reason

Descrição da falha de transferência do criativo.
code

int32

Código de status HTTP de falha se o motivo for DOWNLOAD_ERROR.

Motivo

Possíveis motivos para a falha na transferência de criativos.

Enums
REASON_UNSPECIFIED Valor padrão.
DOWNLOAD_ERROR Falha no download HTTP.
INTERNAL_ERROR Erro interno.
INVALID_MEDIA Mídia inválida.

GetCreativeRequest

Solicitação de PartnerDiscoveryService.GetCreative.

Campos
name

string

O ID do vídeo do Google do criativo.

IngestionStatus

O status de transferência da solicitação "Criar criativo".

Campos
state

State

O estado de transferência atual de um criativo em vídeo.
failure_reason

FailureReason

O motivo da falha na transferência do criativo.
update_time

Timestamp

A hora em que o job de transferência foi atualizado pela última vez.

Estado

Estado de transferência.

Enums
STATE_UNSPECIFIED Valor padrão.
PROCESSING O criativo de vídeo ainda está sendo processado.
SUCCESS O processamento do criativo de vídeo foi concluído.
FAILURE Não foi possível transferir o criativo de vídeo. Consulte "FailureReason".

MediaFile

As propriedades relacionadas a um determinado arquivo de mídia.

Campos
uri

string

Obrigatório. O URL exclusivo do arquivo de mídia do criativo.
delivery

Delivery

Obrigatório. É o tipo de entrega do criativo.
height

int32

A altura nativa do arquivo de vídeo, em pixels.
width

int32

A largura nativa do arquivo de vídeo, em pixels.
mime_type

string

Obrigatório. O tipo MIME do contêiner de arquivos. Os tipos MIME mais usados incluem "video/x-flv" para vídeo em Flash e "video/mp4" para MP4.
min_bitrate

int32

A taxa de bits mínima do arquivo de mídia. Para vídeos de carregamento progressivo, esse valor precisa ser a taxa de bits média.
max_bitrate

int32

A taxa de bits máxima do arquivo de mídia. Para vídeos de carregamento progressivo, esse valor precisa ser a taxa de bits média.

Entrega

Tipos de entrega.

Enums
DELIVERY_UNSPECIFIED Valor de envio padrão.
DELIVERY_PROGRESSIVE Entrega progressiva de vídeo.
DELIVERY_STREAMING Envio de streaming de vídeo.