최종 업데이트: 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 사용과 관련하여 필요한 변경사항을 적용합니다.
YouTube 리소스 및 관련 타겟팅을 가져오는 호출을 업데이트합니다.
YoutubeAdGroup
및YoutubeAdGroupAd
리소스가AdGroup
및AdGroupAd
리소스로 대체되었습니다. 이러한 새 리소스는 v2 리소스와 거의 동일한 정보를 제공하지만 업데이트된 필드 이름 또는 enum 유형을 사용할 수 있습니다. 통합에서YoutubeAdGroup
또는YoutubeAdGroupAd
리소스 사용을AdGroup
및AdGroupAd
리소스로 바꾸고 다음 v2 서비스 호출을 상응하는 v3 서비스로 업데이트합니다.advertisers.youtubeAdGroupAds
부터advertisers.adGroupAds
까지advertisers.youtubeAdGroups
부터advertisers.adGroups
까지advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions
~advertisers.adGroups.targetingTypes.assignedTargetingOptions
YoutubeAndPartnersBiddingStrategy
객체에 대한 참조가 일반BiddingStrategy
객체 내의 새로운youtubeAndPartnersBid
필드로 이동되었습니다.YoutubeAndPartnersSettings
객체에서biddingStrategy
필드가 삭제되었습니다. 통합을 업데이트하여LineItem
또는AdGroup
리소스의bidStrategy
필드에 있는BiddingStrategy
객체에서 YouTube 광고 항목 또는 광고 그룹의 입찰 전략을 가져옵니다.YoutubeAndPartnersSettings
객체에서thirdPartyMeasurementSettings
필드 이름이thirdPartyMeasurementConfigs
로 변경되었고YoutubeAndPartnersThirdPartyMeasurementSettings
객체 이름이ThirdPartyMeasurementConfigs
로 변경되었습니다. 새 필드와 객체를 사용하여 서드 파티 측정 구성 정보를 가져오도록 통합을 업데이트합니다.
광고주를 만들 때 필수 결제 구성 포함
billingConfig
는 이제 Advertiser
리소스의 필수 필드입니다. advertisers.create
요청을 업데이트하여 이 필드가 설정되었는지 확인합니다. 새 Partner
리소스 billingConfig
필드를 통해 상위 파트너의 기본 결제 정보를 가져올 수 있습니다.
새로운 필드를 사용하여 타겟팅 최적화 관리
새로운 불리언 enableOptimizedTargeting
필드가 TargetingExpansionConfig
객체의 targetingExpansionLevel
필드를 대체했습니다.
새 KPI 필드를 사용하려면 게재 신청서 통합을 업데이트하세요.
새로운 kpi
필드가 InsertionOrder
리소스의 performanceGoal
필드를 대체했습니다. 이 새 필드는 PerformanceGoal
객체 대신 Kpi
객체를 사용하고 새 필드와 enum을 사용합니다.
지원 중단된 서비스 및 필드 참조 삭제
이전의 기능 지원 중단에 따라 v3에서 다양한 항목이 삭제되었습니다.
- 수동 트리거가 지원 중단되어
advertisers.manualTriggers
서비스가 삭제되었습니다. - 결과 기반 구매가 지원 중단되면서
billableOutcome
필드가InsertionOrder
리소스에서 삭제되었습니다.
기타 변경사항
위에 나열된 브레이킹 체인지 외에 v3에는 새로운 기능도 도입됩니다.
최초 출시 후 v3에 추가된 기능은 출시 노트에서 확인할 수 있습니다.
근접 위치 목록 관리
v3에서는 인접 위치 목록을 완전히 관리할 수 있으므로
advertisers.locationLists.assignedLocations
서비스를 사용하여
TARGETING_LOCATION_TYPE_PROXIMITY
LocationList
리소스에 할당된
위치를 만들고 삭제할 수 있습니다. 위치는 TARGETING_TYPE_POI
TargetingOption
리소스의 ID를 사용하여 식별됩니다. targetingTypes.targetingOptions.search
를
사용하여 가져올 수 있습니다.
규칙 기반 맞춤 입찰 알고리즘을 구축하는 기능
v3에서는 customBiddingAlgorithms
, media
, customBiddingAlgorithms.rules
서비스를 사용하여 규칙 기반 맞춤 입찰 알고리즘을 빌드하고 가져올 수 있습니다.
이 기능은 베타 버전이며 허용 목록에 포함된 파트너만 사용할 수 있습니다. 파트너가 허용 목록에 없는 경우 요청에서 오류를 반환합니다.