Method: advertisers.lineItems.generateDefault

게재 신청서에서 상속된 설정 (타겟팅 포함)과 ENTITY_STATUS_DRAFT entityStatus를 사용하여 새 광고 항목을 만듭니다. 성공하면 새로 생성된 광고 항목을 반환합니다. 다음 세 필드를 기반으로 기본값이 설정됩니다.

YouTube + 파트너 광고 항목은 API를 사용하여 만들거나 업데이트할 수 없습니다.

HTTP 요청

POST https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/lineItems:generateDefault

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

경로 매개변수

매개변수
advertiserId

string (int64 format)

필수 항목입니다. 이 광고 항목이 속한 광고주의 ID입니다.

요청 본문

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

JSON 표현 
{
  "insertionOrderId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "mobileApp": {
    object (MobileApp)
  }
}
필드
insertionOrderId

string (int64 format)

필수 항목입니다. 광고 항목이 속한 게재 신청서의 고유 ID입니다.
displayName

string

필수 항목입니다. 광고 항목의 표시 이름입니다.

UTF-8로 인코딩되어야 하며 최대 크기는 240바이트여야 합니다.
lineItemType

enum (LineItemType)

필수 항목입니다. 광고 항목의 유형입니다.
mobileApp

object (MobileApp)

광고 항목에서 홍보하는 모바일 앱입니다.

lineItemType이 LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL 또는 LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL인 경우에만 적용됩니다.

응답 본문

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

승인 범위

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

  • https://www.googleapis.com/auth/display-video

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