v1에서 v2로 이전

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

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

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

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에 여러 가지 브레이킹 체인지가 도입됩니다. 다음을 검토하세요. 안내에 따라 필요한 변경사항을 디스플레이 및 Video 360 API

타겟팅 메서드 호출 업데이트

• 이제 일부 타겟팅 유형이 타겟팅 대신 enum 값을 사용하여 할당됩니다. 옵션 ID입니다. 예를 들어 태블릿 기기는 이제 DEVICE_TYPE_TABLET DeviceType enum, 광고 항목의 타겟팅 옵션 ID가 아닌 targetingTypes.targetingOptions 서비스를 사용하세요. 문자열 버전 이러한 열거형은 새로운 이 필드의 assignedTargetingOptionIdAlias 필드 AssignedTargetingOption 리소스로, 리소스를 가져오거나 기존 타겟팅을 삭제하는 데 도움이 됩니다. assignedTargetingOptionId 값 리소스 AssignedTargetingOption개 중 변경되지 않았습니다.

  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

• TARGETING_TYPE_PROXIMITY_LOCATION_LIST 관리 중인 통화 업데이트 설정된 반경 크기를 사용하고 거리 단위입니다. ProximityRadiusRange 열거형 값입니다.

• 여러 타겟팅 옵션을 검색하거나 수정하는 타겟팅 방법 단일 상위 리소스 아래의 타겟팅 유형의 이름이 변경되었습니다.

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

  • 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 필드가 삭제되었습니다. 관리 AssignedTargetingOption 리소스를 사용하여 인벤토리 소스 할당 (TARGETING_TYPE_INVENTORY_SOURCE)

• 다음 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 두 가지 서비스 간 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에서는 InsertionOrder에 대한 타겟팅 설정의 하위 집합을 수정할 수 있습니다. 새 create 및 delete 메서드 advertisers.insertionOrders.targetingTypes.assignedTargetingOptions 있습니다. 삽입 시 다음과 같은 타겟팅 유형을 완전하게 관리할 수 있습니다. 주문 수준:

• 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