Method: lookupByExternalId

根据请求中列出的外部 ID 检索所有实体。

  • 如有任何 ID 与资产不匹配，则返回错误代码 NOT_FOUND。
  • 如果发现多个具有相同外部 ID 的实体，则返回错误代码 FAILED_PRECONDITION。

HTTP 请求

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

网址采用 gRPC 转码语法。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "lineExternalIds": [
    string
  ],
  "orderExternalIds": [
    string
  ],
  "productExternalIds": [
    string
  ],
  "adUnitExternalIds": [
    string
  ],
  "creativeAssetsExternalIds": [
    string
  ],
  "assignmentsExternalIds": [
    string
  ]
}
字段
lineExternalIds[]

string

要从 Lines 表中提取名称的外部 ID。
orderExternalIds[]

string

要从“订单”表中提取名称的外部 ID。
productExternalIds[]

string

要从“Products”表中提取名称的外部 ID。
adUnitExternalIds[]

string

要从 AdUnit 表中提取名称的外部 ID。
creativeAssetsExternalIds[]

string

要从 CreativeAsset 表中提取名称的外部 ID。
assignmentsExternalIds[]

string

要从“作业”表中提取名称的外部 ID。

响应正文

如果成功，响应正文将包含结构如下的数据：

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)

外部 ID 与行名称的映射。

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
orders

map (key: string, value: string)

外部 ID 到订单名称的映射。

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
products

map (key: string, value: string)

外部 ID 与产品名称的映射。

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
adUnits

map (key: string, value: string)

外部 ID 与广告单元名称的映射。

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
creativeAssets

map (key: string, value: string)

外部 ID 与广告素材资源名称的映射。

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
assignments

map (key: string, value: string)

外部 ID 到分配名称的映射。

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅 OAuth 2.0 概览。