Method: lookupByExternalId

リクエストにリストされた外部 ID ですべてのエンティティを取得します。

  • ID がアセットと一致しない場合、エラーコード NOT_FOUND を返します。
  • 同じ外部 ID を持つエンティティが複数見つかった場合は、エラーコード FAILED_PRECONDITION を返します。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "lineExternalIds": [
    string
  ],
  "orderExternalIds": [
    string
  ],
  "productExternalIds": [
    string
  ],
  "adUnitExternalIds": [
    string
  ],
  "creativeAssetsExternalIds": [
    string
  ],
  "assignmentsExternalIds": [
    string
  ]
}
フィールド
lineExternalIds[]

string

Lines テーブルから名前を取得する外部 ID。
orderExternalIds[]

string

Orders テーブルから名前を取得する外部 ID。
productExternalIds[]

string

Products テーブルから名前をフェッチする外部 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 の概要をご覧ください。