주기적으로 Google Ads API의 이전 메이저 버전을 최신 메이저 버전으로 업그레이드하는 것이 좋습니다. 특정 버전의 지원이 종료되기 때문일 수도 있고 새 기능을 사용하고 싶기 때문일 수도 있습니다. 항상 최신 버전으로 업그레이드하는 것이 좋습니다.
업그레이드를 계획하려면 지원 중단 일정을 확인하세요. 버전 관리 작동 방식은 버전 관리 가이드를 참고하세요.
다음은 업그레이드 프로세스를 시작하는 데 도움이 되는 체크리스트입니다.
- 주 버전을 변경하면 엔드포인트가 변경됩니다. 최신 엔드포인트를 사용하려면 클라이언트 라이브러리를 업데이트하세요.
- 출시 노트를 살펴보고 각 버전에 도입된 변경사항을 확인하세요.
- 업그레이드할 버전에서 중점을 두어야 할 특정 영역은 아래 표를 확인하세요.
두 버전의 proto 간 차이를 기반으로 한 변경사항에 대한 포괄적인 개요는 diff 테이블을 참조하세요.
v16~v17
서비스 및 구성요소 변경사항 | |
---|---|
GoogleAdsService
Search 및 SearchStream 요청 |
비용이 너무 높아 요청이 제한되는 경우 발생하는 오류는 |
GoogleAdsService
Search 요청 |
|
Campaign 및 Ad |
이제 또한 일부 광고의 경우 보고를 위해 유형 및 입력란 이름을 변경합니다.
|
AdService |
GetAd 엔드포인트가 삭제됩니다. 이렇게 하면
AdService 를 Google Ads API의 다른 서비스와 함께 사용할 수 있습니다. 광고 및 기타 리소스 유형을 가져오는 데 권장되는 방법은 객체 검색 가이드를 참고하세요. |
CustomerLifecycleGoal 및 CampaignLifecycleGoal |
수명 주기 목표를 위해 세그먼트를 관리하는 방식이 개편되었습니다. 전체 개요는 수명 주기 목표 문서의 잠재고객 분류 섹션을 참고하세요. |
ProductLink |
product_link 에 대한 GoogleAdsService 검색 또는 검색 스트림 요청을 실행할 때 이제 연결된 제품 하나와 관련된 필드만 선택할 수 있습니다. 연결된 서로 다른 제품에서 여러 필드를 선택하면 QuotaError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE 오류가 발생합니다. |
보고 | metrics.sk_ad_network_conversion_value 필드 이름을 metrics.sk_ad_network_fine_conversion_value 로 변경했습니다. |
v15~v16
서비스 및 구성요소 변경사항 | |
---|---|
AccountLink |
linked_account 의 data_partner 및 google_ads 링크가 삭제되었습니다. 대신 ProductLinkService 및 ProductLinkInvitationService 를 사용하세요. |
CampaignLifecycleGoal |
이전에 기존 CampaignLifecycleGoal 를 업데이트할 때는 특정 요구사항과 함께 create 작업이 실행됩니다.
이제 다른 리소스 유형과 마찬가지로 update 작업을 실행할 수 있습니다. |
Error Reporting | 이제 일반 ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT 오류가 반환된 두 가지 경우에 더 구체적인 오류 메시지가 표시됩니다.
|
AudienceInsightsAttributeMetadata |
score 필드가 삭제되었습니다. |
KeywordMatchTypeRecommendation |
키워드 검색 유형이 설정되지 않은 경우 이제 API에서 recommended_match_type 필드에 UNKNOWN 대신 UNSPECIFIED 를 반환합니다. |
v14~v15
서비스 및 구성요소 변경사항 | |
---|---|
AssetGroupListingGroupFilter
|
vertical enum 필드 이름이 feed_type 로 변경되었습니다.
|
MediaFileService
|
서비스가 더 이상 필요하지 않아 삭제되었습니다.
아래의 ImageAdInfo 변경사항을 참고하세요.
|
ImageAdInfo
|
media_file 필드가 image_asset 로 대체되었습니다.
|
MerchantCenterLinkService
|
서비스가
ProductLinkInvitationService 및
ProductLinkService 로 대체되었습니다.
|
Campaign.ShoppingSetting
|
sales_country 필드가 삭제되었습니다. 이제 정보가 feed_label 필드에 반환됩니다.
|
ProductBiddingCategoryConstant
|
ProductCategoryConstant 로 대체되었습니다.
이에 따라 여러 필드의 이름이 변경되었습니다. 아래의 세 가지 변경사항을 참고하세요.
|
ListingDimensionInfo
|
product_bidding_category 필드가 product_category 로 대체되었습니다.
|
ListingGroupFilterDimension
|
product_bidding_category 필드가 product_category 로 대체되었습니다.
|
shopping_performance_view 보고서 |
다음 세그먼트 필드:
|
Campaign.shopping_setting
|
이 필드를 사용하여 검색 캠페인을 만들기 위한 지원이 삭제되었습니다. |
CampaignCriterion.listing_scope
|
이 필드를 사용하여 검색 캠페인을 만들기 위한 지원이 삭제되었습니다. |
sk_ad_network_conversions 보고서 |
metrics.sk_ad_network_conversions 가 metrics.sk_ad_network_installs 로 대체되었습니다.
|
OfflineConversionClientSummary
|
offline_conversion_client_summaries 필드를 Customer 에서 별도로 쿼리할 수 있는 최상위 리소스로 이동했습니다.
다음에서 검색어 변경: SELECT customer.offline_conversion_client_summaries FROM customer~ SELECT offline_conversion_upload_client_summary.client, offline_conversion_upload_client_summary.status, offline_conversion_upload_client_summary.total_event_count, offline_conversion_upload_client_summary.successful_event_count, offline_conversion_upload_client_summary.last_upload_date_time, ... FROM offline_conversion_upload_client_summary 쿼리 빌더를 사용하여 선택 및 필터링에 사용 가능한 필드 목록을 살펴봅니다. |
OfflineConversionUploadAlert
|
OfflineConversionAlert (으)로 이름이 변경되었습니다. |
OfflineConversionUploadError
|
OfflineConversionError (으)로 이름이 변경되었습니다. |
AdNetworkType
|
enum
YOUTUBE_SEARCH 및
YOUTUBE_WATCH 가 단일 enum
YOUTUBE 로 병합되었습니다.
|