Method: lookupByExternalId

Recupera todas las entidades según el ID externo indicado en la solicitud.

  • Muestra el código de error NOT_FOUND si algún ID no coincide con un activo.
  • Muestra el código de error FAILED_PRECONDITION si se encuentran varias entidades con el mismo ID externo.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "lineExternalIds": [
    string
  ],
  "orderExternalIds": [
    string
  ],
  "productExternalIds": [
    string
  ],
  "adUnitExternalIds": [
    string
  ],
  "creativeAssetsExternalIds": [
    string
  ],
  "assignmentsExternalIds": [
    string
  ]
}
Campos
lineExternalIds[]

string

Los IDs externos para recuperar nombres de la tabla Lines.
orderExternalIds[]

string

Los IDs externos para recuperar nombres de la tabla de Pedidos.
productExternalIds[]

string

Los IDs externos para recuperar nombres de la tabla Products.
adUnitExternalIds[]

string

Son los IDs externos para recuperar nombres de la tabla AdUnits.
creativeAssetsExternalIds[]

string

Son los IDs externos para recuperar nombres de la tabla CreativeAsset.
assignmentsExternalIds[]

string

Los IDs externos para recuperar nombres de la tabla Tareas.

Cuerpo de la respuesta

Si el proceso es satisfactorio, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación 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)

Asignación de IDs externos a nombres de líneas.

Es un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
orders

map (key: string, value: string)

Mapa de IDs externos para nombres de pedidos.

Es un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
products

map (key: string, value: string)

Corresponde a una asignación de ID externos a nombres de productos.

Es un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
adUnits

map (key: string, value: string)

Asignación de IDs externos a nombres de unidades de anuncios.

Es un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
creativeAssets

map (key: string, value: string)

Corresponde a una asignación de IDs externos a nombres de recursos de creatividad.

Es un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
assignments

map (key: string, value: string)

Mapa de IDs externos para nombres de asignaciones.

Es un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Alcances de la autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta la descripción general de OAuth 2.0.