Method: lookupByExternalId

Ruft alle Entitäten anhand der in der Anfrage aufgeführten externen ID ab.

  • Gibt den Fehlercode NOT_FOUND zurück, wenn eine ID mit keinem Asset übereinstimmt.
  • Gibt den Fehlercode FAILED_PRECONDITION zurück, wenn mehrere Entitäten mit derselben externen ID gefunden werden.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "lineExternalIds": [
    string
  ],
  "orderExternalIds": [
    string
  ],
  "productExternalIds": [
    string
  ],
  "adUnitExternalIds": [
    string
  ],
  "creativeAssetsExternalIds": [
    string
  ],
  "assignmentsExternalIds": [
    string
  ]
}
Felder
lineExternalIds[]

string

Die externen IDs, für die Namen aus der Tabelle „Lines“ abgerufen werden sollen.
orderExternalIds[]

string

Die externen IDs, für die Namen aus der Tabelle „Orders“ abgerufen werden sollen.
productExternalIds[]

string

Die externen IDs, für die Namen aus der Tabelle „Produkte“ abgerufen werden sollen.
adUnitExternalIds[]

string

Die externen IDs, für die Namen aus der Tabelle „Anzeigenblöcke“ abgerufen werden sollen.
creativeAssetsExternalIds[]

string

Die externen IDs, für die Namen aus der CreativeAsset-Tabelle abgerufen werden sollen
assignmentsExternalIds[]

string

Die externen IDs, für die Namen aus der Tabelle „Aufgaben“ abgerufen werden sollen.

Antworttext

Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:

JSON-Darstellung 
{
  "lines": {
    string: string,
    ...
  },
  "orders": {
    string: string,
    ...
  },
  "products": {
    string: string,
    ...
  },
  "adUnits": {
    string: string,
    ...
  },
  "creativeAssets": {
    string: string,
    ...
  },
  "assignments": {
    string: string,
    ...
  }
}
Felder
lines

map (key: string, value: string)

Zuordnung externer IDs zu Zeilennamen.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
orders

map (key: string, value: string)

Zuordnung externer IDs zu Auftragsnamen.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
products

map (key: string, value: string)

Zuordnung externer IDs zu Produktnamen.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
adUnits

map (key: string, value: string)

Zuordnung externer IDs zu Anzeigenblocknamen.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
creativeAssets

map (key: string, value: string)

Zuordnung externer IDs zu Creative-Asset-Namen.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
assignments

map (key: string, value: string)

Zuordnung externer IDs zu Zuweisungsnamen.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.