Method: lookupByExternalId

Получает все объекты по внешнему идентификатору, указанному в запросе.

  • Возвращает код ошибки NOT_FOUND если какой-либо идентификатор не соответствует активу.
  • Возвращает код ошибки FAILED_PRECONDITION если обнаружено несколько объектов с одинаковым внешним идентификатором.

HTTP-запрос

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

URL-адрес использует синтаксис транскодирования gRPC .

Тело запроса

Тело запроса содержит данные следующей структуры:

JSON-представление 
{
  "lineExternalIds": [
    string
  ],
  "orderExternalIds": [
    string
  ],
  "productExternalIds": [
    string
  ],
  "adUnitExternalIds": [
    string
  ],
  "creativeAssetsExternalIds": [
    string
  ],
  "assignmentsExternalIds": [
    string
  ]
}
Поля
lineExternalIds[]

string

Внешние идентификаторы, имена которых нужно получить из таблицы Lines.

orderExternalIds[]

string

Внешние идентификаторы, имена которых нужно получить из таблицы Orders.

productExternalIds[]

string

Внешние идентификаторы, имена которых нужно получить из таблицы Products.

adUnitExternalIds[]

string

Внешние идентификаторы, имена которых нужно получить из таблицы AdUnits.

creativeAssetsExternalIds[]

string

Внешние идентификаторы, имена которых нужно получить из таблицы CreativeAsset.

assignmentsExternalIds[]

string

Внешние идентификаторы, имена которых нужно получить из таблицы «Назначения».

Тело ответа

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление 
{
  "lines": {
    string: string,
    ...
  },
  "orders": {
    string: string,
    ...
  },
  "products": {
    string: string,
    ...
  },
  "adUnits": {
    string: string,
    ...
  },
  "creativeAssets": {
    string: string,
    ...
  },
  "assignments": {
    string: string,
    ...
  }
}
Поля
lines

map (key: string, value: string)

Сопоставление внешних идентификаторов с названиями строк.

Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

orders

map (key: string, value: string)

Карта внешних идентификаторов для заказа имен.

Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

products

map (key: string, value: string)

Сопоставление внешних идентификаторов с названиями продуктов.

Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

adUnits

map (key: string, value: string)

Сопоставление внешних идентификаторов с названиями рекламных блоков.

Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

creativeAssets

map (key: string, value: string)

Сопоставление внешних идентификаторов с названиями креативных ресурсов.

Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

assignments

map (key: string, value: string)

Сопоставление внешних идентификаторов с именами назначений.

Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

Области авторизации

Требуется следующая область действия OAuth:

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

Дополнительную информацию см. в обзоре OAuth 2.0 .