الخميس 7 أغسطس 2025
ما الذي سيتغيّر؟
حسبما أعلنّا في العام الماضي، ستتوقف Google عن عرض إعلانات سياسية في الاتحاد الأوروبي، وذلك قبل بدء سريان لائحة جديدة في أكتوبر 2025. في 3 سبتمبر 2025، سيتم طرح إجراءات تنفيذ مرتبطة بهذا التغيير في Google Ads API ونصوص "إعلانات Google" البرمجية. إذا كنت تستخدم أيًا من هذين المنتجَين لإنشاء الحملات أو إدارتها، قد تحتاج إلى تعديل تطبيقك للتعامل مع إجراءات التنفيذ هذه قبل 3 سبتمبر 2025.
توافُق واجهة برمجة التطبيقات مع الإقرار الذاتي للإعلانات السياسية عن الاتحاد الأوروبي
أضفنا إلى Google Ads API ونصوص "إعلانات Google" البرمجية إمكانية الإفصاح الذاتي عمّا إذا كانت الحملة تتضمّن إعلانات سياسية عن الاتحاد الأوروبي. تعريف الإعلان السياسي عن الاتحاد الأوروبي تتضمّن الإصدارات 19.2 و20.1 و21 من واجهة برمجة التطبيقات حقلاً جديدًا باسم contains_eu_political_advertising في العنصر Campaign.. يتم عرض القيم المحتملة ومعانيها في الجدول أدناه.
| القيمة | المعنى |
CONTAINS_EU_POLITICAL_ADVERTISING
|
تحتوي الحملة على إعلانات سياسية عن الاتحاد الأوروبي. |
DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING
|
لا تتضمّن الحملة إعلانات سياسية عن الاتحاد الأوروبي. |
UNSPECIFIED
|
لا يتوفّر في الحملة بيان الإفصاح الذاتي عن الإعلانات السياسية عن الاتحاد الأوروبي. |
يمكنك استرداد حالة البيان الذاتي لحملة في Google Ads API من خلال تنفيذ طلب البحث التالي باستخدام الطريقتَين Search أو SearchStream في GoogleAdsService. بالنسبة إلى نصوص "إعلانات Google" البرمجية، استخدِم الطريقتَين AdsApp.search أو AdsApp.report.
select campaign.id, campaign.contains_eu_political_advertising from campaign
إذا كنت تستخدم مكتبات عملاء Google Ads API، قد تحتاج إلى تنزيل أحدث إصدار من المكتبة لاستخدام هذه الوظيفة في الإصدارَين 19 و20 من واجهة برمجة التطبيقات.
تغييرات في التحقّق من صحة واجهة برمجة التطبيقات وإجراءات التنفيذ
في 3 سبتمبر 2025، ستبدأ Google Ads API ونصوص "إعلانات Google" البرمجية في فرض عمليات التحقّق التالية في الإصدارَين 19 و20 من واجهة برمجة التطبيقات.
- يجب ضبط الحقل
contains_eu_political_advertisingفي جميع الحملات الجديدة التي يتم إنشاؤها من خلال Google Ads API أو نصوص "إعلانات Google" البرمجية. سيتعذّر تنفيذ طلب البيانات من واجهة برمجة التطبيقات لإنشاء حملة جديدة باستخدامCampaignService.MutateCampaignsوسيظهر الخطأFieldError.REQUIREDفي حال عدم ضبط هذا الحقل. ستفرض نصوص "إعلانات Google" البرمجية عمليات التحقّق هذه عند إنشاء حملات باستخدام الطريقتَينAdsApp.mutateأوAdsApp.mutateAll. - يجب أن تضبط جميع الحملات الحالية الحقل
contains_eu_political_advertisingقبل محاولة تغييرproximity, location,أوlocation_groupالاستهداف على مستوى الحملة أو المجموعة الإعلانية. سيؤدي طلب البيانات من واجهة برمجة التطبيقات لإنشاء معايير الحملة هذه أو تعديلها باستخدام طريقةCampaignCriterionService.MutateCampaignCriteriaللحملات الحالية إلى ظهور خطأCriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATIONإذا لم تكن الحملة قد أكملت الإقرار الذاتي. سيتعذّر أيضًا طلب البيانات من واجهة برمجة التطبيقات لإنشاء معايير المجموعات الإعلانية هذه أو تعديلها باستخدامAdGroupCriterionService.MutateAdGroupCriteriaبالطريقة نفسها إذا لم تكن الحملة قد أكملت الإقرار الذاتي. ستفرض نصوص "إعلانات Google" البرمجية عمليات التحقّق هذه عند محاولة تغيير الاستهداف باستخدام الطرقAdsApp.mutateوAdsApp.mutateAllوAdsApp.Campaign.addProximityوAdsApp.Campaign.addLocation. - تنطبق إجراءات التنفيذ هذه أيضًا على الآليات الأخرى التي يمكنك استخدامها لإنشاء حملات، مثل تنفيذ مهام مجمّعة واستخدام طريقة
GoogleAdsService.Mutateلإنشاء الكيانات وتعديلها. - ستؤدي محاولة جدولة تجربة جديدة باستخدام طريقة
ExperimentService.ScheduleExperimentإلى ظهور خطأExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATIONفي حال عدم توفّرcontains_eu_political_advertising declarationفي الحملات التجريبية الاختبارية. - إذا كنت تستخدم ميزة التحميل المجمّع في نصوص "إعلانات Google" البرمجية، اطّلِع على مستندات المنتج لمعرفة المزيد عن التغييرات المطلوبة في نموذج جدول البيانات كجزء من هذا التغيير.
يتم تنفيذ عمليات التحقّق هذه في الإصدار 21 من Google Ads API.
كيف سيؤثر ذلك في عرض حملتي؟
أي حملة تم الإفصاح فيها عن الإعلانات السياسية عن الاتحاد الأوروبي من خلال ضبط السمة contains_eu_political_advertising على true ستتوقف عن عرض الإعلانات في الاتحاد الأوروبي في 22 سبتمبر 2025. يُرجى الرجوع إلى مركز المساعدة لمزيد من المعلومات.
ولن تتأثّر الحملات الحالية التي لم يتم تقديم إقرار لها في الوقت الحالي. ننصحك بتعديل الحملات الحالية في حساباتك من خلال إضافة بيان مناسب في أقرب وقت ممكن. يمكنك استرداد الحملات التي لا تتضمّن بيانًا باستخدام طلب البحث التالي في GAQL من خلال الطريقتَين Search أو SearchStream في GoogleAdsService.
select campaign.id, campaign.contains_eu_political_advertising
from
campaign
where
campaign.contains_eu_political_advertising NOT IN
(
'CONTAINS_EU_POLITICAL_ADVERTISING',
'DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING'
)الإجراء المطلوب اتخاذه
إذا كان تطبيقك يستخدم Google Ads API أو نصوص "إعلانات Google" البرمجية لإنشاء الحملات أو إدارتها، تأكَّد من تعديل تطبيقك للتعامل مع إجراءات التنفيذ هذه قبل 3 سبتمبر 2025.
كيف يمكنني الحصول على المساعدة؟
يُرجى التواصل مع قنوات دعم Google Ads API أو دعم نصوص "إعلانات Google" البرمجية إذا كانت لديك أسئلة إضافية حول هذا التغيير.
- Anash P. "أومن"، فريق Google Ads API
التصنيفات: campaign، google-ads-api، google-ads-scripts