Method: lookupByExternalId

Recupera todas as entidades pelo ID externo listado na solicitação.

  • Retorna o código de erro NOT_FOUND se algum dos IDs não corresponder a um recurso.
  • Retorna o código de erro FAILED_PRECONDITION se várias entidades com o mesmo ID externo forem encontradas.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "lineExternalIds": [
    string
  ],
  "orderExternalIds": [
    string
  ],
  "productExternalIds": [
    string
  ],
  "adUnitExternalIds": [
    string
  ],
  "creativeAssetsExternalIds": [
    string
  ],
  "assignmentsExternalIds": [
    string
  ]
}
Campos
lineExternalIds[]

string

Os IDs externos para os quais buscar nomes na tabela de linhas.
orderExternalIds[]

string

Os IDs externos para os quais buscar nomes na tabela Orders.
productExternalIds[]

string

Os IDs externos para buscar nomes na tabela "Produtos".
adUnitExternalIds[]

string

Os IDs externos para buscar nomes na tabela de blocos de anúncios.
creativeAssetsExternalIds[]

string

Os IDs externos para buscar nomes na tabela CreativeAsset.
assignmentsExternalIds[]

string

Os IDs externos para buscar nomes na tabela de atribuições.

Corpo da resposta

Se bem-sucedido, o corpo da resposta exibirá os dados com a seguinte estrutura:

Representação JSON 
{
  "lines": {
    string: string,
    ...
  },
  "orders": {
    string: string,
    ...
  },
  "products": {
    string: string,
    ...
  },
  "adUnits": {
    string: string,
    ...
  },
  "creativeAssets": {
    string: string,
    ...
  },
  "assignments": {
    string: string,
    ...
  }
}
Campos
lines

map (key: string, value: string)

Mapa de IDs externos para nomes de linha.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
orders

map (key: string, value: string)

Mapa de IDs externos para nomes de pedidos.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
products

map (key: string, value: string)

Mapa de IDs externos para nomes de produtos.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
adUnits

map (key: string, value: string)

Mapa de IDs externos para nomes de blocos de anúncios.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
creativeAssets

map (key: string, value: string)

Mapa de IDs externos para nomes de recursos de criativo.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
assignments

map (key: string, value: string)

Mapa de IDs externos para nomes de atribuições.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.