유럽연합 정치 광고 규정 지원

2025년 10월, Google은 새로운 정치 광고 규정에 앞서 유럽연합에서 정치 광고 게재를 중단했습니다. 이 가이드에서는 Google Ads API에서 EU 정치 광고 규정을 지원하는 방법을 간략하게 설명합니다.

EU 정치 광고 자체 선언 지원

Google Ads API는 contains_eu_political_advertising 필드를 사용하여 EU 정치 광고에 대한 캠페인을 자체 선언하는 것을 지원합니다. 가능한 값과 그 의미는 다음 표에 나와 있습니다.

값	의미
CONTAINS_EU_POLITICAL_ADVERTISING	캠페인에 EU 정치 광고가 있습니다.
DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING	캠페인에 EU 정치 광고가 없습니다.
UNSPECIFIED	캠페인에 EU 정치 광고에 대한 자체 신고가 누락되었습니다.

GoogleAdsService의 Search 또는 SearchStream 메서드를 사용하여 다음 쿼리를 실행하면 Google Ads API에서 캠페인의 자체 선언 상태를 가져올 수 있습니다.

select campaign.id, campaign.contains_eu_political_advertising from campaign

캠페인 수준 API 검증 및 시행

Google Ads API를 통해 생성된 모든 새 캠페인은 contains_eu_political_advertising 필드를 설정해야 합니다. CampaignService.MutateCampaigns를 사용하여 새 캠페인을 만드는 API 호출은 이 필드가 설정되지 않은 경우 FieldError.REQUIRED 오류와 함께 실패합니다.

기존 캠페인은 캠페인 또는 광고 그룹 수준에서 proximity, location 또는 location_group 타겟팅을 변경하기 전에 contains_eu_political_advertising 필드를 설정해야 합니다. 캠페인에서 자체 선언을 완료하지 않은 경우 기존 캠페인에 CampaignCriterionService.MutateCampaignCriteria 메서드를 사용하여 이러한 캠페인 기준을 만들거나 업데이트하는 API 호출이 CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION 오류와 함께 실패합니다. AdGroupCriterionService.MutateAdGroupCriteria 메서드를 사용하여 이러한 광고 그룹 기준을 만들거나 업데이트하는 API 호출도 캠페인에서 자체 선언을 완료하지 않은 경우 유사한 방식으로 실패합니다.

이러한 시행은 일괄 작업을 실행하고 GoogleAdsService.Mutate 메서드를 사용하여 엔티티를 만들고 업데이트하는 등 캠페인을 만드는 데 사용할 수 있는 다른 메커니즘에도 적용됩니다. ExperimentService.ScheduleExperiment 메서드를 사용하여 새 실험을 예약하려고 하면 처리 버전 임시 캠페인에 contains_eu_political_advertising 선언이 누락된 경우 ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION 오류가 발생합니다.

계정 수준 API 검증 및 시행 변경사항

2026년 4월 1일부터 Google Ads 계정에 신고되지 않은 캠페인이 하나 이상 있는 경우 Google Ads API는 캠페인 관리와 관련된 모든 변경 호출을 MutateError.EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED 오류와 함께 실패합니다. 보고, 계정 관리, 키워드 플래너와 같은 다른 모든 호출은 영향을 받지 않고 계속 작동합니다. 전체 메서드 목록을 참고하세요.

선언되지 않은 기존 캠페인을 선언하는 방법

선언되지 않은 기존 캠페인을 선언하려면 자격 요건을 충족하는 캠페인 목록을 가져오고 CampaignService.MutateCampaigns 메서드, GoogleAdsService.Mutate 메서드 또는 BatchJobService를 사용하여 contains_eu_political_advertising 선언을 설정합니다. 캠페인의 contains_eu_political_advertising 필드만 업데이트하는 한 이러한 메서드는 MutateError.EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED 오류로 실패하지 않습니다.

GoogleAdsService의 Search 또는 SearchStream 메서드를 사용하여 다음 GAQL 쿼리를 실행하여 선언되지 않은 캠페인 목록을 가져올 수 있습니다.

select campaign.id
  from
    campaign
  where
    campaign.missing_eu_political_advertising_declaration = true

Google Ads UI를 사용하여 Google Ads 계정 수준에서 선언되지 않은 캠페인을 선언할 수도 있습니다. 계정 수준 선언 상태는 Customer 객체의 contains_eu_political_advertising 필드를 사용하여 가져올 수 있습니다.

캠페인 게재에 미치는 영향

contains_eu_political_advertising을 true로 설정하여 EU 정치 광고를 선언한 캠페인은 EU에서 광고 게재가 중단됩니다. 자세히 알아보기

선언이 없는 기존 캠페인은 현재 영향을 받지 않습니다.

시행된 메서드 목록

Google Ads 캠페인 관리에 사용되는 모든 방법은 계정 수준 검증 및 시행의 영향을 받습니다. 전체 메서드 목록은 다음 표에 나와 있습니다.

서비스	메서드
AdGroupAdLabelService	MutateAdGroupAdLabels
AdGroupAdService	MutateAdGroupAds
AdGroupAdService	RemoveAutomaticallyCreatedAssets
AdGroupAssetService	MutateAdGroupAssets
AdGroupAssetSetService	MutateAdGroupAssetSets
AdGroupBidModifierService	MutateAdGroupBidModifiers
AdGroupCriterionCustomizerService	MutateAdGroupCriterionCustomizers
AdGroupCriterionLabelService	MutateAdGroupCriterionLabels
AdGroupCriterionService	MutateAdGroupCriteria
AdGroupCustomizerService	MutateAdGroupCustomizers
AdGroupLabelService	MutateAdGroupLabels
AdGroupService	MutateAdGroups
AdParameterService	MutateAdParameters
AdService	MutateAds
AssetGroupAssetService	MutateAssetGroupAssets
AssetGroupListingGroupFilterService	MutateAssetGroupListingGroupFilters
AssetGroupService	MutateAssetGroups
AssetGroupSignalService	MutateAssetGroupSignals
AssetService	MutateAssets
AssetSetAssetService	MutateAssetSetAssets
AssetSetService	MutateAssetSets
AudienceService	MutateAudiences
AutomaticallyCreatedAssetRemovalService	RemoveCampaignAutomaticallyCreatedAsset
BiddingDataExclusionService	MutateBiddingDataExclusions
BiddingSeasonalityAdjustmentService	MutateBiddingSeasonalityAdjustments
BiddingStrategyService	MutateBiddingStrategies
CampaignAssetService	MutateCampaignAssets
CampaignAssetSetService	MutateCampaignAssetSets
CampaignBidModifierService	MutateCampaignBidModifiers
CampaignBudgetService	MutateCampaignBudgets
CampaignConversionGoalService	MutateCampaignConversionGoals
CampaignCriterionService	MutateCampaignCriteria
CampaignCustomizerService	MutateCampaignCustomizers
CampaignDraftService	ListCampaignDraftAsyncErrors
CampaignDraftService	MutateCampaignDrafts
CampaignDraftService	PromoteCampaignDraft
CampaignGoalConfigService	MutateCampaignGoalConfigs
CampaignGroupService	MutateCampaignGroups
CampaignLabelService	MutateCampaignLabels
CampaignLifecycleGoalService	ConfigureCampaignLifecycleGoals
CampaignService	EnablePMaxBrandGuidelines
CampaignService	MutateCampaigns
CampaignSharedSetService	MutateCampaignSharedSets
ConversionActionService	MutateConversionActions
ConversionAdjustmentUploadService	UploadConversionAdjustments
ConversionCustomVariableService	MutateConversionCustomVariables
ConversionGoalCampaignConfigService	MutateConversionGoalCampaignConfigs
ConversionValueRuleService	MutateConversionValueRules
ConversionValueRuleSetService	MutateConversionValueRuleSets
CustomAudienceService	MutateCustomAudiences
CustomConversionGoalService	MutateCustomConversionGoals
CustomInterestService	MutateCustomInterests
CustomerAssetService	MutateCustomerAssets
CustomerAssetSetService	MutateCustomerAssetSets
CustomerConversionGoalService	MutateCustomerConversionGoals
CustomerCustomizerService	MutateCustomerCustomizers
CustomerLabelService	MutateCustomerLabels
CustomerLifecycleGoalService	ConfigureCustomerLifecycleGoals
CustomerNegativeCriterionService	MutateCustomerNegativeCriteria
CustomerSkAdNetworkConversionValueSchemaService	MutateCustomerSkAdNetworkConversionValueSchema
CustomizerAttributeService	MutateCustomizerAttributes
ExperimentArmService	MutateExperimentArms
ExperimentService	EndExperiment
ExperimentService	GraduateExperiment
ExperimentService	ListExperimentAsyncErrors
ExperimentService	MutateExperiments
ExperimentService	PromoteExperiment
ExperimentService	ScheduleExperiment
FeedService	MutateFeeds
GoalService	MutateGoals
LabelService	MutateLabels
LocalServicesLeadService	AppendLeadConversation
LocalServicesLeadService	ProvideLeadFeedback
OfflineUserDataJobService	AddOfflineUserDataJobOperations
OfflineUserDataJobService	CreateOfflineUserDataJob
OfflineUserDataJobService	RunOfflineUserDataJob
RecommendationService	ApplyRecommendation
RecommendationService	DismissRecommendation
RecommendationSubscriptionService	MutateRecommendationSubscription
RemarketingActionService	MutateRemarketingActions
SharedCriterionService	MutateSharedCriteria
SharedSetService	MutateSharedSets
SmartCampaignSettingService	MutateSmartCampaignSettings
UserListCustomerTypeService	MutateUserListCustomerTypes
UserDataService	UploadUserData
UserListService	MutateUserLists