Method: sellers.adPlays.batchCreate

새 광고 재생을 일괄적으로 만듭니다.

  • 배치에 허용되는 최대 광고 재생 횟수는 1,000회입니다.
  • 성공하면 새로 만든 광고 재생을 반환합니다.
  • 잘못된 광고 단위, 주문, 행 또는 광고 소재가 지정된 경우 오류 코드 INVALID_ARGUMENT을 반환합니다.
  • 같은 startTime을 가진 동일한 광고 단위, 주문, 광고 행 및 광고 소재에 대한 광고 재생이 이미 존재하는 경우 오류 코드 ALREADY_EXISTS를 반환합니다.
  • 일치하는 광고 단위, 주문, 행 또는 광고 애셋을 찾을 수 없는 경우 오류 코드 NOT_FOUND를 반환합니다.
  • 요청에 리소스 이름과 외부 ID가 모두 포함되어 있으면 오류 코드 FAILED_PRECONDITION를 반환합니다.

HTTP 요청

POST https://dv360outofhomeseller.googleapis.com/v1/{parent=sellers/*}/adPlays:batchCreate

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

경로 매개변수

매개변수
parent

string

필수 항목입니다. 판매자 리소스 이름입니다. 형식: sellers/{seller}

요청 본문

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

JSON 표현 
{
  "requests": [
    {
      object (CreateAdPlayRequest)
    }
  ]
}
필드
requests[]

object (CreateAdPlayRequest)

필수 항목입니다. 만들기 위해 광고가 재생됩니다.

배치에 허용되는 최대 광고 재생 횟수는 1,000회입니다. 시작 시간은 생성일로부터 최대 3일 전이어야 합니다. 종료 시간은 과거이고 시작 시간 이후여야 합니다.

응답 본문

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

광고 재생 일괄 생성에 대한 응답입니다.

JSON 표현 
{
  "adPlays": [
    {
      object (AdPlay)
    }
  ]
}
필드
adPlays[]

object (AdPlay)

생성된 광고 재생입니다.

승인 범위

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

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

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

CreateAdPlayRequest

AdPlayService.CreateAdPlay 요청 메시지입니다.

JSON 표현 
{
  "parent": string,
  "adPlay": {
    object (AdPlay)
  }
}
필드
parent

string

필수 항목입니다. 판매자 리소스 이름입니다. 형식: sellers/{seller}
adPlay

object (AdPlay)

필수 항목입니다. 생성할 광고 재생입니다.

광고 재생 이름은 시스템에 의해 생성되며 설정되어서는 안 됩니다. 시작 시간은 생성일로부터 최대 3일 전이어야 합니다. 종료 시간은 과거이고 시작 시간 이후여야 합니다.