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 값은 변경되지 않았습니다.

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

  • 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 enum 값 대신 설정된 반경 크기 및 거리 단위를 사용하도록 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

• triggerId 필드가 LineItemFlight 객체에서 삭제되고 LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER 값이 LineItemFlightDateType enum 유형에서 삭제되었습니다. 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