Method: adPlays.createWithExternalIds

Crée un jeu d'annonce avec des ID externes.

  • Si l'opération réussit, renvoie la nouvelle lecture de l'annonce.
  • Renvoie le code d'erreur INVALID_ARGUMENT si un ID externe de bloc d'annonces, un ID externe de campagne, un ID externe de ligne ou un ID externe d'asset de création non valide sont spécifiés.
  • Renvoie le code d'erreur INVALID_ARGUMENT si une annonce en cours de lecture existe déjà pour le même bloc d'annonces, ordre, ligne et création avec la même heure de début.
  • Renvoie le code d'erreur NOT_FOUND si aucun ID externe de bloc d'annonces, ID externe de campagne, ID externe de ligne ou ID externe d'asset de création n'a été trouvé.

Requête HTTP

POST https://dv360outofhomeseller.googleapis.com/v1beta1/adPlays:createWithExternalIds

L'URL utilise la syntaxe de transcodage gRPC.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "lineExternalId": string,
  "orderExternalId": string,
  "adUnitExternalId": string,
  "creativeAssetExternalId": string,
  "startTime": string,
  "endTime": string,
  "recordTime": string,
  "impressions": number
}
Champs
lineExternalId

string

Obligatoire. Identifiant externe de la ligne à laquelle cette lecture d'annonce appartient. Format : 123.
orderExternalId

string

Obligatoire. Identifiant externe de l'ordre auquel appartient cette lecture d'annonce. Format : 456.
adUnitExternalId

string

Obligatoire. Identifiant externe du bloc d'annonces sur lequel cette lecture d'annonce a été diffusée. Format : 789.
creativeAssetExternalId

string

Obligatoire. Identifiant externe de la création diffusée par cette annonce. Format : 3210.
startTime

string (Timestamp format)

Obligatoire. Heure de début de lecture de l'annonce (incluse). Cette date doit se situer dans le passé et au cours des trois derniers jours.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
endTime

string (Timestamp format)

Obligatoire. Heure de fin de la lecture de l'annonce (exclue). Elle doit être située dans le passé et postérieure à l'heure de début.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
recordTime

string (Timestamp format)

Facultatif. Heure à laquelle cette lecture d'annonce a été enregistrée. L'heure de fin doit être passée et postérieure à l'heure de fin.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
impressions

number

Obligatoire. Nombre total d'impressions.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de AdPlay.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/doubleclickbidmanager

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.