v2에서 v3로 이전

최종 업데이트: 2023년 10월 31일

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

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

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

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

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

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

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

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

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

필수 변경사항 적용

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

광고주를 만들 때 필수 결제 구성 포함

billingConfig는 이제 Advertiser 리소스의 필수 필드입니다. advertisers.create 요청을 업데이트하여 이 필드가 설정되었는지 확인합니다. 새 Partner 리소스 billingConfig 필드를 통해 상위 파트너의 기본 결제 정보를 가져올 수 있습니다.

새로운 필드를 사용하여 타겟팅 최적화 관리

새로운 불리언 enableOptimizedTargeting 필드가 TargetingExpansionConfig 객체의 targetingExpansionLevel 필드를 대체했습니다.

새 KPI 필드를 사용하려면 게재 신청서 통합을 업데이트하세요.

새로운 kpi 필드가 InsertionOrder 리소스의 performanceGoal 필드를 대체했습니다. 이 새 필드는 PerformanceGoal 객체 대신 Kpi 객체를 사용하고 새 필드와 enum을 사용합니다.

지원 중단된 서비스 및 필드 참조 삭제

이전의 기능 지원 중단에 따라 v3에서 다양한 항목이 삭제되었습니다.

기타 변경사항

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

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

근접 위치 목록 관리

v3에서는 인접 위치 목록을 완전히 관리할 수 있으므로 advertisers.locationLists.assignedLocations 서비스를 사용하여 TARGETING_LOCATION_TYPE_PROXIMITY LocationList 리소스에 할당된 위치를 만들고 삭제할 수 있습니다. 위치는 TARGETING_TYPE_POI TargetingOption 리소스의 ID를 사용하여 식별됩니다. targetingTypes.targetingOptions.search를 사용하여 가져올 수 있습니다.

규칙 기반 맞춤 입찰 알고리즘을 구축하는 기능

v3에서는 customBiddingAlgorithms, media, customBiddingAlgorithms.rules 서비스를 사용하여 규칙 기반 맞춤 입찰 알고리즘을 빌드하고 가져올 수 있습니다.

이 기능은 베타 버전이며 허용 목록에 포함된 파트너만 사용할 수 있습니다. 파트너가 허용 목록에 없는 경우 요청에서 오류를 반환합니다.