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