Method: lookupByExternalId

Récupère toutes les entités par identifiant externe répertorié dans la requête.

  • Affiche le code d'erreur NOT_FOUND si des ID ne correspondent pas à un élément.
  • Renvoie le code d'erreur FAILED_PRECONDITION si plusieurs entités possédant le même ID externe sont détectées.

Requête HTTP

POST https://dv360outofhomeseller.googleapis.com/v1beta1:lookupByExternalId

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 
{
  "lineExternalIds": [
    string
  ],
  "orderExternalIds": [
    string
  ],
  "productExternalIds": [
    string
  ],
  "adUnitExternalIds": [
    string
  ],
  "creativeAssetsExternalIds": [
    string
  ],
  "assignmentsExternalIds": [
    string
  ]
}
Champs
lineExternalIds[]

string

ID externes dont les noms doivent être récupérés dans la table Lignes.
orderExternalIds[]

string

ID externes dont les noms doivent être récupérés dans le tableau des commandes.
productExternalIds[]

string

ID externes dont les noms doivent être récupérés dans le tableau des produits.
adUnitExternalIds[]

string

ID externes dont les noms doivent être récupérés dans le tableau AdUnits.
creativeAssetsExternalIds[]

string

ID externes dont les noms doivent être récupérés dans le tableau CreativeAsset
assignmentsExternalIds[]

string

ID externes dont les noms doivent être récupérés dans le tableau "Assignments" (Devoirs).

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient des données présentant la structure suivante :

Représentation JSON 
{
  "lines": {
    string: string,
    ...
  },
  "orders": {
    string: string,
    ...
  },
  "products": {
    string: string,
    ...
  },
  "adUnits": {
    string: string,
    ...
  },
  "creativeAssets": {
    string: string,
    ...
  },
  "assignments": {
    string: string,
    ...
  }
}
Champs
lines

map (key: string, value: string)

Mappage des ID externes avec les noms de ligne.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.
orders

map (key: string, value: string)

Mappage des ID externes vers les noms des commandes.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.
products

map (key: string, value: string)

Mappage des ID externes avec les noms de produits.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.
adUnits

map (key: string, value: string)

Mise en correspondance des ID externes avec les noms des blocs d'annonces

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.
creativeAssets

map (key: string, value: string)

Mappage des ID externes avec les noms des assets de création.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.
assignments

map (key: string, value: string)

Mappage des ID externes avec les noms des attributions.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

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.