Method: adPlays.createWithExternalIds

외부 ID를 사용하여 광고 재생을 만듭니다.

  • 성공하면 새로 만든 광고 재생을 반환합니다.
  • 잘못된 광고 단위 외부 ID, 주문 외부 ID, 행 외부 ID 또는 광고 소재 애셋 외부 ID가 지정된 경우 오류 코드 INVALID_ARGUMENT를 반환합니다.
  • 같은 startTime을 가진 동일한 광고 단위, 주문, 광고 행 및 광고 소재에 대한 광고 재생이 이미 존재하는 경우 오류 코드 INVALID_ARGUMENT를 반환합니다.
  • 일치하는 광고 단위 외부 ID, 주문 외부 ID, 행 외부 ID 또는 광고 소재 애셋 외부 ID를 찾을 수 없는 경우 오류 코드 NOT_FOUND를 반환합니다.

HTTP 요청

POST https://dv360outofhomeseller.googleapis.com/v1beta1/adPlays:createWithExternalIds

URL은 gRPC 트랜스코딩 구문을 사용합니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "lineExternalId": string,
  "orderExternalId": string,
  "adUnitExternalId": string,
  "creativeAssetExternalId": string,
  "startTime": string,
  "endTime": string,
  "recordTime": string,
  "impressions": number
}
필드
lineExternalId

string

필수 항목입니다. 이 광고가 속한 줄의 외부 ID입니다. 형식: 123
orderExternalId

string

필수 항목입니다. 이 광고 재생이 속한 주문의 외부 ID입니다. 형식: 456
adUnitExternalId

string

필수 항목입니다. 이 광고 재생이 게재된 광고 단위의 외부 ID입니다. 형식: 789
creativeAssetExternalId

string

필수 항목입니다. 이 광고에서 게재하는 광고 소재의 외부 ID입니다. 형식: 3210
startTime

string (Timestamp format)

필수 항목입니다. 광고 재생이 시작된 시간입니다 (해당 시간 포함). 과거의 과거여야 하며 지난 3일 이내여야 합니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
endTime

string (Timestamp format)

필수 항목입니다. 광고 재생이 종료된 시간입니다 (제외). 시작 시간 이후여야 합니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
recordTime

string (Timestamp format)

선택사항입니다. 이 광고 재생이 기록된 시간입니다. 종료 시간 이후여야 합니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
impressions

number

필수 항목입니다. 총 노출수입니다.

응답 본문

성공한 경우 응답 본문에 AdPlay의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 OAuth 2.0 개요를 참고하세요.