Method: lookupByExternalId

Pobiera wszystkie jednostki według identyfikatora zewnętrznego wymienionego w żądaniu.

  • Zwraca kod błędu NOT_FOUND, jeśli dowolny identyfikator nie pasuje do zasobu.
  • Zwraca kod błędu FAILED_PRECONDITION w przypadku znalezienia wielu elementów o tym samym zewnętrznym identyfikatorze.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "lineExternalIds": [
    string
  ],
  "orderExternalIds": [
    string
  ],
  "productExternalIds": [
    string
  ],
  "adUnitExternalIds": [
    string
  ],
  "creativeAssetsExternalIds": [
    string
  ],
  "assignmentsExternalIds": [
    string
  ]
}
Pola
lineExternalIds[]

string

Zewnętrzne identyfikatory do pobrania z tabeli Wiersze.
orderExternalIds[]

string

Zewnętrzne identyfikatory, dla których można pobrać nazwy z tabeli zamówień.
productExternalIds[]

string

Zewnętrzne identyfikatory do pobrania nazw z tabeli Produkty.
adUnitExternalIds[]

string

Zewnętrzne identyfikatory do pobrania z tabeli jednostek reklamowych.
creativeAssetsExternalIds[]

string

Zewnętrzne identyfikatory do pobrania z tabeli CreativeAsset.
assignmentsExternalIds[]

string

Identyfikatory zewnętrzne, których nazwy są pobierane z tabeli Projektów.

Treść odpowiedzi

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "lines": {
    string: string,
    ...
  },
  "orders": {
    string: string,
    ...
  },
  "products": {
    string: string,
    ...
  },
  "adUnits": {
    string: string,
    ...
  },
  "creativeAssets": {
    string: string,
    ...
  },
  "assignments": {
    string: string,
    ...
  }
}
Pola
lines

map (key: string, value: string)

Mapa identyfikatorów zewnętrznych na nazwy wierszy.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
orders

map (key: string, value: string)

Mapa identyfikatorów zewnętrznych na nazwy zamówień.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
products

map (key: string, value: string)

Mapa identyfikatorów zewnętrznych na nazwy usług.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
adUnits

map (key: string, value: string)

Mapa identyfikatorów zewnętrznych na nazwy jednostek reklamowych.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
creativeAssets

map (key: string, value: string)

Mapa identyfikatorów zewnętrznych na nazwy komponentów kreacji.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
assignments

map (key: string, value: string)

Mapa identyfikatorów zewnętrznych na nazwy projektów.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.