최신 버전으로 업그레이드

주기적으로 Google Ads API의 이전 메이저 버전을 최신 메이저 버전으로 업그레이드하는 것이 좋습니다. 특정 버전의 지원이 종료되기 때문일 수도 있고 새 기능을 사용하고 싶기 때문일 수도 있습니다. 항상 최신 버전으로 업그레이드하는 것이 좋습니다.

업그레이드를 계획하려면 지원 중단 일정을 확인하세요. 버전 관리 작동 방식은 버전 관리 가이드를 참고하세요.

다음은 업그레이드 프로세스를 시작하는 데 도움이 되는 체크리스트입니다.

1. 주 버전을 변경하면 엔드포인트가 변경됩니다. 최신 엔드포인트를 사용하려면 클라이언트 라이브러리를 업데이트하세요.
2. 출시 노트를 살펴보고 각 버전에 도입된 변경사항을 확인하세요.
3. 업그레이드할 버전에서 중점을 두어야 할 특정 영역은 아래 표를 확인하세요.

두 버전의 proto 간 차이를 기반으로 한 변경사항에 대한 포괄적인 개요는 diff 테이블을 참조하세요.

v16~v17

서비스 및 구성요소 변경사항
GoogleAdsService Search 및 SearchStream 요청	비용이 너무 높아 요청이 제한되는 경우 발생하는 오류는 QuotaError.RESOURCE_EXHAUSTED 대신 QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION 또는 QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION입니다. 자세한 내용은 블로그 게시물을 참고하세요.
GoogleAdsService Search 요청	page_size를 GoogleAdsService.Search에 전달하면 RequestError.PAGE_SIZE_NOT_SUPPORTED 오류가 발생합니다.
Campaign 및 Ad	이제 AdvertisingChannelType가 DISCOVERY인 캠페인의 AdvertisingChannelType가 DEMAND_GEN가 됩니다. 또한 일부 광고의 경우 보고를 위해 유형 및 입력란 이름을 변경합니다. DISCOVERY_MULTI_ASSET_ADD는 DEMAND_GEN_MULTI_ASSET_ADD가 되고 해당하는 보고 필드 ad_group_ad.ad.discovery_multi_asset_ad는 ad_group_ad.ad.demand_gen_multi_asset_ad이 됩니다. DISCOVERY_CAROUSEL_AD는 DEMAND_GEN_CAROUSEL_AD가 되고 해당하는 보고 필드 ad_group_ad.ad.discovery_carousel_ad는 ad_group_ad.ad.demand_gen_carousel_ad이 됩니다. DISCOVERY_VIDEO_RESPONSIVE_AD는 DEMAND_GEN_VIDEO_RESPONSIVE_AD가 되고 해당하는 보고 필드 ad_group_ad.ad.discovery_video_responsive_ad는 ad_group_ad.ad.demand_gen_video_responsive_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 오류가 반환된 두 가지 경우에 더 구체적인 오류 메시지가 표시됩니다. CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS
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 보고서	다음 세그먼트 필드: product_bidding_category_level1 product_bidding_category_level2 product_bidding_category_level3 product_bidding_category_level4 product_bidding_category_level5 가 다음으로 대체되었습니다. product_category_level1 product_category_level2 product_category_level3 product_category_level4 product_category_level5
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로 병합되었습니다.