Method: advertisers.lineItems.generateDefault

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

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

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)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus)
}
필드
insertionOrderId

string (int64 format)

필수 항목입니다. 품목이 속한 삽입 주문의 고유 ID입니다.
displayName

string

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

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

enum (LineItemType)

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

object (MobileApp)

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

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

enum (EuPoliticalAdvertisingStatus)

이 광고 항목이 유럽연합 정치 광고를 게재하는지 여부입니다.

containsEuPoliticalAds이 상위 광고주에서 DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING로 설정된 경우 달리 지정하지 않는 한 이 필드에 DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING이 할당됩니다. 그런 다음 UI, API 또는 구조화된 데이터 파일을 사용하여 이 필드를 업데이트할 수 있습니다.

새 광고 항목을 만들 때 이 필드를 할당해야 합니다. 그렇지 않으면 advertisers.lineItems.create 요청이 실패합니다.

응답 본문

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

승인 범위

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

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

자세한 내용은 OAuth 2.0 Overview를 참조하세요.