Package google.ads.dai.v1

Indeks

PartnerDiscoveryService

Zarządza przetwarzaniem danych z Dynamicznego wstawiania reklam i przesyłaniem kreacji do YouTube.

CreateCreative

rpc CreateCreative(CreateCreativeRequest) returns (Operation)

Tworzy kreację. W polu response zwraca wartość Kreacja, jeśli operacja zakończyła się pomyślnie, lub wartość google.rpc.Code w przypadku niepowodzenia. Zwraca metadane operacji tworzenia kreacji, w tym stan przetwarzania w polu metadata.
DeleteCreative

rpc DeleteCreative(DeleteCreativeRequest) returns (Empty)

Usuwa kreację.
GetCreative

rpc GetCreative(GetCreativeRequest) returns (Creative)

Otrzymuje kreację.

CreateCreativeOperationMetadata

Metadane długotrwałej operacji zwróconej przez CreateCreative. Prezentuj jako metadata.

Pola
creative_url

string

Adres URL kreacji, która została użyta do przetworzenia. Jest to wybrany URL mezzanine lub URL wersji multimediów, który został wybrany na podstawie właściwości podanych w żądaniu.
gv_registry_id

string

Unikalny identyfikator kreacji wideo, jeśli przetworzenie było udane. Nazwa zasobu Kreacja to creatives/gv_registry_id.
create_time

Timestamp

Czas utworzenia żądania przetworzenia.
youtube_status

IngestionStatus

Bieżący stan przetwarzania w YouTube.

CreateCreativeRequest

Prośba o PartnerDiscoveryService.CreateCreative.

Pola
creative

Creative

Kreacja do przetworzenia.
dynamic_creative_info

DynamicCreativeInfo

Informacje o kreacji dynamicznej. Wymagane, jeśli przetwarzana kreacja jest dynamiczna.

Kreacja

Zasób kreacji. Po zakończeniu PartnerDiscoveryService.CreateCreative prezentuj się jako response.

Pola
name

string

Tylko dane wyjściowe. Unikalna nazwa (identyfikator Google Video) zasobu Kreacja w formacie kreacje/id.
advertiser

string

Nazwa reklamodawcy występująca w tej kreacji.
ad_system

string

Wymagany. Nazwa systemu reklamowego, który generuje żądanie przetwarzania.
ad_title

string

Tytuł reklamy.
ad_description

string

Opis reklamy.
mezzanines[]

MediaFile

Adresy URL plików mezzanine reklamy i ich właściwości. Wymagane jest co najmniej jedno z pól mezannines lub media_files.
media_files[]

MediaFile

Adresy URL plików multimedialnych reklamy i ich właściwości. Wymagane jest co najmniej jedno z pól mezannines lub media_files.
network_code

string

Opcjonalnie: Kod sieci Google Ad Managera wydawcy, dla którego przeznaczona jest kreacja. Wymagany, jeśli kreacja jest dynamiczna i jeśli w pytaniu CreateCreativeRequest jest wypełnione pole DynamicCreativeInfo.

DeleteCreativeRequest

Prośba o PartnerDiscoveryService.DeleteCreative.

Pola
name

string

Identyfikator Google Video kreacji, który ma zostać usunięty.

DynamicCreativeInfo

Informacje niezbędne do przetwarzania VCL przez kreację dynamicznym.

Pola
dynamic_group_id

string

Identyfikator, który reprezentuje główną reklamę wideo kreacji. Wszystkie kreacje dynamiczne z tym samym identyfikatorem grupy dynamicznej można uznać za takie, które mają ten sam treść, ale różnią się od siebie pod względem aspektów dynamicznych.
active_duration

Duration

Czas, przez jaki ta kreacja jest aktywna i używana. Po tym czasie kreacja zostanie zaplanowana do usunięcia z repozytorium kreacji wideo. Czas trwania będzie ograniczony do 180 dni. Jeśli to pole nie zostanie określone, zostanie zastosowany domyślny czas trwania wynoszący 30 dni.

FailureReason

przyczyna niepowodzenia przetwarzania kreacji;

Pola
reason

Reason

Opis błędu podczas przetwarzania kreacji
code

int32

Kod stanu HTTP niepowodzenia, jeśli przyczyną jest DOWNLOAD_ERROR.

Przyczyna

Możliwe przyczyny niepowodzenia przetwarzania kreacji.

Wartości w polu enum
REASON_UNSPECIFIED Wartość domyślna.
DOWNLOAD_ERROR Nie udało się pobrać za pomocą protokołu HTTP.
INTERNAL_ERROR Błąd wewnętrzny.
INVALID_MEDIA Nieprawidłowe multimedia.

GetCreativeRequest

Prośba o PartnerDiscoveryService.GetCreative.

Pola
name

string

Identyfikator Google Video kreacji.

IngestionStatus

Stan przetwarzania żądania dotyczącego utworzenia kreacji.

Pola
state

State

Aktualny stan przetwarzania kreacji wideo.
failure_reason

FailureReason

Powód, dla którego nie udało się przetworzyć kreacji.
update_time

Timestamp

Czas ostatniej aktualizacji zadania pozyskiwania danych.

Stan

Stan przetwarzania.

Wartości w polu enum
STATE_UNSPECIFIED Wartość domyślna.
PROCESSING Kreacja wideo jest nadal przetwarzana.
SUCCESS Przetwarzanie kreacji wideo zostało zakończone.
FAILURE Nie udało się przetworzyć kreacji wideo, patrz FailureReason.

MediaFile

Właściwości powiązane z danym plikiem multimedialnym.

Pola
uri

string

Wymagany. Unikalny adres URL pliku multimedialnego kreacji.
delivery

Delivery

Wymagany. Typ wyświetlania kreacji.
height

int32

Natywowa wysokość pliku wideo w pikselach.
width

int32

Natywowa szerokość pliku wideo w pikselach.
mime_type

string

Wymagany. Typ MIME kontenera pliku. Popularne typy MIME to „video/x-flv” w przypadku filmów Flash i „video/mp4” w przypadku formatu MP4.
min_bitrate

int32

Minimalna szybkość transmisji bitów pliku multimedialnego. W przypadku wideo z progresywnym wczytywaniem ta wartość powinna odpowiadać średniemu bitrate’owi.
max_bitrate

int32

Maksymalna szybkość transmisji bitów pliku multimedialnego. W przypadku wideo z ładowaniem progresywnym ta wartość powinna odpowiadać średniemu bitrate’owi.

Dostawa

Typy wyświetlania.

Wartości w polu enum
DELIVERY_UNSPECIFIED Domyślna wartość dostawy.
DELIVERY_PROGRESSIVE Wyświetlanie progresywne.
DELIVERY_STREAMING Strumieniowa transmisja wideo.