در اکتبر ۲۰۲۵، گوگل پیش از وضع مقررات جدید تبلیغات سیاسی ، ارائه تبلیغات سیاسی در اتحادیه اروپا را متوقف کرد . این راهنما خلاصهای از پشتیبانی از مقررات تبلیغات سیاسی اتحادیه اروپا در API تبلیغات گوگل را ارائه میدهد.
پشتیبانی از خوداظهاری تبلیغات سیاسی اتحادیه اروپا
API تبلیغات گوگل از خوداظهاری یک کمپین برای تبلیغات سیاسی اتحادیه اروپا با استفاده از فیلد contains_eu_political_advertising پشتیبانی میکند. مقادیر ممکن و معنی آنها در جدول زیر نشان داده شده است.
| ارزش | معنی |
|---|---|
CONTAINS_EU_POLITICAL_ADVERTISING | این کمپین شامل تبلیغات سیاسی اتحادیه اروپا است. |
DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING | این کمپین تبلیغات سیاسی اتحادیه اروپا ندارد. |
UNSPECIFIED | این کمپین فاقد خوداظهاری در مورد تبلیغات سیاسی اتحادیه اروپا است. |
شما میتوانید وضعیت خوداظهاری یک کمپین را در API گوگل ادز با اجرای کوئری زیر با استفاده از متدهای Search یا SearchStream از سرویس GoogleAdsService بازیابی کنید.
select campaign.id, campaign.contains_eu_political_advertising from campaign
اعتبارسنجی و اجرای API در سطح کمپین
تمام کمپینهای جدید ایجاد شده از طریق API تبلیغات گوگل باید فیلد contains_eu_political_advertising را تنظیم کنند. اگر این فیلد تنظیم نشود، فراخوانی API برای ایجاد یک کمپین جدید با استفاده از CampaignService.MutateCampaigns با خطای FieldError.REQUIRED مواجه خواهد شد.
تمام کمپینهای موجود باید قبل از تلاش برای تغییر هدفگذاری proximity ، location یا location_group چه در سطح کمپین و چه در سطح گروه تبلیغاتی، فیلد contains_eu_political_advertising تنظیم کنند. فراخوانی API برای ایجاد یا بهروزرسانی این معیارهای کمپین با استفاده از متد CampaignCriterionService.MutateCampaignCriteria برای کمپینهای موجود، در صورتی که کمپین خوداظهاری را تکمیل نکرده باشد، با خطای CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION مواجه خواهد شد. فراخوانی API برای ایجاد یا بهروزرسانی این معیارهای گروه تبلیغاتی با استفاده از متد AdGroupCriterionService.MutateAdGroupCriteria نیز در صورتی که کمپین خوداظهاری را تکمیل نکرده باشد، به شیوهای مشابه با شکست مواجه خواهد شد.
این الزامات همچنین در مورد سایر مکانیسمهایی که میتوانید برای ایجاد کمپینها استفاده کنید، مانند اجرای Batch Jobs و استفاده از متد GoogleAdsService.Mutate برای ایجاد و بهروزرسانی موجودیتها، اعمال میشود. تلاش برای زمانبندی یک آزمایش جدید با استفاده از متد ExperimentService.ScheduleExperiment در صورتی که عبارت contains_eu_political_advertising در کمپینهای پیشنویس درمان وجود نداشته باشد، خطای ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION را ایجاد خواهد کرد.
تغییرات اعتبارسنجی و اجرای API در سطح حساب کاربری
از اول آوریل ۲۰۲۶ ، اگر یک حساب گوگل ادز یک یا چند کمپین اعلام نشده داشته باشد، API گوگل ادز تمام فراخوانیهای mutate مربوط به مدیریت کمپین را با خطای MutateError.EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED با شکست مواجه میکند. سایر فراخوانیها - مانند گزارشدهی، مدیریت حساب یا برنامهریز کلمات کلیدی - بدون تغییر به کار خود ادامه خواهند داد. لیست کامل روشها را ببینید.
نحوه اعلام کمپینهای اعلام نشده موجود
برای اعلام کمپینهای اعلام نشدهی موجود، لیست کمپینهای واجد شرایط را بازیابی کنید و اعلان contains_eu_political_advertising آنها را با استفاده از متد CampaignService.MutateCampaigns ، متد GoogleAdsService.Mutate یا با استفاده از BatchJobService تنظیم کنید. این متدها تا زمانی که فقط فیلد contains_eu_political_advertising کمپین را بهروزرسانی کنید، با خطای MutateError.EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED مواجه نخواهند شد.
شما میتوانید با اجرای کوئری GAQL زیر با استفاده از متدهای Search یا SearchStream از سرویس GoogleAdsService ، لیست کمپینهای اعلام نشده را بازیابی کنید.
select campaign.id
from
campaign
where
campaign.missing_eu_political_advertising_declaration = true
همچنین میتوانید کمپینهای اعلام نشده را در سطح حساب کاربری گوگل ادز با استفاده از رابط کاربری گوگل ادز اعلام کنید. وضعیت اعلام سطح حساب کاربری را میتوان با استفاده از فیلد contains_eu_political_advertising از شیء Customer بازیابی کرد.
تأثیر بر خدمات کمپین
هر کمپینی که با تنظیم contains_eu_political_advertising روی true ، تبلیغات سیاسی اتحادیه اروپا را اعلام کرده باشد، نمایش تبلیغات در اتحادیه اروپا را متوقف خواهد کرد. اطلاعات بیشتر .
کمپینهای موجود که اعلامیهای در این مورد ندارند، فعلاً بیتأثیر خواهند ماند.
فهرست روشهای اجباری
تمام روشهایی که برای مدیریت کمپینهای گوگل ادز استفاده میشوند، تحت تأثیر اعتبارسنجی و اجرای سطح حساب کاربری قرار میگیرند. لیست کاملی از روشها در جدول زیر فهرست شده است.
| خدمات | روش |
|---|---|
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 |