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

要從「產品」表格中擷取名稱的外部 ID。
adUnitExternalIds[]

string

要從「廣告單元」表格中擷取名稱的外部 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 總覽。