Package google.ads.dai.v1

Index

PartnerDiscoveryService

Gère l'ingestion de contenus display in-app et l'importation de créations sur YouTube.

CreateCreative

rpc CreateCreative(CreateCreativeRequest) returns (Operation)

Crée une création. Renvoie une création dans le champ response à l'issue de l'opération ou un google.rpc.Code en cas d'échec. Renvoie CreateCreativeOperationMetadata, y compris l'état de l'ingestion dans le champ metadata.
DeleteCreative

rpc DeleteCreative(DeleteCreativeRequest) returns (Empty)

Supprime une création.
GetCreative

rpc GetCreative(GetCreativeRequest) returns (Creative)

Permet d'obtenir une création.

CreateCreativeOperationMetadata

Métadonnées de l'opération de longue durée renvoyées par CreateCreative. Présentez-vous en tant que metadata.

Champs
creative_url

string

URL de la création utilisée pour l'ingestion. Il s'agit de l'URL de mezzanine ou de l'URL de la version multimédia sélectionnée, choisie en fonction des propriétés fournies dans la requête.
gv_registry_id

string

Identifiant unique de la création vidéo, si l'ingestion aboutit. Le nom de la ressource de création est creatives/gv_registry_id.
create_time

Timestamp

Heure à laquelle la requête d'ingestion a été créée.
youtube_status

IngestionStatus

État actuel de l'ingestion YouTube.

CreateCreativeRequest

Demande de PartnerDiscoveryService.CreateCreative.

Champs
creative

Creative

La création à insérer.
dynamic_creative_info

DynamicCreativeInfo

Informations sur la création dynamique. Obligatoire si la création à insérer est dynamique.

Création

Une ressource de création. Présenter en tant que response à la fin de PartnerDiscoveryService.CreateCreative.

Champs
name

string

Uniquement en sortie. Nom unique (ID vidéo Google) de la ressource "Création", au format "creatives/id".
advertiser

string

Nom de l'annonceur présenté dans cette création.
ad_system

string

Obligatoire. Nom du système publicitaire générant la requête d'ingestion.
ad_title

string

Titre de l'annonce.
ad_description

string

Description de l'annonce.
mezzanines[]

MediaFile

URL des fichiers mezzanine de l'annonce et leurs propriétés Vous devez indiquer au moins l'un des éléments suivants : "mezzanines" ou "media_files".
media_files[]

MediaFile

URL des fichiers multimédias de l'annonce et leurs propriétés Vous devez indiquer au moins l'un des éléments suivants : "mezzanines" ou "media_files".
network_code

string

Facultatif. Code de réseau Google Ad Manager de l'éditeur pour lequel la création est destinée. Obligatoire si la création est dynamique et que DynamicCreativeInfo est renseigné dans CreateCreativeRequest.

DeleteCreativeRequest

Demande de PartnerDiscoveryService.DeleteCreative.

Champs
name

string

ID vidéo Google de la création à supprimer.

DynamicCreativeInfo

Informations nécessaires à une création dynamique pour effectuer le traitement VCL.

Champs
dynamic_group_id

string

ID représentant l'annonce vidéo principale de la création. Toutes les créations dynamiques du même ID de groupe dynamique peuvent être considérées comme ayant le même contenu, mais avec des aspects dynamiques différents.
active_duration

Duration

Durée pendant laquelle cette création est considérée comme active et utilisée. Passé ce délai, la création sera programmée pour être supprimée du dépôt des créations vidéo. La durée est limitée à 180 jours. Si ce champ n'est pas spécifié, une durée par défaut de 30 jours est appliquée.

FailureReason

Motif de l'échec de l'ingestion de la création.

Champs
reason

Reason

Description de l'échec de l'ingestion de la création.
code

int32

Code d'état HTTP d'échec si la raison est "DOWNLOAD_ERROR".

Motif

Causes possibles de l'échec de l'ingestion de la création

Enums
REASON_UNSPECIFIED Valeur par défaut.
DOWNLOAD_ERROR Échec du téléchargement HTTP.
INTERNAL_ERROR Erreur interne.
INVALID_MEDIA Média non valide.

GetCreativeRequest

Demande de PartnerDiscoveryService.GetCreative.

Champs
name

string

ID vidéo Google de la création.

IngestionStatus

État de l'ingestion de la requête "Créer une création".

Champs
state

State

État actuel de l'ingestion d'une création vidéo.
failure_reason

FailureReason

Raison pour laquelle l'ingestion de la création a échoué, le cas échéant.
update_time

Timestamp

Heure de la dernière mise à jour de la tâche d'ingestion.

État

État de l'ingestion.

Enums
STATE_UNSPECIFIED Valeur par défaut.
PROCESSING La création vidéo est toujours en cours de traitement.
SUCCESS Le traitement de la création vidéo a bien été effectué.
FAILURE L'ingestion de la création vidéo a échoué. Consultez FailureReason.

MediaFile

Propriétés associées à un fichier multimédia donné.

Champs
uri

string

Obligatoire. URL unique du fichier multimédia de la création.
delivery

Delivery

Obligatoire. Type de diffusion de la création.
height

int32

Hauteur native du fichier vidéo, en pixels.
width

int32

Largeur native du fichier vidéo, en pixels.
mime_type

string

Obligatoire. Type MIME du conteneur de fichiers. Les types MIME courants incluent "video/x-flv" pour Flash Video et "video/mp4" pour MP4.
min_bitrate

int32

Débit minimal du fichier multimédia. Pour les vidéos en chargement progressif, cette valeur doit correspondre au débit moyen.
max_bitrate

int32

Débit maximal du fichier multimédia. Pour les vidéos en chargement progressif, cette valeur doit correspondre au débit moyen.

Envoi

Types de diffusion.

Enums
DELIVERY_UNSPECIFIED Valeur de diffusion par défaut.
DELIVERY_PROGRESSIVE Diffusion vidéo progressive
DELIVERY_STREAMING Diffusion de vidéos en streaming