v2에서 v3로 이전

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

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

v2에서 v3으로 이전하려면 v3을 호출하도록 엔드포인트 URL을 업데이트하고 중요 변경사항을 고려하도록 애플리케이션을 업데이트해야 합니다.

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

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 서비스를 사용하여 규칙 기반 맞춤 입찰 알고리즘을 빌드하고 검색할 수 있습니다.

이 기능은 베타 버전이며 허용 목록에 추가된 파트너에게만 제공됩니다. 파트너가 허용 목록에 추가되어 있지 않으면 요청에서 오류가 반환됩니다.