پشتیبانی از «مقررات آگهی‌های سیاسی اتحادیه اروپا»

در اکتبر ۲۰۲۵، Google پیش‌از اجرایی شدن مقررات جدید آگهی‌های سیاسی، ارائه تبلیغات سیاسی را در اتحادیه اروپا متوقف کرد. این راهنما پشتیبانی از «مقررات آگهی‌های سیاسی اتحادیه اروپا» را در Google Ads API خلاصه می‌کند.

پشتیبانی از خوداظهاری آگهی‌های سیاسی اتحادیه اروپا

‫Google Ads API از خوداظهاری پویش برای آگهی‌های سیاسی اتحادیه اروپا بااستفاده از فیلد contains_eu_political_advertising پشتیبانی می‌کند. مقادیر ممکن و معنی آن‌ها در جدول زیر نشان داده شده است.

مقدار	معنی
CONTAINS_EU_POLITICAL_ADVERTISING	پویش دارای آگهی‌های سیاسی اتحادیه اروپا است.
DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING	پویش آگهی‌های سیاسی اتحادیه اروپا ندارد.
UNSPECIFIED	پویش فاقد خوداظهاری درباره آگهی‌های سیاسی اتحادیه اروپا است.

می‌توانید وضعیت خوداظهاری پویش را در Google Ads API با اجرای پُرسمان زیر بااستفاده از روش‌های Search یا SearchStream مربوط به GoogleAdsService بازیابی کنید.

select campaign.id, campaign.contains_eu_political_advertising from campaign

اعتبارسنجی و اجرای میانای برنامه‌سازی کاربردی در سطح پویش

همه پویش‌های جدیدی که ازطریق Google Ads API ایجاد می‌شوند باید فیلد contains_eu_political_advertising را تنظیم کنند. اگر این فیلد تنظیم نشده باشد، فراخوانی میانای برنامه‌سازی کاربردی برای ایجاد کمپین جدید بااستفاده از CampaignService.MutateCampaigns با خطای FieldError.REQUIRED ناموفق خواهد بود.

توجه: از v26، contains_eu_political_advertising برای پویش‌هایی که اتحادیه اروپا را به‌طور مثبت هدف‌یابی نمی‌کنند (حاوی هیچ معیار مثبت مکان، مجاورت، یا گروه مکان اتحادیه اروپا نیستند و حداقل یک معیار مثبت مکان خارج از اتحادیه اروپا دارند) اختیاری است. در نسخه‌های قبلی API، این فیلد برای همه پویش‌های جدید الزامی است.

همه پویش‌های موجود باید قبل‌از تلاش برای تغییر هدف‌یابی proximity، location، یا location_group در سطح پویش یا گروه آگهی، فیلد contains_eu_political_advertising را تنظیم کنند. اگر پویش خوداظهاری را تکمیل نکرده باشد، فراخوانی میانای برنامه‌سازی کاربردی برای ایجاد یا به‌روزرسانی این معیارهای پویش بااستفاده از روش CampaignCriterionService.MutateCampaignCriteria برای پویش‌های موجود با خطای CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION ناموفق می‌شود. اگر پویش خوداظهاری را تکمیل نکرده باشد، فراخوانی میانای برنامه‌سازی کاربردی برای ایجاد یا به‌روزرسانی این معیارهای گروه آگهی بااستفاده از روش AdGroupCriterionService.MutateAdGroupCriteria نیز به‌طور مشابه ناموفق خواهد بود.

این اقدامات اجرایی برای سازوکارهای دیگری که می‌توانید برای ایجاد پویش‌ها استفاده کنید نیز اعمال می‌شود، مانند اجرای کارهای دسته‌ای و استفاده از روش GoogleAdsService.Mutate برای ایجاد و به‌روزرسانی نهادها. اگر اعلامیه contains_eu_political_advertising در پویش‌های پیش‌نویس درمان وجود نداشته باشد، تلاش برای زمان‌بندی آزمایش جدید بااستفاده از روش ExperimentService.ScheduleExperiment خطای ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION را ایجاد می‌کند.

تغییرات در اعتبارسنجی و اجرای میانای برنامه‌سازی کاربردی در سطح حساب

از ۱ آوریل ۲۰۲۶، اگر حساب Google Ads یک یا چند پویش اعلام‌نشده داشته باشد، Google Ads API همه فراخوانی‌های تغییر مربوط به مدیریت پویش را با خطای MutateError.EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED رد می‌کند. همه فراخوانی‌های دیگر—مانند گزارش‌دهی، مدیریت حساب، یا برنامه‌ریز کلیدواژه—بدون تأثیرپذیری به کار خود ادامه می‌دهند. فهرست کامل روش‌ها را ببینید.

نحوه اعلام پویش‌های اعلام‌نشده موجود

برای اعلام پویش‌های اعلام‌نشده موجود، فهرست پویش‌های واجدشرایط را بازیابی کنید و اعلامیه آن‌ها را بااستفاده از روش CampaignService.MutateCampaigns، روش GoogleAdsService.Mutate، یا BatchJobService روی contains_eu_political_advertising تنظیم کنید. این روش‌ها با خطای MutateError.EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED مواجه نخواهند شد تا زمانی که فقط فیلد contains_eu_political_advertising پویش را به‌روز کنید.

می‌توانید فهرست کمپین‌های اعلام‌نشده را با اجرای پُرسمان «زبان پُرسمان Google Ads» زیر بااستفاده از روش‌های Search یا SearchStream مربوط به GoogleAdsService بازیابی کنید.

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

همچنین می‌توانید پویش‌های اعلام‌نشده را در سطح حساب Google Ads بااستفاده از میانای کاربری Google Ads اعلام کنید. وضعیت اظهارنامه سطح حساب را می‌توان بااستفاده از فیلد contains_eu_political_advertising شیء Customer بازیابی کرد.

تأثیر بر ارائه پویش

هر پویشی که با تنظیم کردن contains_eu_political_advertising روی true اعلام کرده باشد که آگهی‌های سیاسی اتحادیه اروپا دارد، ارائه آگهی در اتحادیه اروپا را متوقف خواهد کرد. بیشتر بدانید.

پویش‌های موجود بدون اظهارنامه درحال‌حاضر تحت تأثیر قرار نخواهند گرفت.

فهرست روش‌های اجراشده

همه روش‌هایی که برای مدیریت پویش 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