최신 버전으로 업그레이드

주기적으로 Google Ads API의 이전 주 버전에서 최신 주 버전으로 업그레이드하는 것이 좋습니다. 그 이유는 버전이 지원 종료되거나 새로운 기능을 사용하기를 원하기 때문일 수 있습니다 항상 최신 버전으로 업그레이드하는 것이 좋습니다.

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

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

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

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

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).