Method: lookupByExternalId

Recupera tutte le entità per ID esterno elencato nella richiesta.

  • Restituisce il codice di errore NOT_FOUND se alcuni ID non corrispondono a una risorsa.
  • Restituisce il codice di errore FAILED_PRECONDITION se vengono trovate più entità con lo stesso ID esterno.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "lineExternalIds": [
    string
  ],
  "orderExternalIds": [
    string
  ],
  "productExternalIds": [
    string
  ],
  "adUnitExternalIds": [
    string
  ],
  "creativeAssetsExternalIds": [
    string
  ],
  "assignmentsExternalIds": [
    string
  ]
}
Campi
lineExternalIds[]

string

ID esterni per i quali recuperare i nomi dalla tabella Linee.
orderExternalIds[]

string

Gli ID esterni per i quali recuperare i nomi dalla tabella Orders.
productExternalIds[]

string

Gli ID esterni per il recupero dei nomi dalla tabella Products.
adUnitExternalIds[]

string

Gli ID esterni per i quali recuperare i nomi dalla tabella delle unità pubblicitarie.
creativeAssetsExternalIds[]

string

Gli ID esterni per il recupero dei nomi dalla tabella CreativeAsset.
assignmentsExternalIds[]

string

ID esterni per i quali recuperare i nomi dalla tabella Compiti.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "lines": {
    string: string,
    ...
  },
  "orders": {
    string: string,
    ...
  },
  "products": {
    string: string,
    ...
  },
  "adUnits": {
    string: string,
    ...
  },
  "creativeAssets": {
    string: string,
    ...
  },
  "assignments": {
    string: string,
    ...
  }
}
Campi
lines

map (key: string, value: string)

Mappa di ID esterni ai nomi delle linee.

Un oggetto contenente un elenco di "key": value coppie. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
orders

map (key: string, value: string)

Mappa degli ID esterni ai nomi degli ordini.

Un oggetto contenente un elenco di "key": value coppie. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
products

map (key: string, value: string)

Mappa degli ID esterni ai nomi dei prodotti.

Un oggetto contenente un elenco di "key": value coppie. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
adUnits

map (key: string, value: string)

Mappa degli ID esterni ai nomi delle unità pubblicitarie.

Un oggetto contenente un elenco di "key": value coppie. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
creativeAssets

map (key: string, value: string)

Mappa degli ID esterni ai nomi degli asset della creatività.

Un oggetto contenente un elenco di "key": value coppie. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
assignments

map (key: string, value: string)

Mappa degli ID esterni ai nomi dei compiti.

Un oggetto contenente un elenco di "key": value coppie. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.