v3에서 v4로 이전

최종 업데이트: 2025년 7월 31일

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

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

v3에서 v4로 API 호출 업데이트

v3 대신 v4를 사용하려면 새 v4 엔드포인트를 사용하도록 요청을 업데이트하세요.

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

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

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

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

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

필수 변경사항 적용

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

퍼스트 파티 및 서드 파티 잠재고객 리소스와 관련 타겟팅에 관한 호출 업데이트

FirstAndThirdPartyAudience 리소스가 FirstPartyAndPartnerAudience 리소스로 대체되었습니다.

이 변경사항을 적용하려면 다음을 업데이트해야 합니다.

• 새 FirstPartyAndPartnerAudience 리소스를 사용하기 위한 FirstAndThirdPartyAudience 리소스에 대한 참조입니다.
• v3 서비스의 메서드에 대한 기존 요청을 새 v4 서비스 firstPartyAndPartnerAudiences로 이전합니다.firstAndThirdPartyAudiences
• firstPartyAndPartnerAudiences.list 요청의 기본 페이지 크기는 100~5,000개 항목입니다.
• 새 FirstPartyAndPartnerAudienceType enum 유형을 사용하여 v3 firstAndThirdPartyAudienceType 필드를 새 v4 firstPartyAndPartnerAudienceType 필드로 참조합니다. 이전 값은 다음 새 값에 해당합니다.
  • FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY~TYPE_FIRST_PARTY
  • FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_THIRD_PARTY~TYPE_PARTNER

• AudienceType 열거형 값 LICENSED을 참조하여 다음의 더 구체적인 새 값 중 하나를 대신 사용합니다.

  • THIRD_PARTY
  • COMMERCE
  • LINEAR

• TargetingType TARGETING_TYPE_AUDIENCE_GROUP의 AssignedTargetingOption 리소스를 참조하여 AudienceGroupAssignedTargetingOptionDetails의 v3 필드를 다음 새 v4 필드로 대체합니다.

  • excludedFirstAndThirdPartyAudienceGroup(excludedFirstPartyAndPartnerAudienceGroup 제공)
  • includedFirstAndThirdPartyAudienceGroups(includedFirstPartyAndPartnerAudienceGroups 제공)

기존 광고 그룹 대량 목록 타겟팅 요청 업데이트

advertisers.adGroups.bulkListAdGroupAssignedTargetingOptions에서 advertisers.adGroups.bulkListAssignedTargetingOptions로 이름이 변경되었습니다. 새 메서드 이름을 사용하도록 기존 요청을 업데이트합니다.

게재 신청서 생성 시 최적화 목표 포함

이제 optimizationObjective이 InsertionOrder 리소스의 필수 필드가 되었습니다. 이 필드가 설정되어 있는지 확인하도록 advertisers.insertionOrders.create 요청을 업데이트합니다.

광고 소재 리소스 필드 publisherReviewStatuses에 대한 참조 삭제

publisherReviewStatuses 필드는 Creative 리소스의 ReviewStatusInfo 객체에서 삭제되었습니다(2024년 6월에 지원 중단됨).