Method: lookupByExternalId

요청에 나열된 외부 ID로 모든 항목을 검색합니다.

  • 애셋과 일치하지 않는 ID가 없으면 오류 코드 NOT_FOUND를 반환합니다.
  • 외부 ID가 동일한 항목이 여러 개 있으면 오류 코드 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 테이블에서 이름을 가져올 외부 ID입니다.
orderExternalIds[]

string

주문 테이블에서 이름을 가져올 외부 ID입니다.
productExternalIds[]

string

제품 테이블에서 이름을 가져올 외부 ID입니다.
adUnitExternalIds[]

string

AdUnits 표에서 이름을 가져올 외부 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 개요를 참고하세요.