최신 버전으로 업그레이드

정기적으로 최신 버전의 App Engine을 사용하는 Google Ads API를 최신 메이저 버전으로 업그레이드했습니다. 버전 지원이 종료되기 때문일 수도 있고, 새 기능을 사용하고 싶기 때문일 수도 있습니다. 따라서 항상 최신 버전으로 업그레이드하세요.

지원 중단 일정을 확인하여 업그레이드하지 않습니다 버전 관리 가이드에서 방법을 알아보세요. 알 수 있습니다.

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

  1. 주 버전을 변경하면 엔드포인트가 변경됩니다. 최신 엔드포인트를 사용하도록 클라이언트 라이브러리를 업데이트합니다.
  2. 출시 노트를 검토하여 각 출시에서 도입된 변경사항을 확인하세요.
  3. 업그레이드할 버전에서 중점적으로 살펴볼 구체적인 영역은 아래 표를 참고하세요.

proto 간의 차이점을 기반으로 한 변경사항에 대한 포괄적인 개요는 차이점 표를 확인하세요.

v17~v18

서비스 및 구성요소 변경사항
GoogleAdsService Search 및 SearchStream 요청

너무 비싸서 요청이 제한되면 다음 중 하나에 해당 QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION 또는 대신 QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION /QuotaError.RESOURCE_EXHAUSTED 자세한 내용은 블로그 게시물 게시물을 참고하세요.
GoogleAdsService 이제 SearchGoogleAdsRequest의 summary_row_setting 및 return_total_results_count 필드가 새 SearchSettings 객체의 일부가 됩니다.
AssetType DISCOVERY_CAROUSEL_CARD 열거형 값의 이름이 DEMAND_GEN_CAROUSEL_CARD로 변경되었습니다. 이는 이전에 디스커버리 캠페인의 이름을 디맨드젠 캠페인으로 변경한 것과 일맥상통합니다.
AudienceInsightsService.GenerateSuggestedTargetingInsights audience, baseline_audience, data_month 필드가 audience_definition 필드 내로 이동했습니다.
DemandGenCampaignSettings 이제 upgraded_targeting 필드의 기본값은 false가 아닌 true입니다.
LocalServicesLeadConversation 정적 호출에 대한 phone_call_details.call_recording_url 필드는 더 이상 채워지지 않습니다.

v16~v17

서비스 및 구성요소 변경사항
GoogleAdsService Search 및 SearchStream 요청

쿼리 비용이 너무 높으면 요청이 제한될 수 있습니다. 설정된 경우 QuotaError.RESOURCE_EXHAUSTED 오류가 발생합니다. 자세한 내용은 블로그 게시물을 참고하세요.
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 엔드포인트가 삭제됩니다. 이렇게 하면 Google Ads API의 다른 서비스와 함께 AdService. 자세한 내용은 데이터 가져오기에 대한 가이드 객체를 참조하세요.
CustomerLifecycleGoal 및 CampaignLifecycleGoal 수명 주기 목표를 위해 세그먼트를 관리하는 방식이 개편되었습니다. 세그먼트 보기 수명 주기 목표 문서의 잠재고객 섹션을 참고하세요. 있습니다.
ProductLink GoogleAdsService 검색 또는 검색 스트림을 실행하는 경우 product_link에 대한 요청이므로 이제 관련 필드만 선택할 수 있습니다. 하나의 연결된 제품에만 적용됩니다. 여러 연결된 제품에서 여러 필드 선택 다음과 같은 결과가 발생합니다. QuotaError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE 오류가 발생했습니다.
보고 metrics.sk_ad_network_conversion_value 필드 이름을 metrics.sk_ad_network_fine_conversion_value입니다.