현재 및 계획된 기능 지원 중단의 최신 목록은 기능 지원 중단을 참조하세요.
v26 메이저 버전
Google Ads API v26에는 다음과 같은 새로운 기능, 업데이트, 브레이킹 체인지가 포함되어 있습니다.
v26 (2026-10-14)
주요 출시 버전인 Google Ads API v26에는 다음과 같은 새로운 기능, 업데이트, 브레이킹 체인지가 추가되었습니다.
자세한 내용은 최신 버전으로 업그레이드를 참고하세요.
브레이킹 체인지
| 초기 상태 | 새 상태 | 변경 유형 | 구현 안내 |
|---|---|---|---|
| 캠페인 | |||
LocalServicesPmaxCampaignSettings의 선택사항 country_code 필드 |
지역 서비스 실적 최대화 캠페인 생성 시 필수 입력란 (LocalServicesPmaxCampaignSettings.country_code) |
동작 변경 | 지역 서비스 실적 최대화 캠페인을 만들 때 country_code (새로 필요한 listing_id와 함께)를 지정해야 합니다. |
| 전환수 | |||
ConversionTrackingSetting (Customer.conversion_tracking_setting)의 enhanced_conversions_for_leads_enabled 필드 |
없음 | 삭제 | 대신 Customer.conversion_tracking_setting에서 ConversionTrackingSetting.enablement_setting를 사용하여 계정 수준의 향상된 전환 설정을 검사하세요. |
| 타겟팅 | |||
AdGroupBidModifier의 호텔별 기준 필드:
|
AdGroupBidModifier의 세로형에 구애받지 않는 기준 필드:
|
이름 변경 / 삭제 | 호텔 외의 여행 카테고리 (예: 할 일)에서 타겟팅을 지원하는 카테고리 중립적 기준 필드를 사용하도록 참조를 업데이트합니다. 기준 ID, 타겟팅 동작, 기존 입찰가 조정은 그대로 유지됩니다. min_nights 및 max_nights의 값은 그대로 min_days 및 max_days로 이월됩니다. |
HotelDateSelectionType 및 segments.user_set_dates 유형 |
DateSelectionType |
이름 바꾸기 / 유형 변경 | HotelDateSelectionType 대신 DateSelectionType를 사용합니다. |
CriterionError의 호텔별 오류 이유:
|
CriterionError의 카테고리별 오류 원인:
|
이름 바꾸기 | 새로운 카테고리 중립적 오류 이유를 확인하도록 오류 처리를 업데이트합니다. |
기능 및 업데이트 (브레이킹 아님)
| 기능 및 업데이트 | 유형 | 설명 |
|---|---|---|
| 애셋 | ||
| LINE 및 SMS 비즈니스 메시지 제공업체 | 새 필드 및 enum 값 | BusinessMessageAsset에서 LINE 및 SMS를 메시지 제공업체로 지원하는 기능이 추가되었습니다. 여기에는 BusinessMessageProvider.LINE 및 BusinessMessageProvider.SMS와 함께 새로운 BusinessMessageAsset.line_info 및 BusinessMessageAsset.sms_info 필드가 포함됩니다. |
AssetGroupError.UNSUPPORTED_LOCAL_SERVICES_CATEGORY |
새 enum 값 / 오류 | GoogleLocalServicesInfo (AssetGroup.google_local_services_info)에 지정된 카테고리가 지역 서비스 실적 최대화 캠페인에서 지원되지 않는 경우를 나타내기 위해 AssetGroupError에 추가되었습니다. |
| 캠페인 | ||
| 지역 서비스 실적 최대화 캠페인 만들기 | 새로운 기능, 필드, 오류 |
또한 지역 서비스 실적 최대화 캠페인에 연결된 Google 비즈니스 프로필 등록정보 ID를 노출하기 위해 |
| 지역 서비스 캠페인 유효성 검사 오류 | 새 enum 값 및 오류 | 지역 서비스 캠페인에 대한 새로운 검사 오류가 추가되었습니다. |
| Hotel Center 계정 연결 유효성 검사 | 새 enum 값 / 오류 | 호텔 숙박 시설 애셋 모음 (Campaign.hotel_property_asset_set)을 여행 목표 달성을 위한 실적 최대화 캠페인에 연결하려면 활성 Hotel Center 계정 연결이 필요함을 나타내기 위해 CampaignError.HOTEL_PROPERTY_ASSET_SET_HOTEL_CENTER_LINK_REQUIRED 오류 코드를 CampaignError에 추가했습니다. |
| 디맨드젠 캠페인의 일일 최소 예산 | 새로운 필드 | CurrencyConstant에 demand_gen_info.minimum_budget_per_day_micros 필드가 추가되었습니다. 이 필드는 해당 통화로 디맨드젠 캠페인에 필요한 최소 일일 예산을 지정합니다. 이 필드의 값은 API에서 적용하는 최소 예산이 변경될 때 업데이트됩니다. |
| 캠페인의 광고효과 측정 구성 | 새로운 필드 | 캠페인에 연결된 광고효과 측정 구성의 리소스 이름을 노출하기 위해 Campaign.lift_measurement_config이 추가되었습니다. |
| AI Max 실험 검증 | 새 enum 값 / 오류 | 이미 AI Max가 사용 설정되어 있거나 실험 부문 생성 전에 동일한 요청 내에서 사용 설정된 캠페인에 대해 ADOPT_AI_MAX 실험을 만들려고 할 때 ExperimentArmError에 ExperimentArmError.ADOPT_AI_MAX_CAMPAIGN_ALREADY_ENABLED 오류 코드가 추가되었습니다. |
| 쇼핑 캠페인 등록정보 유형 | 지원 확대 | Campaign.listing_type 지원이 쇼핑 캠페인으로 확대되었습니다. |
| EU 정치 광고 자체 선언 업데이트 | 업데이트된 동작 및 새 필드 |
이제 유럽연합을 적극적으로 타겟팅하지 않는 일부 캠페인에서는
|
| 전환수 | ||
| 통합된 향상된 전환 구성 | 새 필드 및 enum | 새로운 EnhancedConversionsConfig enum을 사용하여 표시되는 계정의 통합된 향상된 전환 구성을 노출하기 위해 ConversionTrackingSetting.enablement_setting 및 ConversionTrackingSetting.effective_enablement_setting (Customer.conversion_tracking_setting에 있음)이 추가되었습니다. |
ConversionActionCategory.MESSAGE_LEAD |
새 enum 값 | 광고주의 제품에 관심을 나타내는 메시지 또는 채팅 상호작용을 지원하기 위해 ConversionActionCategory에 추가되었습니다. |
ConversionAttributionEventType.CLICK |
새 enum 값 | 이전에는 UNKNOWN enum 값에 포함되었던 광고 클릭으로 인한 전환을 나타내기 위해 ConversionAttributionEventType에 추가되었습니다. |
| 일반 | ||
| 지역 서비스 리드 업데이트 | 새 필드 및 enum 값 |
|
| 추천 | ||
| 검색 캠페인의 예산 증액 추천 | 새 추천 | 검색 캠페인의 일일 예산이 너무 낮을 때 예산 증액을 지원하기 위해 RecommendationType.RAISE_BUDGET_PERFORMANCE_TOO_LOW, Recommendation.raise_budget_performance_too_low_recommendation, ApplyRecommendationOperation.raise_budget_performance_too_low가 추가되었습니다. |
| 보고서 | ||
| 검색 광고효과 측정 | 새로운 기능, 리소스, 세그먼트, 측정항목 | 검색 광고효과 측정 지원이 추가되었습니다.
|
| 쇼핑 캠페인의 최종 URL 확장 애셋 뷰 | 지원 확대 | final_url_expansion_asset_view이 쇼핑 캠페인을 지원하도록 확장되었습니다 (ad_group을 final_url_expansion_asset_view.ad_group과 함께 기여도 분석 리소스로 선택할 수 있음). |
| 동영상 | ||
| YouTube 생성형 콘텐츠 공개 | 새 필드 및 enum | YouTube 업로드에 대한 생성형 콘텐츠 공개 문구 지원이 추가되었습니다. VideoContentMetadata 유형의 새 필드 YouTubeVideoUpload.video_content_metadata가 YouTubeVideoUpload에 추가되었으며, 여기에는 YouTubeVideoUploadGenerativeContentDisclosure 유형의 VideoContentMetadata.generative_content_disclosure 아래에 공개 설정이 포함되어 있습니다. |
v25 메이저 버전 및 마이너 버전
Google Ads API v25에는 다음과 같은 새로운 기능, 업데이트, 브레이킹 체인지가 포함되어 있습니다.
v25.2 (2026-09-23)
Google Ads API v25.2에 다음과 같은 새로운 기능과 업데이트가 추가되었습니다. v25.2와 같은 마이너 버전에는 브레이킹 체인지가 포함되지 않습니다.
v25.1 (2026-08-19)
Google Ads API v25.1에 다음 새로운 기능과 업데이트가 추가되었습니다. v25.1과 같은 마이너 버전에는 브레이킹 체인지가 포함되지 않습니다.
| 기능 및 업데이트 | 유형 | 설명 |
|---|---|---|
| 애셋 | ||
AssetFieldType.TEXT_DISCLAIMER ServedAssetFieldType.TEXT_DISCLAIMER |
새 enum 값 | 텍스트 면책 조항 애셋에 대한 지원이 추가되었습니다. |
| 캠페인 | ||
Campaign.aca_migration_date_time Campaign.broad_match_migration_date_time |
새 필드 | 예정된 AI Max 자동 이전을 추적합니다. |
| 전환수 | ||
| 브랜드 광고효과 측정 | 새로운 기능 | 다음 업데이트를 통해 브랜드 광고효과 측정에 대한 지원이 추가되었습니다.
|
| 전환 상승도 측정 | 새로운 기능 | 다음 업데이트를 통해 전환 상승도 측정 지원이 추가되었습니다.
|
LiftMeasurementFlight |
새 리소스 | 측정된 광고 게재 시작일 및 종료일 (start_date 및 end_date)을 포함하여 광고효과 측정 구성의 광고 게재 세부정보를 나타내는 새로운 읽기 전용 리소스입니다. |
| 일반 | ||
SmartCampaignError |
새 enum 값 | 실적 최대화 캠페인 생성 제약 조건에 대한 새로운 특정 오류 코드가 추가되었습니다. |
AuthorizationErrorEnum.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION |
새 enum 값 / 오류 | TEST 액세스 수준의 Google Cloud 프로젝트가 테스트 계정이 아닌 계정에 요청을 시도할 때 반환됩니다. |
| 계획 | ||
| 브랜드 감정 통계 | 새로운 기능 | ContentCreatorInsightsService에 브랜드 감정 통계 지원이 추가되었습니다.
|
BenchmarksService 개선사항 |
새로운 기능 | 벤치마크 분석의 범위를 지정하기 위한 필터로 카테고리 지원이 추가되었습니다. 또한 다음과 같은 비즈니스에 중요한 측정항목이 추가로 지원됩니다.
|
| 자녀 유무 타겟팅 | 새로운 기능 | 도달범위 플래너에 자녀 유무 타겟팅 지원이 추가되었습니다. ReachPlanService.GenerateReachForecast 서비스의 Targeting에 새 필드 parental_statuses를 추가하고 ReachPlanService.ListPlannableProducts 서비스의 PlannableTargeting에 parental_statuses를 추가했습니다. |
| 추천 | ||
Recommendation.campaign_specific_app_goal_recommendation |
새 추천 | 캠페인별 앱 전환 목표를 추가하도록 제안합니다. 새 EffectiveAutomaticGoal 리소스는 이 추천 내에서 현재 목표를 나타내는 데 사용됩니다. |
| 보고서 | ||
Metrics.original_conversion_value |
새로운 필드 | 입찰 가능한 전환의 원래 전환 가치를 나타냅니다. 전환 가치 규칙 또는 라이프사이클 목표 조정과 같은 가치 규칙 조정이 적용되기 전의 조정되지 않은 전환 가치를 나타냅니다. |
| 포인트 멤버십 통계 | 새로운 기능 | 사용자 충성도 멤버십 프로그램 상태별로 통계를 분류하는 기능이 추가되었으며 전환 가치 규칙에 충성도 멤버십 기본 측정기준이 추가되었습니다.
|
| 타겟팅 | ||
vertical_ads_item_bid |
새 기준 유형 | 새로운 vertical_ads_item_bid 기준 유형이 AdGroupCriterion.criterion에 추가되었습니다. |
v25 (2026-07-22)
주요 출시 버전인 Google Ads API v25에는 다음과 같은 새로운 기능, 업데이트, 브레이킹 체인지가 추가되었습니다.
자세한 내용은 최신 버전으로 업그레이드를 참고하세요.
브레이킹 체인지
| 초기 상태 | 새 상태 | 변경 유형 | 구현 안내 |
|---|---|---|---|
| 캠페인 | |||
CustomerLifecycleOptimizationValueSettings의 독립형 필드 additional_value 및 additional_high_lifetime_value |
새로운 value_multiplier 및 high_lifetime_value_multiplier 필드와 함께 각각 value_adjustment 및 high_lifetime_value_adjustment oneof의 일부 |
구조적 변화 | 이제 이러한 필드가 oneof의 일부이므로 필드에 대한 참조를 업데이트합니다. |
기존 CustomerLifecycleGoal 및 CampaignLifecycleGoal 리소스, 해당 서비스 CustomerLifecycleGoalService 및 CampaignLifecycleGoalService, 기존 설정/열거형 (CustomerAcquisitionGoalSettings, CustomerAcquisitionOptimizationModeEnum, LifecycleGoalValueSettings) |
없음 | 삭제 | 개선된 통합 목표 스키마를 사용합니다.
|
| 일반 | |||
인센티브 서비스 요청 및 응답 메시지의 중첩된 enum 필드:
|
독립형 enum 필드: | 이름 바꾸기 / 삭제 | 기존 type 필드 대신 새로운 독립형 enum 필드를 사용하세요. |
ApplyIncentiveRequest의 선택사항 selected_incentive_id 및 customer_id 필드 |
필수 입력란 | 동작 변경 | ApplyIncentive를 호출할 때 두 필드를 모두 제공해야 합니다. |
LocalServicesLead 리소스의 소비자 이메일 주소 필드 ContactDetails.email |
없음 | 삭제 | 더 이상 지원되지 않으므로 이 필드에 대한 참조를 삭제합니다. |
AdvertisingPartnerLinkInvitationProperties의 선택사항 allowed_domain 필드 |
광고 파트너를 위해 CreateProductLinkInvitation를 호출할 때 필수 입력란 |
동작 변경 | 광고 파트너를 위한 제품 연결 초대장을 만들 때 allowed_domain를 제공해야 합니다. |
| 계획 | |||
GenerateCreatorInsightsRequest의 search_brand 필드 |
없음 | 삭제 | 대신 search_topics를 사용하세요. |
Targeting의 plannable_location_id 필드 및 GenerateReachForecastRequest의 cookie_frequency_cap 필드 |
없음 | 삭제 | plannable_location_ids 및 cookie_frequency_cap_setting를 사용하도록 전환합니다. |
| 보고서 | |||
GenerateBenchmarksMetricsResponse 및 BreakdownMetrics의 customer_metrics 필드(Metrics 유형) |
CustomerMetrics 유형의 필드 |
유형 변경 / 동작 변경 | 고객의 광고 실적을 나타내는 측정항목만 포함하는 새로운 CustomerMetrics 유형을 사용하도록 통합을 업데이트하세요. |
기능 및 업데이트 (호환성 유지)
| 기능 및 업데이트 | 유형 | 설명 |
|---|---|---|
| 광고 | ||
AssetAutomationType.GENERATE_ANIMATED_IMAGES_FROM_OTHER_ASSETS |
새 enum 값 / 동작 | DemandGenMultiAssetAds에 사용할 수 있습니다. 사용 설정하면 애니메이션이 아닌 이미지를 입력으로 사용하여 애니메이션 이미지를 생성합니다. 이 API 버전부터 새 DemandGenMultiAssetAds가 기본적으로 선택됩니다. |
| AI로 생성된 콘텐츠 정보 변경 가능 여부 | 행동 변경사항 | 이제 v25, v24, v23에서 Asset.synthetic_content_info 및 Ad.synthetic_content_info을 완전히 변경할 수 있습니다. |
| 캠페인 | ||
| 충성도 유지 목표 | 새로운 기능 / 설정 | 광고주가 포인트 멤버십 회원을 유지하도록 캠페인을 최적화할 수 있는 포인트 멤버십 회원 유지 목표에 대한 지원이 추가되었습니다.
|
| 신규 고객 확보 목표 | 새로운 기능 / 설정 | 개편된 통합 목표 스키마를 반영하도록 Google Ads API의 신규 고객 확보 목표 지원이 업데이트되었습니다.
|
| 전환수 | ||
| YouTube 서드 파티 전환 기여 분석 | 새 필드 | 서드 파티 파트너를 사용한 YouTube 전환 기여 분석 확인 지원이 추가되었습니다.
|
| 일반 | ||
ContactDetails.phone_number_extension |
새로운 필드 | LocalServicesLead 리소스에 추가되었습니다. |
IncentiveError |
새 enum 값 및 오류 | 인센티브 사용 실패에 대한 새로운 특정 오류 코드가 추가되었습니다.
|
| 계획 | ||
| 트렌드 통계의 YouTube 채널 세부정보 | 새 필드 | 트렌드 통계를 검색할 때 관련 동영상의 YouTube 채널 세부정보가 더 많이 지원됩니다. YouTubeVideoAttributeMetadata에 새 필드 channel_id, channel_name, channel_url를 추가했습니다. |
YouTubeChannelInsights.data_sharing_consent_given |
새로운 필드 | YouTubeChannelInsights에 추가되었습니다. 크리에이터가 비공개 데이터 공유에 동의한 경우에 해당합니다. 이 경우 다음 필드가 채워집니다.
|
| 보고서 | ||
ad_sub_format_type |
새 세그먼트 | YouTube 인스트림 건너뛸 수 없는 광고를 재생 시간별로 분류합니다.
ad_format_type와 함께 선택해야 합니다. AdGroup, AdGroupAd, Campaign, Customer, Video, VideoEnhancement로 선택할 수 있습니다.
|
| 동영상 관련 소셜 측정항목 | 새 필드 / 측정항목 | 광고주가 YouTube의 Shorts 광고에 대한 사용자 참여도 (댓글, 좋아요, 공유)를 추적할 수 있도록 동영상별 소셜 측정항목이 추가되었습니다.
AdGroup, AdGroupAd, Asset, Campaign, Customer, Video에서 사용할 수 있습니다.
|
v24 주 버전 및 마이너 버전
Google Ads API v24에는 다음과 같은 새로운 기능, 업데이트, 브레이킹 체인지가 포함되어 있습니다.
v24.2 (2026-06-24)
Google Ads API v24.2에 다음과 같은 새로운 기능과 업데이트가 추가되었습니다. v24.2와 같은 마이너 버전에는 브레이킹 체인지가 포함되지 않습니다.
| 기능 및 업데이트 | 유형 | 설명 |
|---|---|---|
| 광고 | ||
AssetAutomationType.GENERATE_LANDING_PAGE_TEXT |
새 enum 값 | DemandGenVideoResponsiveAd 인스턴스 (이 API 버전부터 기본적으로 선택됨)의 참여 패널에 표시할 텍스트 정보를 방문 페이지에서 생성합니다. |
| 애셋 | ||
AssetGroup.google_local_services_info |
새로운 필드 | 실적 최대화 캠페인에서 지역 서비스 광고 정보 (카테고리 ID 및 콜아웃)를 지원하도록 추가되었습니다. |
AssetGroupSignal.local_services_id |
새로운 필드 | 실적 최대화 캠페인에서 지역 서비스 광고 서비스 ID 신호를 지원하기 위해 추가되었습니다. |
AssetGroupSignal.vertical_ads_item_group_rule_list |
새로운 필드 | 실적 최대화 캠페인에서 연결된 카테고리 피드의 상품을 선택하기 위한 카테고리 광고 상품 그룹 규칙을 지원하기 위해 추가되었습니다. 이 기능은 허용 목록에 있는 계정에서만 사용할 수 있습니다. |
AssetGroupErrorEnum.CANNOT_REMOVE_ALL_ASSET_GROUPS_FROM_CAMPAIGN |
새 enum 값 / 오류 | 캠페인에서 모든 애셋 그룹을 삭제하려고 할 때 반환됩니다. |
AssetGroupSignalErrorEnum.CANNOT_REMOVE_ALL_SIGNALS |
새 enum 값 / 오류 | 애셋 그룹에서 모든 신호를 삭제하려고 할 때 반환됩니다. |
| 캠페인 | ||
Campaign.PmaxCampaignSettings.local_services_pmax_campaign_settings Campaign.PmaxCampaignSettings.local_services_enabled |
새 필드 | 지역 서비스 실적 최대화 캠페인을 식별하는 데 도움이 됩니다. |
AdGroup.DemandGenAdGroupSettings.DemandGenChannelControls.DemandGenSelectedChannels.maps |
새로운 필드 | 디맨드젠 광고 그룹의 선택 가능한 채널에 Google 지도가 포함됩니다. |
CampaignCriterionErrorEnum.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN |
새 enum 값 / 오류 | 지역 서비스 실적 최대화 캠페인에서 모든 위치를 삭제하려고 할 때 반환됩니다. |
SmartCampaignErrorEnum.CREATION_FAILED |
새 enum 값 / 오류 | 새 스마트 캠페인을 만들려고 할 때 반환됩니다. |
| 전환수 | ||
ConversionOrigin.LOCAL_SERVICES_ADS ConversionActionType.LOCAL_SERVICES_ADS |
새 enum 값 | 사용자가 지역 서비스 광고를 클릭하고 광고주에게 전화, 메시지 또는 예약을 할 때 발생하는 전환을 나타냅니다. |
| 실험 | ||
COMPARE_CAMPAIGNS PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION |
새 enum 값 | 새로운 ExperimentType 유형에 대한 지원이 추가되었습니다.
|
| 일반 | ||
Asset.synthetic_content_info Ad.synthetic_content_info |
새 필드 | AI로 생성된 콘텐츠에 대한 증명을 포함하며, advertiser_attestation (광고주가 직접 제공한 선언) 및 system_attestation (시스템에서 자동으로 감지하거나 제공한 증명)로 구분됩니다.
이 기능은 v23 및 v22로 백포트되었습니다.
v25의 향후 통합 작업을 계획하는 데 도움이 되도록 광고주 증명 필드를 변경하는 인터페이스가 v22 이상에 조기 도입됩니다. 인터페이스는 이러한 버전에서 표시되지만 이러한 필드 중 하나에서 mutate 요청을 시도하면 다음 오류 중 하나가 반환됩니다. '변경하려는 필드는 변경할 수 없습니다' 또는 '필드를 설정할 수 없습니다' 이러한 필드는 v25부터 완전히 변경할 수 있게 됩니다. 지금 인터페이스를 사용하여 내부 로직을 빌드하고 테스트하여 v25가 출시될 때 시스템이 전체 쓰기 기능을 지원할 수 있도록 하는 것이 좋습니다. |
| 복수 사용자 승인 | 새로운 기능 |
복수 사용자 승인 (MPA) 검토에 대한 지원이 추가되었습니다.
이 기능은 v23.3, v22.2, v21.2로 백포팅되었습니다. |
IncentiveService.FetchIncentive |
행동 변화 | 요청에 잘못된 이메일 주소가 제공되면 이제 메서드가 AuthenticationError.INVALID_EMAIL_ADDRESS 오류를 발생시키는 대신 기본 인센티브 혜택을 반환하도록 원활하게 대체됩니다. |
| 계획 | ||
GenerateCreatorInsightsRequest.search_topics |
새로운 필드 | ContentCreatorInsightsService.GenerateCreatorInsights 서비스에 추가되었습니다. 이 옵션은 country_locations에 지정된 국가에서 특정 주제를 다루는 크리에이터를 검색합니다 (한 국가만 검색 지원). |
CREATOR_TOPIC_INSIGHTS |
새 enum 값 | 주제에 관해 이야기하는 크리에이터를 검색하기 위한 항목을 나타내기 위해 InsightsKnowledgeGraphEntityCapabilities에 추가되었습니다. 이러한 항목은 search_topics 필드에서 사용해야 합니다. AudienceInsightsService.ListAudienceInsightsAttributes를 사용하여 검색했습니다. |
KnowledgeGraphEntitySearchOptions |
새 유형 / 옵션 | 크리에이터 속성으로 지원되는 모든 주제를 검색하는 옵션과 기능별 필터링을 포함하여 ListAudienceInsightsAttributes의 주제에 대한 추가 검색 옵션이 포함되어 있습니다. |
GenerateCreatorInsightsRequest.supplemental_data GenerateTrendingInsightsRequest.supplemental_data |
새 필드 | ContentCreatorInsightsService 메서드의 선택적 입력입니다. 이 필드를 제공하면 응답에 추가 위치 또는 크리에이터 속성이 채워집니다. |
local_creator_insights related_local_creators |
새 필드 | supplemental_data에 LOCAL_CREATOR_DATA enum이 포함된 경우 채워집니다. 위치 데이터 공유에 동의한 현지 크리에이터를 선택한 국가에서 조회하거나 해당 국가에 거주하는 크리에이터를 표시합니다. |
GenerateTrendingInsightsRequest.sub_country_locations |
새로운 필드 | ContentCreatorInsightsService.GenerateTrendingInsights에 추가되어 국가 위치 및 하위 국가 위치를 사용하여 인기 급상승 통계를 검색할 수 있습니다. |
| 보고서 | ||
PerformanceMaxPlacementView |
세그먼트 확장 프로그램 | ad_network_type에 의해 세분화 가능해졌습니다. |
| 쇼핑 | ||
Campaign.ShoppingSetting.ignore_brand_exclusion_in_shopping_ads |
새로운 필드 | true인 경우 쇼핑 광고에서 브랜드 제외가 무시됩니다. 쇼핑 캠페인에서만 지원됩니다. |
| 타겟팅 | ||
CriterionErrorEnum.CANNOT_TARGET_LANGUAGE |
새 enum 값 / 오류 | 허용되지 않는 언어를 타겟팅하려고 할 때 반환됩니다. |
| 동영상 | ||
DataLink.youtube_link_metadata |
새로운 필드 | 연결된 YouTube 브랜드 채널의 ID를 지정하는 brand_channel_id를 포함합니다. |
v24.1 (2026-05-13)
Google Ads API v24.1에 다음 새로운 기능과 업데이트가 추가되었습니다. v24.1과 같은 부 버전에는 브레이킹 체인지가 포함되지 않습니다.
| 기능 및 업데이트 | 유형 | 설명 |
|---|---|---|
| 광고 | ||
DemandGenMultiAssetAdInfo.classic_display_images |
새로운 필드 | 추가 반응형 확장 소재 없이 게재되는 맞춤 업로드 디스플레이 이미지 |
| 실험 | ||
ADOPT_AI_MAX ADOPT_BROAD_MATCH_KEYWORDS OPTIMIZE_ASSETS PMAX_REPLACEMENT_SHOPPING |
새 enum 값 | 새 ExperimentType 유형에 대한 지원이 추가되었습니다.
|
Experiment.video_experiment |
새로운 필드 | 동영상 캠페인으로 구성된 기존 YOUTUBE_CUSTOM 실험에 대한 구성 지원 |
ExperimentArm.asset_testing_info ExperimentArm.asset_groups ExperimentArm.performance_max_experiment_arm_info |
새 필드 | 실험 부문에서 애셋 테스트, 애셋 그룹, 실적 최대화 캠페인 설정을 지원하는 필드를 노출합니다.
|
| 일반 | ||
CustomerUserAccess.passkey_enabled |
새로운 필드 | 사용자가 패스키를 사용 설정했는지 여부를 나타내는 읽기 전용 필드입니다. |
| 보고서 | ||
mobile_device_platform |
새 세그먼트 | 사용자 기기의 플랫폼 (예: iOS 또는 Android)별로 보고서를 분류할 수 있습니다. |
REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED |
새 enum 값 / 오류 | 요청된 일별, 시간별 또는 주별 시간 단위가 쿼리 기간에 지원되지 않는 경우 반환됩니다 (지난 37개월 동안만 사용 가능). |
vertical_ads_listing_user_rating vertical_ads_listing_venue |
새 세그먼트 | 카테고리 광고에 사용할 새 세그먼트입니다. |
user_rating, venue, event_participant_display_name |
새 필터 기준 | SharedCriterion 리소스의 VerticalAdsItemGroupRuleInfo에서 필터링을 지원합니다. |
| 대조군/실험군 실험 측정항목 | 새 필드 | 7가지 핵심 측정항목 계열 (클릭수, 노출수, 비용, 전환수, 전환당비용, 전환 가치, 비용당 전환 가치)에 걸쳐 관리 값 (control_clicks 등), 처리 값 (clicks 등), 점 추정치 (clicks_point_estimate 등), 오차 범위 (clicks_margin_of_error 등), p값 (clicks_p_value 등)이 추가되었습니다. |
| 전환 절대 변화 측정항목 | 새 필드 | 점 추정치, 오차 범위, p-값 필드를 사용하는 Conversions 절대 차이 추정치를 지원합니다. |
| 타겟팅 | ||
CriterionErrorEnum.CANNOT_EXCLUDE_ALL_TARGETS |
새 enum 값 / 오류 | 모든 인구통계 타겟을 제외하려고 할 때 반환됩니다. |
| 동영상 | ||
ThirdPartyViewabilityIntegrationPartnerEnum.ZEFR |
새 enum 값 | ZEFR을 서드 파티 조회가능성 통합 파트너로 게시했습니다. |
DataLink.youtube_video.channel_id |
새로운 필드 | 데이터 링크와 연결된 YouTube 채널 ID를 노출합니다. |
v24 (2026-04-22)
다음과 같은 새로운 기능, 업데이트, 브레이킹 체인지가 주요 버전인 Google Ads API v24에 추가되었습니다.
최신 버전으로 업그레이드에서 안내를 확인하세요.
브레이킹 체인지
| 초기 상태 | 새 상태 | 변경 유형 | 구현 안내 |
|---|---|---|---|
| 광고 | |||
DemandGenVideoResponsiveAdInfo의 선택사항 videos 및 logo_images |
필수 입력란 | 동작 변경 | 반응형 디맨드젠 캠페인 동영상 광고를 만들거나 변경할 때 videos 및 logo_images를 제공합니다. |
VideoResponsiveAdInfo의 선택사항 videos, business_name, logo_images |
필수 입력란 | 동작 변경 | 동영상 반응형 광고를 만들거나 변경할 때 videos, business_name, logo_images를 제공합니다. 이제 VideoResponsiveAdInfo가 변경 가능합니다. |
| 캠페인 | |||
Campaign.video_brand_safety_suitability |
없음 | 삭제 | 캠페인 수준의 적합성 관리가 삭제됩니다. 브랜드 안전성 적합성은 고객 수준에서 계속 사용할 수 있습니다. 대신 Customer.video_brand_safety_suitability를 사용하세요. |
| 전환수 | |||
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS |
없음 | 삭제 | 포인트 멤버십 가입 사용자 카테고리가 삭제되었습니다. 코드에서 해당 참조를 삭제합니다. |
| 계획 | |||
topic_audience_combinations의 InsightsAudienceAttributeGroup 유형 |
common.InsightsAudienceAttributeGroup 유형 |
동작 변경 / 유형 변경 | 입력된 클라이언트 라이브러리 통합은 새 리소스 네임스페이스를 사용하도록 업데이트해야 합니다. |
ReachPlanService.ListPlannableProducts의 youtube_select_lineups 필드 |
없음 | 삭제 | youtube_select_lineup_targeting의 라인업을 사용하도록 전환합니다. |
ContentCreatorInsightsService.GenerateCreatorInsights 및 GenerateTrendingInsights의 is_brand_connect_creator 필드 |
없음 | 삭제 | 대신 크리에이터가 partnership_opportunities에서 CREATOR_PARTNERSHIPS을 사용할 수 있는지 확인합니다. |
KeywordPlanIdeaService.GenerateKeywordForecastMetrics의 geo_modifiers 및 biddable_keywords |
geo_target_constants 및 keywords |
이름 바꾸기 / 삭제 | CampaignToForecast.geo_target_constants[] 및 ForecastAdGroup.keywords[]로 대체되었습니다. |
GenerateKeywordForecastMetrics에서 키워드 계획 / 예측 필드가 지원 중단됨 |
없음 | 삭제 | 다음 계획 / 예측 필드와 유형이 삭제되었습니다. 이에 따라 통합을 업데이트합니다. |
| 보고서 | |||
campaign_budget의 ad_sub_network_type 세그먼트 |
없음 | 삭제 | campaign_budget 리소스의 ad_sub_network_type 세그먼트가 삭제되었습니다. |
애셋 뷰의 click_type 세그먼트 |
없음 | 삭제 | AdGroupAsset, CampaignAsset, CustomerAsset 뷰에서 세그먼트가 삭제되었습니다. |
| 동영상 | |||
ShareablePreviewService.GenerateShareablePreviews에서 부분 실패 허용 |
부분 실패 없음 | 동작 변경 | 요청 내의 ID가 검증에 실패하면 요청이 실패하고 오류가 발생합니다. |
ShareablePreviewError 기존 코드:
|
MutateErrorEnum.RESOURCE_NOT_FOUND ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST |
이름 바꾸기 / 행동 변화 | 애셋 그룹에 대해 반환되는 오류 코드가 광고 그룹 광고 오류와 일치하도록 수정됩니다. 검증 catch 로직을 업데이트합니다. |
기능 및 업데이트 (브레이킹 아님)
| 기능 및 업데이트 | 유형 | 설명 |
|---|---|---|
| 광고 | ||
VideoResponsiveAdInfo의 변경 가능 여부 |
행동 변화 | 이제 반응형 동영상 광고 정보 객체를 변경할 수 있습니다. |
| 애셋 | ||
AssetSet의 travel_feed_data |
새로운 필드 | 여행 피드 확장 소재 속성 (hotel_center_account_id, merchant_center_id, partner_center_id, subset_id, travel_feed_vertical_type)을 가져오기 위해 추가되었습니다. |
| 캠페인 | ||
Campaign.view_through_conversion_optimization_enabled |
새로운 필드 | 디맨드젠 캠페인 및 앱 캠페인에서 조회 후 전환 (VTC) 최적화 (기본값 false)를 사용 설정할 수 있습니다. |
CampaignCriterion.gender |
새로운 기능 | 모든 Google Ads API 버전에서 실적 최대화 캠페인의 성별 제외가 사용 설정되었습니다. |
| 전환수 | ||
| 리드 생성 전환 유형 | 새 enum 값 | ConversionActionType에 새로운 GA4/Firebase 전환 액션 유형 enum이 추가되었습니다.
|
| 일반 | ||
UserListErrorEnum.DUPLICATE_LOOKALIKE |
새 enum 값 / 오류 | 동일한 유사 사용자 목록을 여러 개 만들려고 할 때 반환됩니다. |
| 계획 | ||
ListPlannableProductsResponse의 ProductCoreAttributes 필드 |
새 필드 | ListPlannableProductsResponse의 ProductCoreAttributes에 계획 가능한 제품 설명, 마케팅 목표, 비용 모델, 구매 방법이 추가되었습니다. |
| 보고서 | ||
CartDataSalesView |
새 보고 리소스 | 클릭한 제품 외에도 판매된 특정 제품 (브랜드 등)별로 전환 측정항목을 분류하는 보고서를 표시합니다. |
| 입찰에 사용되지 않는 측정항목 | 새 필드 | 일치하는 모든 리소스에 입찰에 사용되지 않는 측정항목 (캠페인에서 최적화하지 않는 전환을 보여주는 측정항목)이 추가되었습니다.
|
conversion_attribution_event_type |
새 세그먼트 | ShoppingPerformanceView에 추가되었습니다. |
| 쇼핑 | ||
ShoppingProduct의 앱 캠페인 |
새로운 기능 | ShoppingProduct 리소스 내에서 지원되는 앱 캠페인입니다. 메모 상태 및 문제는 지원되지 않습니다. |
| 태그 기반 제품 필터링 | 새로운 기능 | 논리 집합 표현식을 사용하여 동적으로 필터링을 도입했습니다.
|
v23 메이저 버전 및 마이너 버전
Google Ads API v23에는 다음과 같은 새로운 기능, 업데이트, 브레이킹 체인지가 포함되어 있습니다.
v23.3 (2026-06-24)
Google Ads API v23.3에 다음과 같은 새로운 기능과 업데이트가 추가되었습니다. v23.3과 같은 마이너 버전에는 브레이킹 체인지가 포함되지 않습니다.
| 기능 및 업데이트 | 유형 | 설명 |
|---|---|---|
| 일반 | ||
Asset.synthetic_content_info Ad.synthetic_content_info |
새 필드 | AI 생성 콘텐츠/합성 콘텐츠에 대한 증명을 포함하며, advertiser_attestation (광고주가 직접 제공한 선언) 및 system_attestation (Google 시스템에서 자동으로 감지하거나 제공한 증명)로 구분됩니다.
v25의 예정된 통합 작업을 계획하는 데 도움이 되도록 광고주 증명 필드를 변경하는 인터페이스가 v22 이상에 조기에 도입됩니다. 인터페이스는 이러한 버전에서 표시되지만 이러한 필드 중 하나에서 mutate 요청을 시도하면 다음 오류 중 하나가 반환됩니다. '변경하려는 필드는 변경할 수 없습니다' 또는 '필드를 설정할 수 없습니다' 이러한 필드는 v25부터 완전히 변경 가능해집니다. 지금 인터페이스를 사용하여 내부 로직을 빌드하고 테스트하여 v25가 출시될 때 시스템이 전체 쓰기 기능을 지원할 수 있도록 하는 것이 좋습니다. |
| 복수 사용자 승인 체계 | 새로운 기능 |
복수 사용자 승인 (MPA) 검토 지원이 추가되었습니다.
|
v23.2 (2026-03-25)
Google Ads API v23.2에 다음과 같은 새로운 기능과 업데이트가 추가되었습니다. v23.2와 같은 부 버전에는 브레이킹 체인지가 포함되지 않습니다.
| 기능 및 업데이트 | 유형 | 설명 |
|---|---|---|
| 애셋 | ||
VideoEnhancement |
새 리소스 | Google에서 생성했는지 또는 광고주가 제공했는지와 같은 개선 기능별 동영상 광고 정보를 포함합니다. 동영상 자동 개선 기능에 대한 정보에서 자세히 알아보세요. |
AppTopCombinationView |
새 리소스 | 앱 캠페인에서 실적이 우수한 애셋 조합에 대한 통계를 제공하는 읽기 전용 리소스입니다. |
CustomerAsset |
새로운 기능 | field_type가 BUSINESS_LOGO로 설정된 CustomerAsset를 가져오는 지원이 추가되었습니다. |
| 캠페인 | ||
AdGroupAd.start_date_time AdGroupAd.end_date_time |
새 필드 | 캠페인 날짜에 대해 더 세부적인 일정 제약 조건을 제공합니다. 일부 광고 그룹 유형에서만 지원됩니다. |
HotelSettingInfo.disable_hotel_setting |
새로운 필드 | 디맨드젠 캠페인에서 호텔 피드를 사용 중지할 수 있습니다. |
| 일반 | ||
CustomerClientLinkError |
새 enum 값 / 오류 | MAX_CUSTOMER_LIMIT_REACHED 및 ACCOUNT_CREATION_POLICY_VIOLATION이라는 두 개의 새로운 오류 코드가 추가되었습니다. |
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS |
동작 변경 | 지원 중단된 사용자 목록 고객 유형 카테고리를 사용하려고 하면 오류가 발생합니다. |
| 계획 | ||
GenerateTrendingInsights GenerateCreatorInsights |
새로운 기능 | 엔티티, 주제, 잠재고객의 맞춤 AND/OR 조합에 대한 지원이 추가되었습니다. |
ReachPlanService.GenerateReachForecast |
새 enum 값 | 타겟팅 가능한 새 연령대(예: AGE_RANGE_21_44 또는 AGE_RANGE_21_49)가 추가되었습니다. |
youtube_select_lineup_targeting |
새로운 필드 | youtube_select_lineups을 대체할 ReachPlanService.ListPlannableProducts에 추가되었습니다. 현재 두 필드가 모두 채워져 있습니다. |
ReachPlanSurface |
새 enum 값 | IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS가 표시 경로 옵션으로 추가되었습니다. |
Forecast |
새로운 필드 | ReachPlanService.GenerateReachForecast에서 디맨드젠 캠페인 클릭수 최대화 (CPC)에 clicks가 추가되었습니다. |
partnership_opportunities |
새로운 필드 | ContentCreatorInsightsService.GenerateCreatorInsights 및 ContentCreatorInsightsService.GenerateTrendingInsights에 추가되었습니다. |
| 보고서 | ||
biddable_indirect_install_first_in_app_conversion_micros |
새로운 필드 | Campaign, Customer, AdGroup 리소스에 추가되었습니다. |
| 동영상 | ||
ShareablePreviewService |
새로운 기능 | preview_type를 YOUTUBE_LIVE_PREVIEW로 설정하여 YouTube 라이브 스트리밍 미리보기를 지원하도록 확장되었습니다. UNSUPPORTED_AD_TYPE 및 TOO_MANY_RESOURCES_IN_REQUEST을 ShareablePreviewError에 추가했습니다. 일부 광고 유형에서만 지원됩니다. |
v23.1 (2026-02-25)
Google Ads API v23.1에 다음과 같은 새로운 기능과 업데이트가 추가되었습니다. v23.1과 같은 부 버전에는 브레이킹 체인지가 포함되지 않습니다.
| 기능 및 업데이트 | 유형 | 설명 |
|---|---|---|
| 계정 관리 | ||
advertising_partner_properties.allowed_domain |
새로운 필드 | ProductLinkInvitation 및 ProductLink 리소스에 추가되었습니다. 광고 파트너는 이 도메인에서만 광고할 수 있습니다. |
Customer.contains_eu_political_advertising |
새로운 필드 | EU를 타겟팅하는 정치 광고가 포함되어 있는지 여부에 대한 계정 수준 선언 상태를 가져오고 EuPoliticalAdvertisingStatus를 반환합니다. |
| 캠페인 | ||
Campaign.text_guidelines |
새로운 필드 | 실적 최대화 캠페인 및 검색 캠페인과 함께 사용하여 AI 생성 텍스트 애셋을 프로그래매틱 방식으로 관리할 수 있는 광고 문구 가이드라인에 대한 지원이 추가되었습니다. text_guidelines 내에서 term_exclusions 및 messaging_restrictions를 정의할 수 있습니다. |
CampaignPrimaryStatusReason |
새 enum 값 | FIXED_CPM 입찰 전략을 사용하는 캠페인의 기본 상태 이유를 제공하기 위해 CAMPAIGN_NOT_BOOKED, BOOKING_HOLD_EXPIRING, BOOKING_HOLD_EXPIRED, BOOKING_CANCELLED가 추가되었습니다. |
Campaign.VideoCampaignSettings.reservation_ad_category_self_disclosure Campaign.VideoCampaignSettings.booking_details |
새 필드 | 예약 광고 카테고리 직접 공개 및 읽기 전용 예약 세부정보에 대한 지원이 추가되었습니다. |
Campaign.missing_eu_political_advertising_declaration |
새로운 필드 | EU를 타겟팅하는 정치 광고가 포함되어 있는지에 대한 선언이 누락된 캠페인을 쿼리하고 필터링할 수 있습니다. |
| 전환수 | ||
ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS |
새 enum 값 | 광고를 시청한 후 동일한 채널의 동영상을 시청하는 사용자를 추적할 수 있습니다. |
| 일반 | ||
CriterionErrorEnum.CANNOT_TARGET_ONLY_UNDETERMINED |
새 enum 값 / 오류 | 인구통계 측정기준에서 알 수 없는 카테고리만 타겟팅하려고 할 때 반환됩니다. |
| 인센티브 | ||
IncentiveErrorEnum |
새 enum 값 / 오류 | 새로운 오류 코드 MAX_INCENTIVES_REDEEMED 및 ACCOUNT_TOO_OLD가 추가되었습니다. 이러한 오류는 2026년 3월 11일 이후에 이루어진 요청에 대해 반환될 수 있습니다. |
| 계획 | ||
GenerateBenchmarksMetrics |
새로운 기능 | BreakdownDefinition를 사용한 날짜 분류 지원이 추가되었습니다. |
ReachPlanService.GenerateReachForecast |
새 enum 값 | GOOGLE_DISPLAY_NETWORK이 디맨드젠 캠페인 전환수 최대화의 타겟팅 가능한 표시 경로로 추가되었습니다. |
GenerateTrendingInsights |
새 필드 | 주제로 검색할 때 TrendInsightDataPoint에서 TrendInsights까지의 이전 추세선 정보가 추가되었습니다. |
| 보고서 | ||
| 순 사용자 게재빈도 측정항목 | 새 필드 | 광고를 2회, 3회, 4회, 5회 또는 10회 이상 본 사용자 수를 보고하는 새로운 측정항목(unique_users_two_plus, unique_users_three_plus, unique_users_four_plus, unique_users_five_plus, unique_users_ten_plus)이 추가되었습니다. |
SearchTermMatchSource |
새 enum 값 | 여행 광고 항목 타겟팅과 같은 카테고리 광고 데이터 피드를 지원하기 위해 VERTICAL_ADS_DATA_FEED를 추가했습니다. |
| YouTubeVideoUpload | ||
YouTubeVideoUpload |
새 서비스 / 리소스 | YouTube에서 동영상을 업로드하고 관리할 수 있도록 YouTubeVideoUpload 서비스를 추가하고, 업로드 상태 및 메타데이터를 가져올 수 있도록 YouTubeVideoUpload 리소스를 추가했습니다. 이 기능은 REST 및 Python 클라이언트 라이브러리에서만 지원됩니다. |
v23 (2026-01-28)
다음 새로운 기능, 업데이트, 호환성이 깨지는 변경사항이 메이저 버전인 Google Ads API v23에 추가되었습니다.
최신 버전으로 업그레이드에서 안내를 확인하세요.
브레이킹 체인지
| 초기 상태 | 새 상태 | 변경 유형 | 구현 안내 |
|---|---|---|---|
| 광고 | |||
| 광고 공유 허용됨 | AdGroupAdError.AD_SHARING_NOT_ALLOWED |
동작 변경 | 여러 광고 그룹 간의 광고 공유는 더 이상 허용되지 않습니다. 광고를 공유하려고 시도하는 요청은 AD_SHARING_NOT_ALLOWED 오류를 반환합니다. |
CallAd 및 CallAdInfo 지원 |
없음 | 삭제 | 전화 유도 광고에 대한 지원이 중단되었습니다. 통화 광고 정보 고객센터 도움말을 참고하세요. |
| 캠페인 | |||
Campaign.start_date Campaign.end_date |
Campaign.start_date_time Campaign.end_date_time |
이름 바꾸기 / 교체 | 새 날짜-시간 필드를 사용하여 캠페인의 시간 구성요소를 지정합니다. 원본 날짜 전용 필드가 삭제됩니다. |
| 디맨드젠 캠페인 | |||
DemandGenMultiAssetAdInfo.lead_form_only |
없음 | 삭제 | lead_form_only 필드가 삭제되었습니다. 코드에서 참조를 업데이트합니다. |
| 보고서 | |||
| 애셋 실적 라벨 측정항목 및 enum 집계 | 없음 | 삭제 | 집계된 애셋 실적 라벨 측정항목이 삭제되었습니다. 성능 라벨 enum이 더 이상 검색 및 디스플레이에 반환되지 않습니다. |
기능 및 업데이트 (호환성 유지)
| 기능 및 업데이트 | 유형 | 설명 |
|---|---|---|
| 광고 | ||
AdFormatType |
새 enum 값 | TEXT, VERTICAL_ADS_BOOKING_LINK, VERTICAL_ADS_PROMOTION 형식 유형이 추가되었습니다. |
| 애셋 | ||
asset_group 보기 |
새 필드 | metrics.engagements, metrics.engagement_rate, metrics.average_cpe 측정항목이 추가되었습니다. |
asset_group_asset 조회수 |
새 필드 | metrics.average_cpe, metrics.average_cpm, metrics.trueview_average_cpv, metrics.video_trueview_view_rate, metrics.video_trueview_views, metrics.interaction_event_types 측정항목이 추가되었습니다. |
Asset.orientation |
새로운 필드 | 이미지 및 동영상 애셋에 읽기 전용 방향 필드가 추가되었습니다. |
CampaignAsset |
새로운 기능 | field_type이 HEADLINE 및 DESCRIPTION로 설정된 캠페인 확장 소재를 가져오는 지원이 추가되었습니다. |
ServedAssetFieldType |
새 enum 값 | 사이트링크로 게재되는 확장 소재에 HEADLINE_AS_SITELINK_POSITION_ONE, HEADLINE_AS_SITELINK_POSITION_TWO, DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE, DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO가 추가되었습니다. |
BusinessMessageAsset |
새로운 기능 / 지원 | 업데이트된 비즈니스 메시지 확장 소재:
|
| 결제 | ||
InvoiceService.ListInvoices |
새 옵션 | 이제 ListInvoicesRequest에서 include_granular_level_invoice_details을 설정하여 캠페인 수준 비용 분석, 항목별 규제 비용, 조정 정보를 비롯한 더 세부적인 세부정보를 Invoice에서 반환할 수 있습니다. |
RegulatoryFeeType UnitOfMeasure |
새 enum | 규제 수수료 및 측정 단위에 대한 도우미 enum이 추가되었습니다. |
| 캠페인 | ||
CampaignError |
새 enum 값 / 오류 | DURATION_TOO_LONG_FOR_TOTAL_BUDGET 및 END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET 오류 코드가 추가되었습니다. |
| 전환수 | ||
| ConversionActionCategory | 새 enum 값 | 광고를 시청한 후 동일한 채널의 동영상을 시청하는 사용자를 추적할 수 있도록 YOUTUBE_FOLLOW_ON_VIEWS가 추가되었습니다. |
| 디맨드젠 캠페인 | ||
DemandGenVideoResponsiveAdInfo.companion_banner |
새로운 필드 | 디맨드젠 캠페인 반응형 동영상 광고에 컴패니언 배너 지원이 추가되었습니다. |
| 인센티브 | ||
선택형 (CYO) 인센티브 지원이 추가되었습니다.
실패를 더 세부적으로 프로그래매틱 방식으로 처리할 수 있도록 향후 출시에서 |
||
| 계획 | ||
AudienceInsightsDimension.LIFE_EVENT_USER_INTEREST |
새 enum 값 | GenerateAudienceCompositionInsights, GenerateSuggestedTargetingInsights, GenerateInsightsFinderReport, GenerateCreatorInsights에서 생애 주요 이벤트를 사용하여 잠재고객을 구축할 수 있습니다.
|
ReachPlanService.GenerateConversionRates |
새 필드 / 옵션 | 이제 응답에 표시 경로 제어 (예: Gmail, Shorts)를 기반으로 전환율 추천을 지원하는 표시 경로가 포함됩니다. 디맨드젠 캠페인에서만 지원됩니다. |
LanguageDistribution |
새 필드 / 유형 | YouTube 채널 콘텐츠의 언어 분포 세부정보를 제공하기 위해 YouTubeChannelInsights에 추가되었습니다. |
BenchmarksService |
새 서비스 | YouTube 광고 데이터를 업계 벤치마킹과 비교합니다. |
AudienceInsightsService.GenerateAudienceDefinition |
새로운 방법 | 생성형 AI를 사용하여 타겟 고객의 자유 형식 텍스트 설명을 일치하는 잠재고객 속성으로 변환합니다. |
YouTubeChannelInsights.relevance_score |
새로운 필드 | 조회수를 기준으로 가중치를 부여하여 크리에이터가 주제와 얼마나 관련성이 있는지 평가합니다. |
TrendInsightMetrics.trend_change_percent |
새로운 필드 | 비교 기간 동안 트렌드 값의 변동률을 나타냅니다. |
| 추천 | ||
GenerateRecommendationsRequest |
새로운 필드 | is_new_customer을 추가했습니다. CAMPAIGN_BUDGET 추천에 대해 true로 설정하면 신규 고객에 최적화된 모델을 사용합니다 (캠페인이 없는 고객에게만 권장됨). |
| 보고서 | ||
AdGroupAdAssetView |
새 기능 / 측정항목 지원 | 이제 RESPONSIVE_DISPLAY_AD의 노출수, 실적, 전환 측정항목을 지원합니다. |
ad_sub_network_type 세그먼트 |
새 세그먼트 | 광고 네트워크 내의 세부적인 실적 분석을 제공합니다. 처음에는 YouTube의 디맨드젠 캠페인 (인스트림, 인피드, Shorts)에서 사용할 수 있습니다. ad_network_type와 함께 선택해야 합니다. |
| 실적 최대화 캠페인 보고 | 새로운 기능 | 실적 최대화 캠페인에 광고 네트워크 유형 분류를 사용 설정했습니다. |
UserLocationView GeographicView |
새 세그먼트 지원 | 전환 날짜별로 분류된 측정항목(conversions_by_conversion_date, all_conversions_by_conversion_date, conversions_value_by_conversion_date, all_conversions_value_by_conversion_date, value_per_conversions_by_conversion_date, value_per_all_conversions_by_conversion_date, cross_device_conversions_by_conversion_date, cross_device_conversions_value_by_conversion_date)을 지원합니다. |
| 카테고리 광고 세그먼트 | 새 세그먼트 | vertical_ads_event_participant_display_names, vertical_ads_hotel_class, vertical_ads_listing, vertical_ads_listing_brand, vertical_ads_listing_city, vertical_ads_listing_country, vertical_ads_listing_region, vertical_ads_partner_account, vertical_ads_vertical 세그먼트가 추가되었습니다. |
PerStoreView MatchedLocationInterestView |
새로운 보고 리소스 | PerStoreView를 추가하여 매장 위치 세부정보를 쿼리하고 MatchedLocationInterestView (AI Max 캠페인용)를 추가하여 관심 있는 지리적 위치별로 실적 측정항목을 제공했습니다. |
| 쇼핑 | ||
ShoppingPerformanceView |
새 측정항목 지원 | 이제 전환 날짜별로 분류된 conversions_by_conversion_date, all_conversions_by_conversion_date, conversions_value_by_conversion_date, value_per_conversions_by_conversion_date, value_per_all_conversions_by_conversion_date 측정항목이 지원됩니다. |
ShoppingPerformanceView |
새 측정항목 지원 | search_budget_lost_impression_share, search_rank_lost_impression_share, search_budget_lost_absolute_top_impression_share, search_rank_lost_absolute_top_impression_share에 대한 지원이 추가되었습니다. |
ShoppingProduct.product_image_uri |
새로운 필드 | ShoppingProduct에 추가되었습니다. |
| 세로형 광고 | ||
AdGroup.vertical_ads_format_setting |
새로운 필드 | 여행 피드를 사용하는 검색 캠페인에서 게재할 수 있는 광고 형식을 관리할 수 있습니다. |
AdGroupCriterion SharedCriterion |
새 필드 / 기준 | 여행 피드가 있는 검색 캠페인에서 상품 그룹을 타겟팅할 수 있도록 AdGroupCriterion 및 vertical_ads_item_group_rule에 vertical_ads_item_group_rule_list 기준 유형을 SharedCriterion에 추가했습니다. |
| 카테고리 광고 데이터 피드 통합 | 새로운 기능 | 이제 카테고리별 광고 데이터 피드를 AI Max를 실행하는 검색 캠페인에 연결하여 숙박 시설 프로모션 및 예약 링크 여행 광고를 텍스트 광고와 함께 게재할 수 있습니다. vertical_ads_format_setting로 형식을 제어하고 vertical_ads_item_group_rule를 사용하여 규칙을 정의합니다. AdFormatType 및 카테고리 광고 데이터 피드 측정기준별로 보고서를 분류합니다. |
| 동영상 | ||
AdVideoAssetInfo.ad_video_asset_feature_control |
새로운 필드 | 동영상 광고 확장 소재의 기능 제어 옵션이 추가되었습니다. |
CampaignCriterionError |
새 enum 값 / 오류 | INVALID_VIDEO_LINEUP_ID 오류 코드가 추가되었습니다. |
| YouTube 가청성 측정항목 | 새 측정항목 | YouTube 오디오 광고에 청취 가능 여부 측정항목이 추가되어 광고가 청취 가능했는지 여부와 청취 가능 여부를 측정할 수 있는 노출수를 보고합니다. |
보관처리된 출시 노트
보관처리된 출시 노트는 지원 종료된 버전을 참고하세요.