Display & Video 360 API v4에서 v5로 이전

최종 업데이트: 2026년 10월 22일

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

v4에서 v5로 이전하려면 v5를 호출하도록 엔드포인트 URL을 업데이트하고, 브레이킹 체인지를 고려하여 애플리케이션을 업데이트하고, 통합에 도움이 될 수 있는 새로운 기능을 검토해야 합니다.

API 호출을 v4에서 v5로 업데이트하기

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

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

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

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

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

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

필수 변경사항 적용

Display & Video 360 API v5에는 여러 브레이킹 체인지가 도입되었습니다. 다음 안내를 검토하고 기존 Display & Video 360 API 사용과 관련된 필수 변경사항을 적용하세요.

Display & Video 360 API v4와 v5의 차이점 전체 목록은 출시 노트를 참고하세요.

새 ID 및 유형을 사용하도록 인벤토리 소스 검색 및 타겟팅 업데이트

Display & Video 360 API v5는 인벤토리 소스 거래 및 입찰 패키지를 검색하고 타겟팅하는 방식을 변경합니다.

v4에서 inventorySources 서비스를 사용하여 가져온 InventorySource 리소스는 인벤토리 소스 거래와 입찰 패키지를 모두 나타냅니다. 거래와 입찰 패키지 모두 TARGETING_TYPE_INVENTORY_SOURCE를 사용하여 타겟팅됩니다.

v5에서는 인벤토리 소스 거래와 입찰 패키지가 별도로 처리됩니다.

이 업데이트는 기존 거래 및 입찰 패키지에 사용되는 ID를 변경하므로 이전 후에는 이전에 캐시된 InventorySource 리소스 ID를 사용할 수 없습니다.

이러한 변경사항 외에도 v5에서는 인벤토리 소스의 접근자를 만들고, 업데이트하고, 수정하는 기능이 삭제됩니다.

디맨드젠 캠페인 및 YouTube 리소스의 잠재고객 타겟팅 로직 업데이트

Display & Video 360 API v5는 타겟팅된 각 잠재고객 목록에 개별 할당 옵션을 사용하도록 디맨드젠 캠페인 및 YouTube 리소스의 잠재고객 타겟팅 로직을 업데이트합니다.

v4에서는 모든 잠재고객 타겟팅이 TARGETING_TYPE_AUDIENCE_GROUP를 사용하여 관리됩니다.

v5에서 디맨드젠 캠페인 및 YouTube 광고 그룹에 할당된 잠재고객 타겟팅은 잠재고객 유형에 따라 다음 타겟팅 유형 중 하나와 AssignedTargetingOption 리소스 필드를 사용하여 관리됩니다.

광고 항목은 계속해서 단일 TARGETING_TYPE_AUDIENCE_GROUP AssignedTargetingOption를 사용하여 모든 유형의 잠재고객 타겟팅을 관리합니다.

고객 매치 타겟팅 잠재고객 관리를 위해 Data Manager API로 업그레이드하기

Display & Video 360 API v5에서는 다음 메서드를 삭제하여 고객 일치 타겟팅 잠재고객의 멤버십을 만들고 관리하는 기능을 삭제합니다.

  • firstPartyAndPartnerAudiences.create
  • firstPartyAndPartnerAudiences.editCustomerMatchMembers
  • firstPartyAndPartnerAudiences.patch

고객 매치 타겟팅 잠재고객을 계속 관리하려면 Data Manager API를 사용하도록 워크플로를 업그레이드하세요.

디지털 옥외 광고 게재 신청서 검색 지원 추가

Display & Video 360 API v5에는 디지털 옥외 광고 게재 신청서를 가져오는 기능이 추가되었습니다.

광고주가 디지털 옥외 광고를 사용하는 경우 insertionOrderType 필드 값이 OUT_OF_HOME인 InsertionOrder 리소스가 포함될 것으로 예상하여 advertisers.insertionOrders.list를 호출하는 모든 통합을 업그레이드하세요.

v5에서는 디지털 옥외 광고 게재 신청서의 광고 항목을 v4에서와 마찬가지로 계속 가져올 수 있습니다.

Adloox에 대한 참조를 Peer39로 업데이트

v5에서는 Adloox (Scope3라고도 함)와의 Display & Video 360 서드 파티 브랜드 적합성 통합을 참조하는 필드 및 enum 값이 Peer39로 업데이트되었습니다.

YouTube 광고 항목, 광고 그룹, 광고의 필드 업데이트

v5에서는 LineItem, AdGroup, AdGroupAd 리소스의 다양한 필드가 삭제되거나 업데이트되었습니다. 이러한 변경사항을 반영하도록 리소스 검색 로직을 업데이트하세요.

LineItem 리소스에서 다음을 수행합니다.

LineItem 및 AdGroup 리소스에서 다음을 수행합니다.

  • TargetingExpansionConfig 필드 audienceExpansionSeedListExcluded 및 audienceExpansionLevel가 삭제되었습니다.

AdGroupAd 리소스에서 다음을 수행합니다.

지원 중단된 enum 값에 대한 참조 삭제

v5에서는 이전에 지원 중단된 enum 값이 완전히 삭제되었습니다. API 요청에 이러한 값을 사용하면 v4에서 오류가 발생하지만, 이 변경사항으로 인해 v5 클라이언트 라이브러리에서 이러한 값에 대한 참조가 삭제됩니다. 코드에서 이러한 지원 중단된 값을 참조하면 v5로 업그레이드할 때 오류가 발생할 수 있습니다.

영향을 받는 값이 있는 enum 유형에는 ContentRatingTier, GoogleAudienceType, SdfVersion, SensitiveCategory가 포함됩니다. 삭제된 모든 enum 값의 전체 목록은 출시 노트를 참고하세요.

새로운 기능 검토

v5에는 브레이킹 체인지 외에도 다음과 같은 새로운 기능이 도입되었습니다.

  • 타겟팅 유형 TARGETING_TYPE_YOUTUBE_VIDEO 및 TARGETING_TYPE_YOUTUBE_CHANNEL에 따라 광고주 수준에서 YouTube 동영상 및 채널 제외 타겟팅을 완전히 관리합니다. v4에서 이 타겟팅은 읽기 전용이었습니다.
  • 디지털 옥외 광고 InsertionOrder 리소스를 만들 수 있습니다.
  • AdGroup 필드 adSource 및 creativeAssignments와 AdGroupAd 필드 parentCreativeId를 추가하여 할당된 광고 소재를 사용하여 광고를 생성하는 광고 그룹을 지원합니다.
  • LookalikeAudience 리소스를 만들고 검색할 수 있습니다.
  • AdGroupAd 리소스의 새 containsSyntheticMedia 필드