v1에서 v2로 이전

최종 업데이트: 2022년 12월 6일

애플리케이션 마이그레이션

v1에서 v2로 이전하려면 v2를 호출하도록 엔드포인트 URL을 업데이트하고 브레이킹 체인지를 고려하여 애플리케이션을 업데이트해야 합니다.

API 호출을 v1에서 v2로 업데이트

v1 대신 v2를 사용하려면 새 v2 엔드포인트를 사용하도록 요청을 업데이트해야 합니다.

예를 들어 v1으로 advertisers.get 메서드를 호출하려면 다음 URL을 사용합니다.

GET https://displayvideo.googleapis.com/v1/advertisers/advertiserId

v2의 경우 URL을 다음과 같이 업데이트합니다.

GET https://displayvideo.googleapis.com/v2/advertisers/advertiserId

클라이언트 라이브러리를 사용하여 API에 요청하는 경우 최신 버전의 클라이언트 라이브러리를 사용하고 v2를 사용하도록 구성을 업데이트합니다.

필수 변경사항 적용

v2에 여러 가지 브레이킹 체인지가 도입됩니다. 다음 안내를 검토하고 기존 Display & Video 360 API 사용과 관련하여 필요한 변경사항을 적용합니다.

타겟팅 방법 호출 업데이트

• 이제 일부 타겟팅 유형은 타겟팅 옵션 ID 대신 enum 값을 사용하여 할당됩니다. 예를 들어 태블릿 기기는 이제 targetingTypes.targetingOptions 서비스의 타겟팅 옵션 ID가 아닌 DEVICE_TYPE_TABLET DeviceType enum을 사용하여 직접 타겟팅됩니다. 이러한 enum의 문자열 버전은 이러한 AssignedTargetingOption 리소스의 새로운 assignedTargetingOptionIdAlias 필드에 표시되며 기존 타겟팅을 검색하거나 삭제할 때 사용할 수 있습니다. 이러한 AssignedTargetingOption 리소스의 assignedTargetingOptionId 값은 변경되지 않았습니다.

  열거형 값을 사용하도록 다음 타겟팅 유형을 관리하는 호출을 업데이트합니다.

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
  • TARGETING_TYPE_ENVIRONMENT
  • TARGETING_TYPE_EXCHANGE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_NATIVE_CONTENT_POSITION
  • TARGETING_TYPE_OMID
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
  • TARGETING_TYPE_VIDEO_PLAYER_SIZE
  • TARGETING_TYPE_VIEWABILITY

• advertisers.lineItems.bulkEditLineItemAssignedTargetingOptions 메서드가 advertisers.lineItems.bulkEditAssignedTargetingOptions 메서드로 대체되었습니다.

• advertisers.lineItems.bulkListLineItemAssignedTargetingOptions 메서드가 advertisers.lineItems.bulkListAssignedTargetingOptions 메서드로 대체되었습니다.

• ProximityRadiusRange 열거형 값 대신 설정된 반경 크기 및 거리 단위를 사용하도록 TARGETING_TYPE_PROXIMITY_LOCATION_LIST 관리 호출을 업데이트합니다.

• 단일 상위 리소스에 속한 여러 타겟팅 유형에서 타겟팅 옵션을 가져오거나 수정하는 타겟팅 메서드의 이름이 변경되었습니다.

  새 이름을 사용하려면 다음 메서드 호출을 업데이트합니다.

  • advertisers.bulkEditAdvertiserAssignedTargetingOptions ~ advertisers.editAssignedTargetingOptions
  • advertisers.bulkListAdvertiserAssignedTargetingOptions ~ advertisers.listAssignedTargetingOptions
  • advertisers.campaigns.bulkListCampaignAssignedTargetingOptions ~ advertisers.campaigns.listAssignedTargetingOptions
  • advertisers.insertionOrders.bulkListInsertionOrderAssignedTargetingOptions ~ advertisers.insertionOrders.listAssignedTargetingOptions
  • partners.bulkEditPartnerAssignedTargetingOptions~partners.editAssignedTargetingOptions

advertisers.lineItems 서비스 호출 업데이트

• inventorySourceIds 필드가 삭제되었습니다. TARGETING_TYPE_INVENTORY_SOURCE의 AssignedTargetingOption 리소스를 사용하여 인벤토리 소스 할당을 관리합니다.

• 다음 LineItemWarningMessage enum 값은 v2에서 지원 중단되었으며 더 이상 LineItem.warningMessages에 표시되지 않습니다.

  • 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

• LineItemFlight 객체에서 triggerId 필드가 삭제되고 LineItemFlightDateType enum 유형에서 LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER 값이 삭제되었습니다. v2에서는 수동 트리거의 활성화에 따라 지출할 광고 항목을 설정할 수 없습니다.

customBiddingAlgorithms 서비스 호출 업데이트

customBiddingAlgorithmState 및 modelReadiness 필드는 modelDetails 필드로 대체되어 CustomBiddingModelDetails 객체 목록을 통해 액세스할 수 있는 각 광고주에게 기존 알고리즘 모델의 준비 및 정지 상태를 제공합니다.

기타 변경사항

위에 나열된 브레이킹 체인지 외에 v2에는 새로운 기능도 도입됩니다.

최초 출시 후 v2에 추가된 기능은 출시 노트에서 확인할 수 있습니다.

YouTube 광고 항목에 대한 읽기 전용 액세스

v2에서는 advertisers.lineItems 및 advertisers.lineItems.targetingTypes.assignedTargetingOptions 서비스를 각각 사용하여 YouTube 광고 항목 및 해당 타겟팅 설정을 가져올 수 있습니다. API는 읽기 전용 액세스를 제공합니다. 즉, 이러한 광고 항목에 대해 시도된 쓰기 요청은 오류를 반환합니다. YouTube 광고 항목은 다음 LineItemType 값 중 하나입니다.

• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE

실적 향상을 지원하는 새로운 방법

v2에서 advertisers.lineItems 서비스는 일괄 요청 대신 사용할 새로운 메서드를 제공하여 성능을 개선하고 할당량 소비를 줄입니다.

• advertisers.lineItems.bulkUpdate를 사용하여 여러 광고 항목에 동일한 필드 값을 설정할 수 있습니다. 현재는 entityStatus 필드의 업데이트만 지원됩니다.
• advertisers.lineItems.bulkEditAssignedTargetingOptions를 사용하면 여러 광고 항목에 동일한 할당된 타겟팅 옵션을 추가하거나 삭제할 수 있습니다.
• advertisers.lineItems.bulkListAssignedTargetingOptions를 사용하여 여러 광고 항목에 할당된 타겟팅 옵션을 나열할 수 있습니다.
• advertisers.lineItems.duplicate를 사용하여 동일한 게재 신청서 내에서 기존 광고 항목의 사본을 만들어 모든 구성 및 타겟팅 설정을 복사할 수 있습니다.

게재 신청서 타겟팅에 대한 부분 쓰기 액세스

v2에서는 advertisers.insertionOrders.targetingTypes.assignedTargetingOptions 서비스의 새로운 create 및 delete 메서드를 사용하여 InsertionOrder 리소스의 하위 집합 타겟팅 설정을 수정할 수 있습니다. 다음 타겟팅 유형은 게재 신청서 수준에서 완전히 관리할 수 있습니다.

• TARGETING_TYPE_AGE_RANGE
• TARGETING_TYPE_BROWSER
• TARGETING_TYPE_CATEGORY
• TARGETING_TYPE_CHANNEL
• TARGETING_TYPE_DEVICE_MAKE_MODEL
• TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
• TARGETING_TYPE_ENVIRONMENT
• TARGETING_TYPE_GENDER
• TARGETING_TYPE_KEYWORD
• TARGETING_TYPE_LANGUAGE
• TARGETING_TYPE_NEGATIVE_KEYWORD_LIST
• TARGETING_TYPE_OPERATING_SYSTEM
• TARGETING_TYPE_PARENTAL_STATUS
• TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
• TARGETING_TYPE_VIEWABILITY