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 메서드를 사용하여 다음 Google Ads Query Language 쿼리를 실행하면 선언되지 않은 캠페인 목록을 가져올 수 있습니다.
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 |