- 리소스: LineItem
          <ph type="x-smartling-placeholder">- </ph>
            
- JSON 표현
 
- LineItemType
- LineItemFlight
          <ph type="x-smartling-placeholder">- </ph>
            
- JSON 표현
 
- LineItemFlightDateType
- LineItemBudget
          <ph type="x-smartling-placeholder">- </ph>
            
- JSON 표현
 
- LineItemBudgetAllocationType
- PartnerRevenueModel
          <ph type="x-smartling-placeholder">- </ph>
            
- JSON 표현
 
- PartnerRevenueModelMarkupType
- ConversionCountingConfig
          <ph type="x-smartling-placeholder">- </ph>
            
- JSON 표현
 
- TrackingFloodlightActivityConfig
          <ph type="x-smartling-placeholder">- </ph>
            
- JSON 표현
 
- TargetingExpansionConfig
          <ph type="x-smartling-placeholder">- </ph>
            
- JSON 표현
 
- TargetingExpansionLevel
- LineItemWarningMessage
- MobileApp
          <ph type="x-smartling-placeholder">- </ph>
            
- JSON 표현
 
- 플랫폼
- 메서드
리소스: LineItem
단일 광고 항목
| JSON 표현 | 
|---|
| { "name": string, "advertiserId": string, "campaignId": string, "insertionOrderId": string, "lineItemId": string, "displayName": string, "lineItemType": enum ( | 
| 필드 | |
|---|---|
| name | 
 출력 전용입니다. 광고 항목의 리소스 이름입니다. | 
| advertiserId | 
 출력 전용입니다. 광고 항목이 속한 광고주의 고유 ID입니다. | 
| campaignId | 
 출력 전용입니다. 광고 항목이 속한 캠페인의 고유 ID입니다. | 
| insertionOrderId | 
 필수 항목입니다. 변경할 수 없습니다. 광고 항목이 속한 게재 신청서의 고유 ID입니다. | 
| lineItemId | 
 출력 전용입니다. 광고 항목의 고유 ID입니다. 시스템에서 할당합니다. | 
| displayName | 
 필수 항목입니다. 광고 항목의 표시 이름입니다. 최대 240바이트의 UTF-8로 인코딩되어야 합니다. | 
| lineItemType | 
 필수 항목입니다. 변경할 수 없습니다. 광고 항목의 유형입니다. | 
| entityStatus | 
 필수 항목입니다. 광고 항목이 인벤토리에 예산을 지출하고 입찰할 수 있는지 여부를 제어합니다. 
 | 
| updateTime | 
 출력 전용입니다. 광고 항목이 마지막으로 업데이트된 시점의 타임스탬프입니다. 시스템에서 할당합니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면  | 
| partnerCosts[] | 
 광고 항목과 연결된 파트너 비용입니다. 
 | 
| flight | 
 필수 항목입니다. 광고 항목 광고 게재 기간의 시작 및 종료 시간입니다. | 
| budget | 
 필수 항목입니다. 광고 항목의 예산 할당 설정입니다. | 
| pacing | 
 필수 항목입니다. 광고 항목의 예산 지출 속도 설정입니다. | 
| frequencyCap | 
 필수 항목입니다. 광고 항목의 노출 최대 게재빈도 설정입니다. 제한된 한도를 할당하는 경우 이 설정 객체의  | 
| partnerRevenueModel | 
 필수 항목입니다. 광고 항목의 파트너 수익 모델 설정입니다. | 
| conversionCounting | 
 광고 항목의 전환 추적 설정입니다. | 
| creativeIds[] | 
 광고 항목과 연결된 광고 소재의 ID입니다. | 
| bidStrategy | 
 필수 항목입니다. 광고 항목의 입찰 전략입니다. | 
| integrationDetails | 
 광고 항목의 통합 세부정보입니다. | 
| inventorySourceIds[] | 
 광고 항목에 할당된 비공개 인벤토리 소스의 ID입니다. | 
| targetingExpansion | 
 광고 항목의 타겟팅 최적화 설정입니다. 이 구성은 자동 입찰을 사용하고 요건을 충족하는 잠재고객 목록을 포함 방식으로 타겟팅하는 디스플레이, 동영상 또는 오디오 광고 항목에만 적용됩니다. | 
| warningMessages[] | 
 출력 전용입니다. 광고 항목에서 생성된 경고 메시지입니다. 이러한 경고는 광고 항목 저장을 차단하지는 않지만, 일부는 광고 항목의 실행을 차단할 수 있습니다. | 
| mobileApp | 
 광고 항목으로 홍보한 모바일 앱입니다. 
 | 
| reservationType | 
 출력 전용입니다. 광고 항목의 예약 유형입니다. | 
| excludeNewExchanges | 
 광고 항목이 자동으로 타겟팅하지 않도록 새 거래소를 제외할지 여부입니다. 이 필드의 기본값은 false입니다. | 
LineItemType
가능한 광고 항목 유형입니다.
광고 항목의 유형에 따라 광고 형식이나 타겟팅 옵션 등 적용 가능한 설정과 옵션이 결정됩니다.
| 열거형 | |
|---|---|
| LINE_ITEM_TYPE_UNSPECIFIED | 유형 값이 지정되지 않았거나 이 버전에서 알 수 없습니다. 이 유형의 광고 항목 및 해당 타겟팅은 API를 사용하여 만들거나 업데이트할 수 없습니다. | 
| LINE_ITEM_TYPE_DISPLAY_DEFAULT | 이미지, HTML5, 네이티브 또는 리치 미디어 광고 | 
| LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL | 앱 설치를 유도하는 디스플레이 광고입니다. | 
| LINE_ITEM_TYPE_VIDEO_DEFAULT | 다양한 환경에서 CPM 기준으로 판매되는 동영상 광고입니다. | 
| LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL | 앱 설치를 유도하는 동영상 광고입니다. | 
| LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INVENTORY | 모바일 앱 인벤토리에 게재되는 디스플레이 광고 이 유형의 광고 항목 및 해당 타겟팅은 API를 사용하여 만들거나 업데이트할 수 없습니다. | 
| LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INVENTORY | 모바일 앱 인벤토리에 게재되는 동영상 광고입니다. 이 유형의 광고 항목 및 해당 타겟팅은 API를 사용하여 만들거나 업데이트할 수 없습니다. | 
| LINE_ITEM_TYPE_AUDIO_DEFAULT | RTB 오디오 광고는 다양한 환경에서 판매되었습니다. | 
| LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP | OTT 게재 신청서에 있는 오버더톱 광고 이 유형은 게재 신청서가 insertionOrderTypeOVER_THE_TOP인 광고 항목에만 적용됩니다. | 
LineItemFlight
광고 항목의 활성 기간을 제어하는 설정입니다.
| JSON 표현 | 
|---|
| { "flightDateType": enum ( | 
| 필드 | |
|---|---|
| flightDateType | 
 필수 항목입니다. 광고 항목의 게재 날짜 유형입니다. | 
| dateRange | 
 광고 항목의 광고 게재 기간 시작일과 종료일입니다. 상위 광고주의 시간대를 기준으로 해결됩니다. 
 | 
| triggerId | 
 광고 항목과 연결된 수동 트리거의 ID입니다. 
 경고: 수동 트리거를 사용하는 광고 항목은 더 이상 동영상 360 이 필드는 2023년 8월 1일에 지원 종료됩니다. 자세한 내용은 기능 지원 중단 공지를 참고하세요. | 
LineItemFlightDateType
가능한 광고 항목의 게재 날짜 유형입니다.
| 열거형 | |
|---|---|
| LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED | 유형 값이 지정되지 않았거나 이 버전에서 알 수 없습니다. | 
| LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED | 광고 항목의 게재 날짜는 상위 게재 신청서에서 상속됩니다. | 
| LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM | 광고 항목은 자체적인 맞춤 게재 날짜를 사용합니다. | 
| LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER | 광고 항목에서 트리거를 사용합니다. 경고: 수동 트리거를 사용하는 광고 항목은 더 이상 동영상 360 이 값은 2023년 8월 1일에 지원 종료됩니다. 자세한 내용은 기능 지원 중단 공지를 참고하세요. | 
LineItemBudget
예산 할당 방법을 제어하는 설정입니다.
| JSON 표현 | 
|---|
| { "budgetAllocationType": enum ( | 
| 필드 | |
|---|---|
| budgetAllocationType | 
 필수 항목입니다. 예산 할당 유형입니다. 
 | 
| budgetUnit | 
 출력 전용입니다. 예산 단위는 예산이 통화 기반인지 또는 노출수 기반인지 지정합니다. 이 값은 상위 게재 신청서에서 상속됩니다. | 
| maxAmount | 
 광고 항목이 지출할 최대 예산 금액입니다. 0보다 커야 합니다. 
 
 | 
LineItemBudgetAllocationType
가능한 예산 할당 유형입니다.
| 열거형 | |
|---|---|
| LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNSPECIFIED | 유형 값이 지정되지 않았거나 이 버전에서 알 수 없습니다. | 
| LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC | 광고 항목에 자동 예산 할당이 사용 설정되었습니다. | 
| LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED | 고정된 최대 예산 금액이 광고 항목에 할당되었습니다. | 
| LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED | 광고 항목에는 예산 한도가 적용되지 않습니다. | 
PartnerRevenueModel
파트너 수익이 계산되는 방식을 제어하는 설정입니다.
| JSON 표현 | 
|---|
| {
  "markupType": enum ( | 
| 필드 | |
|---|---|
| markupType | 
 필수 항목입니다. 파트너 수익 모델의 마크업 유형입니다. | 
| markupAmount | 
 필수 항목입니다. 파트너 수익 모델의 인상된 금액입니다. 0보다 크거나 같아야 합니다. 
 | 
PartnerRevenueModelMarkupType
파트너 수익 모델의 가능한 마크업 유형입니다.
| 열거형 | |
|---|---|
| PARTNER_REVENUE_MODEL_MARKUP_TYPE_UNSPECIFIED | 유형 값이 지정되지 않았거나 이 버전에서 알 수 없습니다. | 
| PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM | 고정 CPM을 기반으로 파트너 수익을 계산합니다. | 
| PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP | 미디어 비용의 추가 요금을 기준으로 파트너 수익을 계산합니다. | 
| PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP | 모든 파트너 비용과 데이터 비용이 포함된 총 미디어 비용의 추가 요금을 기준으로 파트너 수익을 계산합니다. | 
ConversionCountingConfig
전환 집계 방법을 제어하는 설정입니다.
모든 클릭 후 전환이 집계됩니다. 조회 후 전환 집계를 위해 비율 값을 설정할 수 있습니다.
| JSON 표현 | 
|---|
| {
  "postViewCountPercentageMillis": string,
  "floodlightActivityConfigs": [
    {
      object ( | 
| 필드 | |
|---|---|
| postViewCountPercentageMillis | 
 계산할 조회 후 전환수의 비율(단위: 밀리초)입니다(백분율의 1/1000). 0 이상 100,000 이하여야 합니다. 예를 들어 클릭 후 전환의 50% 를 추적하려면 값을 50000으로 설정합니다. | 
| floodlightActivityConfigs[] | 
 전환을 추적하는 데 사용되는 플러드라이트 활동 구성입니다. 계산된 전환수는 이 필드에 지정된 모든 플러드라이트 활동 ID로 계산된 모든 전환수를 합한 값입니다. | 
TrackingFloodlightActivityConfig
단일 플러드라이트 활동 구성의 동작을 제어하는 설정입니다.
| JSON 표현 | 
|---|
| { "floodlightActivityId": string, "postClickLookbackWindowDays": integer, "postViewLookbackWindowDays": integer } | 
| 필드 | |
|---|---|
| floodlightActivityId | 
 필수 항목입니다. 플러드라이트 활동의 ID입니다. | 
| postClickLookbackWindowDays | 
 필수 항목입니다. 광고가 클릭된 후 전환으로 집계될 수 있는 경과 일수입니다. 0 이상 90 이하여야 합니다. | 
| postViewLookbackWindowDays | 
 필수 항목입니다. 광고가 조회된 후 전환으로 집계될 수 있는 경과 일수입니다. 0 이상 90 이하여야 합니다. | 
TargetingExpansionConfig
광고 항목의 타겟팅 최적화 설정을 제어하는 설정입니다.
| JSON 표현 | 
|---|
| {
  "targetingExpansionLevel": enum ( | 
| 필드 | |
|---|---|
| targetingExpansionLevel | 
 필수 항목입니다. 타겟팅 최적화의 사용 설정 여부 이 필드는 다음 값을 지원합니다. 
 이 필드가 다른 값으로 설정되면  
 | 
| excludeFirstPartyAudience | 
 타겟팅 확장에 퍼스트 파티 잠재고객이 사용되지 않도록 제외할지 여부입니다. 이 필드는 타겟팅 최적화 출시와 함께 지원 중단되었습니다. 이 필드는  | 
TargetingExpansionLevel
타겟팅 최적화 설정
| 열거형 | |
|---|---|
| TARGETING_EXPANSION_LEVEL_UNSPECIFIED | 이 버전에서 타겟팅 최적화 설정이 지정되지 않았거나 알 수 없습니다. | 
| NO_EXPANSION | 타겟팅 최적화가 사용 중지되었습니다. | 
| LEAST_EXPANSION | 타겟팅 최적화가 사용 설정되었습니다. | 
| SOME_EXPANSION | 사용하는 경우 자동으로  | 
| BALANCED_EXPANSION | 사용하는 경우 자동으로  | 
| MORE_EXPANSION | 사용하는 경우 자동으로  | 
| MOST_EXPANSION | 사용하는 경우 자동으로  | 
LineItemWarningMessage
광고 항목에서 생성된 경고 메시지입니다. 이러한 유형의 경고는 광고 항목 저장을 차단하지는 않지만 광고 항목 실행이 차단될 수 있습니다.
| 열거형 | |
|---|---|
| LINE_ITEM_WARNING_MESSAGE_UNSPECIFIED | 지정되지 않았거나 알 수 없습니다. | 
| INVALID_FLIGHT_DATES | 이 항목에 잘못된 게재 날짜가 있습니다. 해당 광고 항목은 실행되지 않습니다. | 
| EXPIRED | 이 광고 항목의 종료일이 과거 날짜입니다. | 
| PENDING_FLIGHT | 이 광고 항목은 향후에 게재됩니다. | 
| ALL_PARTNER_ENABLED_EXCHANGES_NEGATIVELY_TARGETED | 파트너를 사용하도록 설정된 모든 교환이 제외 타겟팅되어 있습니다. 해당 광고 항목은 실행되지 않습니다. | 
| INVALID_INVENTORY_SOURCE | 타겟팅하고 있는 활성 인벤토리 소스가 없습니다. 해당 광고 항목은 실행되지 않습니다. | 
| APP_INVENTORY_INVALID_SITE_TARGETING | 이 광고 항목의 앱 및 URL 타겟팅에 모바일 앱이 포함되지 않습니다. 이 광고 항목 유형을 사용하려면 채널, 사이트 목록 또는 앱 타겟팅에 모바일 앱을 포함해야 합니다. 해당 광고 항목은 실행되지 않습니다. | 
| APP_INVENTORY_INVALID_AUDIENCE_LISTS | 이 광고 항목은 모바일 사용자를 타겟팅하지 않습니다. 이 광고 항목 유형을 사용하려면 모바일 사용자로 사용자 목록을 타겟팅해야 합니다. 해당 광고 항목은 실행되지 않습니다. | 
| NO_VALID_CREATIVE | 이 광고 항목에 유효한 광고 소재가 없습니다. 해당 광고 항목은 실행되지 않습니다. | 
| PARENT_INSERTION_ORDER_PAUSED | 이 광고 항목의 게재 신청서가 일시 중지되어 있습니다. 해당 광고 항목은 실행되지 않습니다. | 
| PARENT_INSERTION_ORDER_EXPIRED | 이 광고 항목의 게재 신청서에 종료일이 과거로 설정되어 있습니다. 해당 광고 항목은 실행되지 않습니다. | 
| NO_POSITIVE_AUDIENCE_LIST_TARGETED | 이 광고 항목은 잠재고객 목록을 타겟팅하지 않으며, 이로 인해 예산이 매우 빠르게 지출될 수 있습니다. | 
| APP_INSTALL_NO_CONVERSION_PIXEL | 이 앱 설치 광고 항목에는 전환 픽셀이 설정되어 있지 않습니다. | 
| TARGETING_REVOKED_OR_CLOSED_USER_LIST | 이 광고 항목은 더 이상 사용할 수 없는 사용자 목록을 하나 이상 타겟팅합니다. 이렇게 되면 앞으로 광고 항목이 게재되지 않으므로 타겟팅에서 이러한 목록을 삭제하는 것이 좋습니다. | 
| APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY | 이 앱 설치 광고 항목에는 최적화 입찰 전략이 없습니다. | 
| CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS | 이 광고 항목에서 타겟팅하는 거래는 사용하지 않는 광고 소재 크기를 허용합니다. 이로 인해 광고 항목의 게재 또는 실적이 제한될 수 있습니다. | 
| NO_CREATIVE_FOR_TARGETED_DEALS | 이 광고 항목에는 타겟팅된 거래의 광고 소재가 없습니다. | 
| TARGETING_DEPRECATED_GEO_TARGET | 이 광고 항목은 지원 중단된 지역 타겟을 타겟팅합니다. | 
| DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION | 이 광고 항목에서 사용 중인  
 | 
MobileApp
모바일 앱 설치 광고 항목으로 홍보되는 모바일 앱입니다.
| JSON 표현 | 
|---|
| {
  "appId": string,
  "platform": enum ( | 
| 필드 | |
|---|---|
| appId | 
 필수 항목입니다. 플랫폼 스토어에서 제공하는 앱의 ID입니다. Android 앱은 Android의 Play 스토어에서 사용하는 번들 ID(예:  iOS 앱은 Apple의 App Store에서 사용되는 9자리의 앱 ID(예:  | 
| platform | 
 출력 전용입니다. 앱 플랫폼 | 
| displayName | 
 출력 전용입니다. 앱 이름입니다. | 
| publisher | 
 출력 전용입니다. 앱 게시자 | 
플랫폼
가능한 모바일 앱 플랫폼
| 열거형 | |
|---|---|
| PLATFORM_UNSPECIFIED | 플랫폼이 지정되지 않았습니다. | 
| IOS | 있습니다. | 
| ANDROID | Android 플랫폼입니다. | 
| 메서드 | |
|---|---|
| 
 | 단일 광고 항목에서 타겟팅 옵션을 일괄 수정합니다. | 
| 
 | 타겟팅 유형 전반에서 광고 항목에 할당된 타겟팅 옵션을 나열합니다. | 
| 
 | 새 광고 항목을 만듭니다. | 
| 
 | 광고 항목을 삭제합니다. | 
| 
 | 게재 신청서에서 상속된 설정 (타겟팅 포함)과 ENTITY_STATUS_DRAFTentity_status를 사용하여 새 광고 항목을 만듭니다. | 
| 
 | 광고 항목을 가져옵니다. | 
| 
 | 광고주의 광고 항목을 나열합니다. | 
| 
 | 기존 광고 항목을 업데이트합니다. |