ملاحظات حول الإصدار

يُرجى الرجوع إلى إيقاف الميزات نهائيًا للاطّلاع على قائمة محدّثة بالميزات الحالية والمخطط لإيقافها نهائيًا.

الإصدارات الرئيسية والثانوية من الإصدار 25

يتضمّن الإصدار 25 من Google Ads API الميزات والتحديثات والتغييرات غير المتوافقة التالية.

الإصدار 25.1 (‎19/08/2026)

تمت إضافة الميزات والتحديثات الجديدة التالية في الإصدار 25.1 من Google Ads API. لا تتضمّن الإصدارات الثانوية، مثل الإصدار 25.1، تغييرات قد تؤدي إلى أعطال.

الميزات والتحديثات	النوع	الوصف
مواد العرض
AssetFieldType.TEXT_DISCLAIMER ServedAssetFieldType.TEXT_DISCLAIMER	قيم التعداد الجديدة	تمت إضافة دعم لمواد عرض بيان إخلاء المسؤولية النصي.
الحملات
Campaign.aca_migration_date_time Campaign.broad_match_migration_date_time	حقول جديدة	تتبُّع عملية النقل التلقائي القادمة إلى ميزات AI Max
الإحالات الناجحة
قياسات "تأثير العلامة التجارية"	الميزات الجديدة	تمّت إضافة إمكانية قياس "تأثير العلامة التجارية" من خلال التعديلات التالية: تمّت إضافة موارد جديدة ذات أبعاد للقراءة فقط لنتائج دراسة التحسّن: LiftMeasurementAgeRange وLiftMeasurementCampaign وLiftMeasurementDevice وLiftMeasurementGender وLiftMeasurementVideo. تمّت إضافة شرائح ومقاييس جديدة لإتاحة تحليل "تأثير العلامة التجارية" باستخدام LiftMeasurementConfig والمراجع الجديدة المتعدّدة الأبعاد. تمت إضافة قيم التعداد التالية: BrandLiftMeasurementType وLiftMeasurementFlightStatus وSurveyIntendedAction وSurveyLiftFlightTargetResponseMode وSurveySubjectType.
قياسات "زيادة الإحالات الناجحة"	الميزات الجديدة	أضفنا إمكانية قياس "زيادة الإحالات الناجحة" من خلال التعديلات التالية: تمت إضافة مورد جديد للقراءة فقط LiftMeasurementConfig يمثّل دراسة تحسُّن. تمّت إضافة شرائح جديدة قابلة للاختيار لتصنيف نتائج التحسّن وتصفيتها. أضفنا 24 مقياسًا جديدًا لمقياس "زيادة الإحالات الناجحة" ومقاييس لنتائج الفائزين تتيح إجراء تحليل إحصائي مفصّل لأداء التحسُّن. تمّت إضافة إمكانية استرداد تفاصيل الحملة وأهداف الإحالات الناجحة. تمت إضافة حقل اختياري جديد Experiment.lift_measurement_config. تمت إضافة التعداد ConversionLiftIncludedConversionActionTypes.
LiftMeasurementFlight	مورد جديد	مورد جديد للقراءة فقط يمثّل تفاصيل الرحلة الجوية لإعداد قياس التحسُّن، بما في ذلك تاريخا بدء الرحلة الجوية التي تم قياسها وانتهائها (start_date وend_date).
بنود عامة
SmartCampaignError	قيم التعداد الجديدة	تمّت إضافة رموز أخطاء جديدة ومحدّدة لقيود إنشاء "حملات الأداء الأفضل": VALIDATE_ONLY_GENERATE_PMAX_NOT_SUPPORTED GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED
AuthorizationErrorEnum.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION	قيمة التعداد الجديدة / الخطأ	يتم عرض هذا الخطأ عندما يحاول مشروع Google Cloud بمستوى الوصول TEST إرسال طلبات إلى حساب غير تجريبي.
التخطيط
إحصاءات الانطباع تجاه العلامة التجارية	الميزات الجديدة	تمت إضافة إمكانية عرض إحصاءات حول آراء المستخدمين بالعلامة التجارية في ContentCreatorInsightsService: تمت إضافة الرسائل BrandSentimentInsight وSentimentInsightDistribution وSentimentInsightSummary. تمت إضافة التعداد Sentiment. تمت إضافة القيمة BRAND_SENTIMENT_DATA إلى تعداد ContentCreatorInsightsSupplementalData. تمت إضافة القيمة BRAND إلى تعداد InsightsKnowledgeGraphEntityCapabilities.
BenchmarksService التحسينات	الميزات الجديدة	تمت إضافة إمكانية استخدام الفئات كفلاتر لتحديد نطاق تحليل مقاييس الأداء. تم أيضًا توفير مقاييس إضافية مهمة للنشاط التجاري: أضفنا خيارًا للمقارنة مع جميع المعلِنين الذين يعرضون إعلانات في فئة واحدة أو أكثر من فئات المنتجات والخدمات باستخدام BenchmarksService.GenerateBenchmarksMetrics وcategory_filter. عرض المزيد من مقاييس إعلانات العملاء، مثل التكلفة الإجمالية للعميل وعدد المشاهدات وما إلى ذلك، ومشاركة مقاييس مثل share_of_voice يتم عرض المقاييس باستخدام AggregateMetrics وShareMetrics. يمكن استرداد قائمة الفئات المسموح بها باستخدام BenchmarksService.ListBenchmarksSources مع نوع المصدر CATEGORY.
استهداف الجمهور حسب الحالة الأبوية	ميزة جديدة	تمت إضافة إمكانية استهداف الحالة الأبوية في "تخطيط الوصول إلى الجمهور". تمت إضافة الحقل الجديد parental_statuses إلى Targeting للخدمة ReachPlanService.GenerateReachForecast، وتمت إضافة parental_statuses إلى PlannableTargeting للخدمة ReachPlanService.ListPlannableProducts.
الاقتراحات
Recommendation.campaign_specific_app_goal_recommendation	اقتراح جديد	يقترح إضافة هدف إحالة ناجحة للتطبيق محدّد للحملة. يتم استخدام المرجع الجديد EffectiveAutomaticGoal لتمثيل الأهداف الحالية ضمن هذا الاقتراح.
التقارير
Metrics.original_conversion_value	حقل جديد	تمثّل هذه السمة قيمة الإحالة الناجحة الأصلية من الإحالات الناجحة القابلة لتقديم عروض الأسعار. هذه هي القيمة غير المعدَّلة للإحالات الناجحة قبل تطبيق أي تعديلات على قواعد القيمة، مثل قواعد قيمة الإحالة الناجحة أو تعديلات أهداف مراحل النشاط.
إحصاءات الاشتراك في برنامج الولاء	الميزات الجديدة	تمت إضافة إمكانية تقسيم الإحصاءات حسب حالة برنامج عضوية الولاء للمستخدم، كما تمت إضافة سمة أساسية لعضوية الولاء لقواعد قيم الإحالات الناجحة: تمّت إضافة شريحة Segments.loyalty_membership لإتاحة تقسيم مقاييس التقارير حسب مستوى برنامج الولاء للمستخدِم الذي أجرى الإحالة الناجحة. تمّت إضافة السمة الأساسية LOYALTY_MEMBERSHIP لتحديد الحالات التي تم فيها استيفاء شرط عضوية برنامج الولاء لإحدى قواعد قيم الإحالات الناجحة.
الاستهداف
vertical_ads_item_bid	نوع المعيار الجديد	تمت إضافة نوع المعيار الجديد vertical_ads_item_bid إلى AdGroupCriterion.criterion.

الإصدار 25‏ (‎22/07/2026)

تمت إضافة الميزات والتحديثات والتغييرات غير المتوافقة التالية في الإصدار 25 من Google Ads API، وهو إصدار رئيسي.

يمكنك الاطّلاع على الترقية إلى أحدث إصدار للحصول على إرشادات.

تغييرات قد تؤدي إلى أعطال

الحالة المبدئية	الحالة الجديدة	نوع التغيير	إرشادات التنفيذ
الحملات
الحقلان المستقلان additional_value وadditional_high_lifetime_value في CustomerLifecycleOptimizationValueSettings	جزء من value_adjustment وhigh_lifetime_value_adjustment على التوالي، بالإضافة إلى الحقلَين الجديدَين value_multiplier وhigh_lifetime_value_multiplier	التغيير الهيكلي	عدِّل مراجع هذه الحقول لأنّها أصبحت الآن جزءًا من oneofs.
الموارد القديمة CustomerLifecycleGoal وCampaignLifecycleGoal، والخدمات المقابلة لها CustomerLifecycleGoalService وCampaignLifecycleGoalService، والإعدادات/القيم القديمة (CustomerAcquisitionGoalSettings وCustomerAcquisitionOptimizationModeEnum وLifecycleGoalValueSettings)	بلا	إزالة	استخدِم مخطط الأهداف الموحَّدة المُعاد تصميمه: استخدِم الحقل new_customer_acquisition_goal_settings في المورد Goal. استخدِم الحقل campaign_new_customer_acquisition_settings في مصدر CampaignGoalConfig لإعداد عمليات إلغاء على مستوى الحملة.
بنود عامة
حقول التعداد المتداخلة في رسائل طلبات واستجابات "خدمة الحوافز": FetchIncentiveRequest.type Incentive.type IncentiveOffer.type	حقول التعداد المستقلة: FetchIncentiveRequest.incentive_type Incentive.incentive_type IncentiveOffer.offer_type	إعادة التسمية / الإزالة	استخدِم حقول التعداد المستقلة الجديدة بدلاً من حقول type القديمة.
الحقلان الاختياريان selected_incentive_id وcustomer_id في ApplyIncentiveRequest	حقول مطلوبة	تغيير في السلوك	تأكَّد من توفير كلا الحقلين عند طلب ApplyIncentive.
حقل عنوان البريد الإلكتروني للمستهلك ContactDetails.email في المرجع LocalServicesLead	بلا	إزالة	أزِل الإشارات إلى هذا الحقل لأنّه لم يعُد متاحًا للاستخدام.
الحقل allowed_domain الاختياري في AdvertisingPartnerLinkInvitationProperties	حقل مطلوب عند طلب CreateProductLinkInvitation لشريك إعلاني	تغيير في السلوك	يُرجى التأكّد من تقديم allowed_domain عند إنشاء دعوة لربط المنتجات لأحد شركاء الإعلان.
التخطيط
الحقل search_brand في GenerateCreatorInsightsRequest	بلا	إزالة	استخدِم search_topics بدلاً من ذلك.
الحقل plannable_location_id في Targeting والحقل cookie_frequency_cap في GenerateReachForecastRequest	بلا	إزالة	بدِّل إلى استخدام plannable_location_ids وcookie_frequency_cap_setting.
التقارير
الحقل customer_metrics في GenerateBenchmarksMetricsResponse وBreakdownMetrics من النوع Metrics	حقل من النوع CustomerMetrics	تغيير النوع / تغيير في السلوك	عدِّل عمليات الدمج لاستخدام النوع الجديد CustomerMetrics الذي يحتوي فقط على مقاييس تمثّل أداء إعلانات العميل.

الميزات والتحديثات (غير المتوافقة مع الإصدارات السابقة)

الميزات والتحديثات	النوع	الوصف
الإعلانات
AssetAutomationType.GENERATE_ANIMATED_IMAGES_FROM_OTHER_ASSETS	قيمة التعداد الجديدة / السلوك الجديد	متوفّر في ‎DemandGenMultiAssetAds في حال تفعيل هذه الميزة، يتم إنشاء صور متحركة باستخدام صور غير متحركة كمدخلات. يتم تلقائيًا تفعيل DemandGenMultiAssetAds الجديدة بدءًا من إصدار واجهة برمجة التطبيقات هذا.
إمكانية تغيير معلومات المحتوى الاصطناعي	تغيير السلوك	أصبحت السمتان Asset.synthetic_content_info وAd.synthetic_content_info قابلة للتعديل بالكامل في الإصدارات 25 و24 و23.
الحملات
هدف الاحتفاظ بالعملاء من خلال برنامج الولاء	الميزات / الإعدادات الجديدة	تمّت إضافة ميزة "هدف الاحتفاظ بالمشتركين في برنامج الولاء" التي تتيح للمعلِنين تحسين الحملات للاحتفاظ بالمشتركين في برنامج الولاء. تمت إضافة LOYALTY_RETENTION إلى تعداد GoalType. تمت إضافة CampaignGoalConfig.campaign_loyalty_retention_settings لضبط إعدادات الاحتفاظ بالعملاء في برنامج الولاء على مستوى الحملة، بما في ذلك تعديلات عروض الأسعار وعرض مزايا الاشتراك بتنسيق إعلان قائمة المنتجات. تمت إضافة Goal.loyalty_retention_goal_settings لضبط إعدادات هدف الاحتفاظ بالعملاء على مستوى الحساب. تمت إضافة رموز الخطأ الجديدة التالية: LOYALTY_RETENTION_GOAL_INVALID_MODE CANNOT_USE_INCOMPATIBLE_CLO_GOALS LOYALTY_RETENTION_GOAL_ALREADY_EXISTS
هدف "اكتساب عملاء جدد"	الميزات / الإعدادات الجديدة	تم تعديل إمكانية استخدام هدف "اكتساب عملاء جدد" في Google Ads API ليعكس مخطط الأهداف الموحّدة الذي تمّت إعادة تصميمه: تمت إضافة Goal إلى المرجع من أجل إتاحة إعدادات "اكتساب العملاء الجدد" باستخدام الحقل new_customer_acquisition_goal_settings. تمت إضافة CampaignGoalConfig إلى المرجع من أجل إتاحة عمليات إلغاء على مستوى الحملة لميزة "اكتساب عملاء جدد" باستخدام الحقل campaign_new_customer_acquisition_settings. تمت إضافة تعداد CustomerLifecycleOptimizationGoalSubType الجديد لتحديد الأنواع الفرعية للأهداف المتوافقة. تمت إضافة NEW_CUSTOMER_ACQUISITION إلى تعداد GoalType. تمت إضافة أسباب جديدة لخطأ التحقّق من الصحة إلى GoalError: NEW_CUSTOMER_ACQUISITION_GOAL_ALREADY_EXISTS تمت إضافة أسباب جديدة لخطأ التحقّق من الصحة إلى CampaignGoalConfigError: CAMPAIGN_OVERRIDE_VALUES_SET_FOR_NEW_CUSTOMER_ACQUISITION_TARGET_SPECIFIC_OPTION CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE CANNOT_USE_INCOMPATIBLE_CLO_GOALS تمت إضافة ErrorDetails.incompatible_clo_goal_error_details لعرض بنية IncompatibleCloGoalsErrorDetails الجديدة لأخطاء التحقّق.
الإحالات الناجحة
تحديد مصدر الإحالات الناجحة من طرف ثالث على YouTube	حقول جديدة	تمّت إضافة إمكانية التحقّق من تحديد مصدر الإحالات الناجحة على YouTube باستخدام شركاء خارجيين: تمّت إضافة CustomerThirdPartyIntegrationPartners.conversion_attribution_integration_partners للسماح بإعداد شركاء الدمج على مستوى العميل. تمّت إضافة CampaignThirdPartyIntegrationPartners.conversion_attribution_integration_partners للسماح بإعداد شركاء الدمج على مستوى الحملة. لمزيد من المعلومات، يمكنك الاطّلاع على مقالة مركز المساعدة.
بنود عامة
ContactDetails.phone_number_extension	حقل جديد	تمت إضافة المورد إلى LocalServicesLead.
IncentiveError	قيم التعداد الجديدة / الأخطاء	تمت إضافة رموز أخطاء جديدة ومحدّدة لحالات تعذُّر تحصيل قيمة الحوافز: BILLING_COUNTRY_NOT_ELIGIBLE (بلد إرسال الفواتير الخاص بالعميل غير مؤهَّل للحصول على الحافز) USER_IS_MCC_MANAGER (المستخدم هو حساب إداري ولا يمكنه الاستفادة من الحافز) USER_SUSPENDED (تم تعليق حساب العميل) MAX_PENDING_INCENTIVES (بلغ العميل الحدّ الأقصى لعدد المكافآت في انتظار المراجعة) ACCOUNT_HAD_RECENT_SPEND (كان الحساب يتضمّن إنفاقًا حديثًا وهو غير مؤهّل) MAX_INCENTIVES_REDEEMED_FROM_OFFER (لقد حصل العميل على الحد الأقصى لعدد الحوافز من هذا العرض) MISMATCHING_BILLING_COUNTRY_CODE (رمز بلد إرسال الفواتير المقدَّم في الطلب لا يتطابق مع بلد حساب العميل)
التخطيط
تفاصيل قناة على YouTube في إحصاءات حول المحتوى الرائج	حقول جديدة	تمت إضافة إمكانية عرض المزيد من تفاصيل قنوات YouTube للفيديوهات ذات الصلة عند البحث عن مؤشرات الرواج. تمت إضافة الحقول الجديدة channel_id وchannel_name وchannel_url إلى YouTubeVideoAttributeMetadata.
YouTubeChannelInsights.data_sharing_consent_given	حقل جديد	تمت الإضافة إلى YouTubeChannelInsights. وينطبق ذلك إذا وافق صانع المحتوى على مشاركة بيانات غير متاحة للجميع. في حال توفّرها، يتم ملء الحقول التالية: average_views_per_video average_likes_per_video average_comments_per_video engagement_rate channel_audience_attributes
التقارير
ad_sub_format_type	شريحة جديدة	تعرض هذه السمة تفصيلاً لـ "الإعلانات غير القابلة للتخطّي أثناء عرض الفيديو" على YouTube حسب المدة: INSTREAM_NON_SKIPPABLE_STANDARD (إعلان غير قابل للتخطي أثناء عرض الفيديو بمدة عادية) INSTREAM_NON_SKIPPABLE_MAX30_SEC (إعلان غير قابل للتخطّي أثناء عرض الفيديو لا تزيد مدته عن 30.99 ثانية) INSTREAM_NON_SKIPPABLE_MAX60_SEC (إعلان غير قابل للتخطّي أثناء عرض الفيديو لا تزيد مدته عن 60.99 ثانية) يجب دائمًا اختيار هذا القسم مع ad_format_type. يمكن تحديده باستخدام AdGroup وAdGroupAd وCampaign وCustomer وVideo وVideoEnhancement.
المقاييس الاجتماعية الخاصة بالفيديوهات	الحقول / المقاييس الجديدة	أضفنا مقاييس خاصة بالفيديو على وسائل التواصل الاجتماعي لمساعدة المعلِنين في تتبُّع تفاعل المستخدمين (التعليقات وتسجيلات الإعجاب والمشاركات) مع الإعلانات على Shorts على YouTube: Metrics.youtube_comments Metrics.youtube_likes Metrics.youtube_shares تتوفّر هذه الميزة في AdGroup وAdGroupAd وAsset وCampaign وCustomer وVideo.

الإصدارات الرئيسية والثانوية من الإصدار 24

يتضمّن الإصدار 24 من Google Ads API الميزات والتحديثات والتغييرات غير المتوافقة التالية.

الإصدار 24.2 (‎24/06/2026)

تمت إضافة الميزات والتحديثات الجديدة التالية في الإصدار 24.2 من Google Ads API. لا تحتوي الإصدارات الثانوية، مثل الإصدار 24.2، على تغييرات غير متوافقة مع الإصدارات السابقة.

الميزات والتحديثات	النوع	الوصف
الإعلانات
AssetAutomationType.GENERATE_LANDING_PAGE_TEXT	قيمة تعداد جديدة	تنشئ هذه السمة معلومات نصية من الصفحة المقصودة ليتم عرضها في لوحة التفاعل لحالات DemandGenVideoResponsiveAd (التي يتم تفعيلها تلقائيًا بدءًا من إصدار واجهة برمجة التطبيقات هذا).
مواد العرض
AssetGroup.google_local_services_info	حقل جديد	تمّت إضافة معلومات "إعلانات الخدمات المحلية" (معرّف الفئة والوسائل الإيضاحية) إلى "حملات الأداء الأفضل".
AssetGroupSignal.local_services_id	حقل جديد	تمّت إضافة إشارات معرّف الخدمة في "إعلانات الخدمات المحلّية" إلى "حملات الأداء الأفضل".
AssetGroupSignal.vertical_ads_item_group_rule_list	حقل جديد	تمت إضافة هذه السمة لدعم قواعد مجموعة عناصر الإعلانات العمودية من أجل اختيار عناصر من الخلاصات العمودية المرفقة في "حملات الأداء الأفضل". هذه الميزة متوفّرة فقط للحسابات المُدرَجة في القائمة المسموح بها.
AssetGroupErrorEnum.CANNOT_REMOVE_ALL_ASSET_GROUPS_FROM_CAMPAIGN	قيمة التعداد الجديدة / الخطأ	يتم عرض هذا الخطأ عند محاولة إزالة جميع مجموعات مواد العرض من حملة.
AssetGroupSignalErrorEnum.CANNOT_REMOVE_ALL_SIGNALS	قيمة التعداد الجديدة / الخطأ	يتم عرض هذا الخطأ عند محاولة إزالة جميع الإشارات من مجموعة مواد عرض.
الحملات
Campaign.PmaxCampaignSettings.local_services_pmax_campaign_settings Campaign.PmaxCampaignSettings.local_services_enabled	حقول جديدة	إتاحة تحديد "حملات الأداء الأفضل" على "الخدمات المحلية"
AdGroup.DemandGenAdGroupSettings.DemandGenChannelControls.DemandGenSelectedChannels.maps	حقل جديد	تتضمّن "خرائط Google" في القنوات القابلة للاختيار لمجموعات الإعلانات في "حملات زيادة الطلب".
CampaignCriterionErrorEnum.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN	قيمة التعداد الجديدة / الخطأ	يتم عرض هذه الرسالة عند محاولة إزالة جميع المواقع الجغرافية من "حملة أداء أفضل" لخدمات محلية.
SmartCampaignErrorEnum.CREATION_FAILED	قيمة التعداد الجديدة / الخطأ	يتم عرض هذا الخطأ عند محاولة إنشاء "حملات ذكية" جديدة.
الإحالات الناجحة
ConversionOrigin.LOCAL_SERVICES_ADS ConversionActionType.LOCAL_SERVICES_ADS	قيم التعداد الجديدة	تمثّل هذه الفئة الإحالات الناجحة التي تحدث عندما ينقر مستخدم على إعلان في "الخدمات المحلّية" ويتّصل بالمعلِن أو يرسل إليه رسالة أو يحجز موعدًا معه.
التجارب
COMPARE_CAMPAIGNS PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION	قيم التعداد الجديدة	تمت إضافة دعم لأنواع ExperimentType الجديدة: COMPARE_CAMPAIGNS: لتجارب مزج الحملات وتجارب "حملات الأداء الأفضل" المخصّصة التي تقارن بين حملات متعدّدة من النوع نفسه أو أنواع مختلفة في تجربة واحدة ‫PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION: لتجارب تحسين "حملات الأداء الأفضل" من أجل ميزتَي "تخصيص النص" و"توسيع عنوان URL النهائي"
بنود عامة
Asset.synthetic_content_info Ad.synthetic_content_info	حقول جديدة	أن تتضمّن شهادات صحة للمحتوى الاصطناعي أو المحتوى من إنشاء الذكاء الاصطناعي، مقسّمة إلى advertiser_attestation (الإقرارات المقدَّمة مباشرةً من المعلِن) وsystem_attestation (شهادات الصحة التي يتم رصدها تلقائيًا أو التي يقدّمها النظام). تمت إعادة توفير هذه الميزة في الإصدارَين 23 و22. لمساعدتك في التخطيط لعملية الدمج القادمة للإصدار 25، سيتم طرح واجهة لتعديل حقول شهادة المعلِن في وقت مبكر للإصدار 22 والإصدارات الأحدث. تظهر الواجهة في هذه الإصدارات، ولكن سيظل synthetic_content_info.advertiser_attestation.status وsynthetic_content_info.advertiser_attestation.source غير قابلَين للتغيير في هذه الإصدارات. إذا حاولت إجراء طلب تغيير على أيّ من هذين الحقلَين، سيتم عرض أحد الأخطاء التالية: "The field attempted to be mutated is immutable" أو "Field cannot be set". ستصبح هذه الحقول قابلة للتعديل بالكامل بدءًا من الإصدار 25. ننصحك باستخدام الواجهة الآن لإنشاء واختبار المنطق الداخلي حتى يكون نظامك جاهزًا لإمكانات الكتابة الكاملة عند إطلاق الإصدار 25.
تفويض من جهات متعدّدة	الميزات الجديدة	إصدار تجريبي: هذه الميزة قيد التجربة حاليًا، وقد تتغير في الإصدارات المستقبلية. تمت إضافة إمكانية إجراء مراجعات تتطلّب موافقة جهات متعدّدة (MPA): تمت إضافة المورد MultiPartyAuthReview وMultiPartyAuthReviewService المقابل. تمت إضافة تعداد MultiPartyAuthReviewStatus لتتبُّع حالة المراجعة. تمت إضافة CustomerUserAccess.pending_multi_party_auth_review للربط بمراجعة في انتظار المراجعة. تمت إضافة MutateCustomerUserAccessResult.multi_party_auth_review وMutateCustomerUserAccessInvitationResult.multi_party_auth_review لعرض اسم مورد المراجعة المرتبط. تمت إضافة MultiPartyAuthReviewError لأخطاء التحقّق. تمت إعادة دمج هذه الميزة في الإصدارات v23.3 وv22.2 وv21.2.
IncentiveService.FetchIncentive	تغيير السلوك	عند تقديم عنوان بريد إلكتروني غير صالح في الطلب، يعود الآن إلى عرض عروض الحوافز التلقائية بدلاً من عرض الخطأ AuthenticationError.INVALID_EMAIL_ADDRESS.
التخطيط
GenerateCreatorInsightsRequest.search_topics	حقل جديد	تمت الإضافة إلى خدمة ContentCreatorInsightsService.GenerateCreatorInsights. يبحث هذا الخيار عن صنّاع المحتوى الذين يتحدثون عن موضوع في البلد المحدّد في country_locations (يتيح البحث عن بلد واحد فقط).
CREATOR_TOPIC_INSIGHTS	قيمة تعداد جديدة	تمت إضافته إلى InsightsKnowledgeGraphEntityCapabilities للإشارة إلى الكيانات التي تتيح البحث عن صنّاع المحتوى الذين يتحدثون عن موضوع معيّن. يجب استخدام هذه الكيانات في الحقل search_topics. تم استردادها باستخدام AudienceInsightsService.ListAudienceInsightsAttributes.
KnowledgeGraphEntitySearchOptions	النوع / الخيارات الجديدة	يتضمّن خيارات بحث إضافية عن المواضيع في ListAudienceInsightsAttributes، بما في ذلك خيارات لاسترداد جميع المواضيع المتوافقة كسمات لصنّاع المحتوى، والفلترة حسب الإمكانات.
GenerateCreatorInsightsRequest.supplemental_data GenerateTrendingInsightsRequest.supplemental_data	حقول جديدة	مدخلات اختيارية لطُرق ContentCreatorInsightsService يؤدي توفير هذا الحقل إلى تعبئة المواقع الجغرافية الإضافية أو سمات صانع المحتوى في الردّ.
local_creator_insights related_local_creators	حقول جديدة	تتمّ تعبئة هذه السمة عندما يحتوي supplemental_data على قيمة التعداد LOCAL_CREATOR_DATA. تعرض هذه الميزة صنّاع المحتوى المحليين الذين شاهدوا المحتوى في البلد المحدّد أو يقيمون فيه ووافقوا على مشاركة بيانات الموقع الجغرافي.
GenerateTrendingInsightsRequest.sub_country_locations	حقل جديد	تمت إضافة ContentCreatorInsightsService.GenerateTrendingInsights، ما يتيح البحث عن مؤشرات البحث الرائجة باستخدام الموقع الجغرافي للبلد والمواقع الجغرافية الفرعية للبلد.
التقارير
PerformanceMaxPlacementView	إضافة شرائح الجمهور	تمّت إتاحة تقسيمها حسب ad_network_type.
تسوّق
Campaign.ShoppingSetting.ignore_brand_exclusion_in_shopping_ads	حقل جديد	في حال اختيار "true"، يتم تجاهل استبعادات العلامات التجارية في "إعلانات Shopping". تتوفّر هذه الميزة فقط في "حملات Shopping".
الاستهداف
CriterionErrorEnum.CANNOT_TARGET_LANGUAGE	قيمة التعداد الجديدة / الخطأ	يتم عرض هذا الخطأ عند محاولة استهداف لغة غير مسموح بها.
الفيديوهات
DataLink.youtube_link_metadata	حقل جديد	يحتوي على brand_channel_id لتحديد معرّف قناة العلامة التجارية المرتبطة على YouTube.

الإصدار 24.1 (‎13/05/2026)

تمت إضافة الميزات والتحديثات الجديدة التالية في الإصدار 24.1 من Google Ads API. لا تحتوي الإصدارات الثانوية، مثل الإصدار 24.1، على تغييرات غير متوافقة مع الإصدارات السابقة.

الميزات والتحديثات	النوع	الوصف
الإعلانات
DemandGenMultiAssetAdInfo.classic_display_images	حقل جديد	يتم عرض الصور الصورية التي يتم تحميلها بشكل مخصّص بدون الحاجة إلى مواد عرض متجاوبة إضافية.
التجارب
ADOPT_AI_MAX ADOPT_BROAD_MATCH_KEYWORDS OPTIMIZE_ASSETS PMAX_REPLACEMENT_SHOPPING	قيم التعداد الجديدة	تمت إضافة دعم لأنواع ExperimentType الجديدة: ADOPT_AI_MAX: للتجارب التي تختبر كيف يمكن أن تساعدك AI Max في جذب المزيد من العملاء باستخدام ذكاء Google الاصطناعي والكلمات الرئيسية التي تستخدم المطابقة التقريبية. ADOPT_BROAD_MATCH_KEYWORDS: للتجارب التي تختبر كيف يمكن أن تؤثّر الكلمات الرئيسية التي تستخدم المطابقة التقريبية في عدد عمليات البحث التي تظهر فيها إعلاناتك. OPTIMIZE_ASSETS: للتجارب المخصّصة لتحسين مواد العرض PMAX_REPLACEMENT_SHOPPING: للتجارب التي تختبر أداء "حملات Shopping" مقارنةً بـ "حملات الأداء الأفضل"
Experiment.video_experiment	حقل جديد	إتاحة إعدادات تجارب YOUTUBE_CUSTOM الحالية التي تتضمّن "حملات فيديو"
ExperimentArm.asset_testing_info ExperimentArm.asset_groups ExperimentArm.performance_max_experiment_arm_info	حقول جديدة	تعرض هذه السمة حقولاً تتيح اختبار مواد العرض ومجموعات مواد العرض وإعدادات "حملات الأداء الأفضل" في مجموعات التجربة: ‫asset_testing_info: تفاصيل مواد العرض المرتبطة بنسخ الإعلانات التجريبية asset_groups: قائمة بمجموعات مواد العرض في مجموعة التجربة لتجارب "تحسين مواد العرض". performance_max_experiment_arm_info: إعدادات "حملات الأداء الأفضل" في تجارب PMAX_REPLACEMENT_SHOPPING
بنود عامة
CustomerUserAccess.passkey_enabled	حقل جديد	حقل للقراءة فقط يشير إلى ما إذا كان المستخدم قد فعّل مفتاح مرور.
التقارير
mobile_device_platform	شريحة جديدة	يسمح بتقسيم التقارير حسب نظام تشغيل جهاز المستخدِم (مثل iOS أو Android).
REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED	قيمة التعداد الجديدة / الخطأ	يتم عرض هذه الرسالة عندما لا يكون مستوى الدقة الزمني المطلوب (يومي أو كل ساعة أو أسبوعي) غير متاح لنطاقات التواريخ في طلب البحث (متاح فقط لآخر 37 شهرًا).
vertical_ads_listing_user_rating vertical_ads_listing_venue	شرائح جديدة	شرائح جديدة سيتم استخدامها للإعلانات العمودية
‫user_rating، venue، event_participant_display_name	معايير فلتر جديدة	تتوفّر الفلترة في VerticalAdsItemGroupRuleInfo لمورد SharedCriterion.
مقاييس التجربة في المجموعة الضابطة والتجريبية	حقول جديدة	تمّت إضافة قيم التحكّم (control_clicks، وما إلى ذلك) وقيم المعالجة (clicks، وما إلى ذلك) وتقديرات النقاط (clicks_point_estimate، وما إلى ذلك) وهوامش الخطأ (clicks_margin_of_error، وما إلى ذلك) وقيم p (clicks_p_value، وما إلى ذلك) في سبع مجموعات أساسية من المقاييس (النقرات، ومرّات الظهور، والتكلفة، والإحالات الناجحة، والتكلفة لكلّ إحالة ناجحة، وقيمة الإحالة الناجحة، وقيمة الإحالات الناجحة بالنسبة إلى التكلفة).
مقاييس التغيير المطلق في الإحالات الناجحة	حقول جديدة	إتاحة تقديرات الفرق المطلق Conversions باستخدام حقول تقدير النقطة وهامش الخطأ والقيمة الاحتمالية
الاستهداف
CriterionErrorEnum.CANNOT_EXCLUDE_ALL_TARGETS	قيمة التعداد الجديدة / الخطأ	يتم عرض هذا الخطأ عند محاولة استبعاد جميع استهدافات الخصائص الديمغرافية.
الفيديوهات
ThirdPartyViewabilityIntegrationPartnerEnum.ZEFR	قيمة تعداد جديدة	تم نشر ZEFR كشريك خارجي في عملية دمج إمكانية العرض.
DataLink.youtube_video.channel_id	حقل جديد	تعرض هذه السمة معرّف قناة على YouTube المرتبط برابط البيانات.

الإصدار 24‏ (‎22/04/2026)

تمت إضافة الميزات والتحديثات والتغييرات غير المتوافقة التالية في الإصدار 24 من Google Ads API، وهو إصدار رئيسي.

يمكنك الاطّلاع على الترقية إلى أحدث إصدار للحصول على إرشادات.

تغييرات قد تؤدي إلى أعطال

الحالة المبدئية	الحالة الجديدة	نوع التغيير	إرشادات التنفيذ
الإعلانات
videos وlogo_images اختياريتان في DemandGenVideoResponsiveAdInfo	حقول مطلوبة	تغيير في السلوك	قدِّم videos وlogo_images عند إنشاء إعلانات فيديو متجاوبة لزيادة الطلب أو تعديلها.
videos وbusiness_name وlogo_images اختياريان في VideoResponsiveAdInfo	حقول مطلوبة	تغيير في السلوك	قدِّم videos وbusiness_name وlogo_images عند إنشاء إعلانات فيديو متجاوبة أو تعديلها. يُرجى العِلم أنّ VideoResponsiveAdInfo أصبح قابلاً للتغيير.
الحملات
Campaign.video_brand_safety_suitability	بلا	إزالة	تمت إزالة عناصر التحكّم في الملاءمة على مستوى الحملة. لا تزال ميزة "ملاءمة المحتوى للعلامة التجارية" متاحة على مستوى العميل. استخدِم Customer.video_brand_safety_suitability بدلاً من ذلك.
الإحالات الناجحة
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS	بلا	إزالة	تمت إزالة فئة المستخدمين الذين اشتركوا في برنامج الولاء. أزِل مراجع الرمز البرمجي إليه.
التخطيط
نوع InsightsAudienceAttributeGroup لـ topic_audience_combinations	النوع common.InsightsAudienceAttributeGroup	تغيير في السلوك / تغيير في النوع	يجب تعديل عمليات دمج مكتبات البرامج للعملاء المكتوبة لاستخدام مساحات الأسماء الجديدة للموارد.
الحقل youtube_select_lineups في ReachPlanService.ListPlannableProducts	بلا	إزالة	التبديل إلى استخدام قوائم التشغيل من youtube_select_lineup_targeting
الحقل is_brand_connect_creator في ContentCreatorInsightsService.GenerateCreatorInsights وGenerateTrendingInsights	بلا	إزالة	بدلاً من ذلك، تحقَّق ممّا إذا كان لدى صانع المحتوى CREATOR_PARTNERSHIPS متوفّر في partnership_opportunities.
‫geo_modifiers وbiddable_keywords في KeywordPlanIdeaService.GenerateKeywordForecastMetrics	geo_target_constants وkeywords	إعادة التسمية / الإزالة	تم استبدالهما بـ CampaignToForecast.geo_target_constants[] وForecastAdGroup.keywords[].
الحقول المتوقّفة نهائيًا في خطة الكلمات الرئيسية / التوقعات في GenerateKeywordForecastMetrics	بلا	إزالة	تمت إزالة الحقول والأنواع التالية من الخطة / التوقعات: CampaignToForecast.keyword_plan_network CampaignToForecast.negative_keywords وForecastAdGroup.negative_keywords ForecastAdGroup.max_cpc_bid_micros BiddableKeyword CriterionBidModifier KeywordForecastMetrics.impressions KeywordForecastMetrics.click_through_rate عدِّل عمليات الدمج وفقًا لذلك.
التقارير
شريحة الجمهور ad_sub_network_type في campaign_budget	بلا	إزالة	تمت إزالة شريحة ad_sub_network_type للمورد campaign_budget.
شريحة الجمهور click_type في طرق عرض مواد العرض	بلا	إزالة	تمت إزالة شريحة الجمهور من طرق العرض AdGroupAsset وCampaignAsset وCustomerAsset.
الفيديوهات
يُسمح بالفشل الجزئي في ShareablePreviewService.GenerateShareablePreviews	عدم حدوث فشل جزئي	تغيير في السلوك	ستتعذّر الطلبات وسيظهر خطأ إذا تعذّر التحقّق من صحة أي معرّف ضمنها.
رموز ShareablePreviewError القديمة: ASSET_GROUP_DOES_NOT_EXIST_UNDER_THIS_CUSTOMER TOO_MANY_ASSET_GROUPS_IN_REQUEST	MutateErrorEnum.RESOURCE_NOT_FOUND ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST	إعادة التسمية / تغيير في السلوك	تم تعديل رموز الخطأ التي يتم عرضها لمجموعات مواد العرض لتتوافق مع أخطاء إعلانات المجموعات الإعلانية. تعديل منطق رصد الأخطاء في عملية التحقّق

الميزات والتحديثات (غير المتوافقة مع الإصدارات السابقة)

الميزات والتحديثات	النوع	الوصف
الإعلانات
قابلية VideoResponsiveAdInfo للتغيير	تغيير السلوك	أصبحت عناصر معلومات "إعلانات الفيديو المتجاوبة" قابلة للتعديل الآن.
مواد العرض
‫travel_feed_data في AssetSet	حقل جديد	تمت إضافة هذه السمة لاسترداد سمات مواد عرض خلاصة السفر (hotel_center_account_id وmerchant_center_id وpartner_center_id وsubset_id وtravel_feed_vertical_type).
الحملات
Campaign.view_through_conversion_optimization_enabled	حقل جديد	تتيح تفعيل ميزة "تحسين الإحالات الناجحة بعد رؤية الإعلان فقط" (الإعداد التلقائي false) في "حملات زيادة الطلب" و"حملات التطبيقات".
CampaignCriterion.gender	ميزة جديدة	تم تفعيل استبعادات الجنس في "حملات الأداء الأفضل" على جميع إصدارات Google Ads API.
الإحالات الناجحة
أنواع الإحالات الناجحة لجذب العملاء المحتملين	قيم التعداد الجديدة	تمّت إضافة تعدادات جديدة لأنواع إجراءات الإحالات الناجحة في "إحصاءات Google‏ 4"/Firebase في ConversionActionType: GOOGLE_ANALYTICS_4_GENERATE_LEAD GOOGLE_ANALYTICS_4_QUALIFY_LEAD GOOGLE_ANALYTICS_4_CLOSE_CONVERT_LEAD FIREBASE_ANDROID_GENERATE_LEAD FIREBASE_ANDROID_QUALIFY_LEAD FIREBASE_ANDROID_CLOSE_CONVERT_LEAD FIREBASE_IOS_GENERATE_LEAD FIREBASE_IOS_QUALIFY_LEAD FIREBASE_IOS_CLOSE_CONVERT_LEAD
بنود عامة
UserListErrorEnum.DUPLICATE_LOOKALIKE	قيمة التعداد الجديدة / الخطأ	يتم عرض هذا الخطأ عند محاولة إنشاء قوائم متعدّدة متطابقة لشرائح الجمهور المشابهة.
التخطيط
حقول ProductCoreAttributes في ListPlannableProductsResponse	حقول جديدة	تمت إضافة وصف المنتج القابل للتخطيط، والهدف التسويقي، ونموذج التكلفة، وطريقة الشراء إلى ProductCoreAttributes ضمن ListPlannableProductsResponse.
التقارير
CartDataSalesView	مرجع جديد لإعداد التقارير	تعرض هذه السمة تقارير تقسّم مقاييس الإحالات الناجحة حسب المنتج المحدّد الذي تمّ بيعه (العلامة التجارية وما إلى ذلك) بالإضافة إلى المنتج الذي تمّ النقر عليه.
مقاييس غير قابلة للمزايدة	حقول جديدة	تمت إضافة مقاييس غير قابلة للمزايدة (مقاييس تعرض الإحالات الناجحة التي لا تعمل الحملات على تحسينها) إلى جميع المراجع المطابقة: all_average_cart_size all_average_order_value_micros all_cost_of_goods_sold_micros all_cross_sell_cost_of_goods_sold_micros all_cross_sell_gross_profit_micros all_cross_sell_revenue_micros all_cross_sell_units_sold all_gross_profit_margin all_gross_profit_micros all_lead_cost_of_goods_sold_micros all_lead_gross_profit_micros all_lead_revenue_micros all_lead_units_sold all_orders all_revenue_micros all_units_sold
conversion_attribution_event_type	شريحة جديدة	تمت الإضافة إلى ShoppingPerformanceView.
تسوّق
"حملات التطبيقات" في ShoppingProduct	ميزة جديدة	"حملات التطبيقات" المتوافقة داخل مرجع ShoppingProduct لا تتوفّر حالة الملاحظة والمشاكل.
فلترة المنتجات المستندة إلى العلامات	ميزة جديدة	تمّت إضافة إمكانية الفلترة باستخدام تعبيرات المجموعات المنطقية بشكلٍ ديناميكي: تمت إضافة نوعَي المعايير RETAIL_FILTER_BUNDLE وRETAIL_FILTER. تمت إضافة نوع المجموعة المشترَكة RETAIL_FILTER. تمت إضافة الحقل retail_filter_bundle إلى AdGroupCriterion. تمت إضافة الحقل retail_filter إلى SharedCriterion. تمت إضافة RETAIL إلى ListingGroupFilterListingSource. تمت إضافة السمة RetailFilter إلى AssetGroupListingGroupFilter. تمت إضافة أخطاء التحقّق الجديدة ذات الصلة في CriterionError وAssetGroupListingGroupFilterError. لا تتوفّر هذه الميزة إلا للحسابات المُدرَجة في القائمة المسموح بها.

الإصدارات الرئيسية والثانوية من الإصدار 23

يتضمّن الإصدار 23 من Google Ads API الميزات والتحديثات والتغييرات غير المتوافقة التالية.

الإصدار 23.3 (‎24/06/2026)

تمت إضافة الميزات والتحديثات الجديدة التالية في الإصدار 23.3 من Google Ads API. لا تحتوي الإصدارات الثانوية، مثل الإصدار 23.3، على تغييرات غير متوافقة.

الميزات والتحديثات	النوع	الوصف
بنود عامة
Asset.synthetic_content_info Ad.synthetic_content_info	حقول جديدة	أن تتضمّن شهادات صحة للمحتوى الاصطناعي أو من إنشاء الذكاء الاصطناعي، مقسّمة إلى advertiser_attestation (الإقرارات التي يقدّمها المعلِن مباشرةً) وsystem_attestation (شهادات الصحة التي ترصدها أنظمة Google تلقائيًا أو تقدّمها). لمساعدتك في التخطيط لعملية الدمج القادمة للإصدار 25، سيتم طرح واجهة لتعديل حقول شهادة المعلِن في وقت مبكر للإصدار 22 والإصدارات الأحدث. تظهر الواجهة في هذه الإصدارات، ولكن سيظل synthetic_content_info.advertiser_attestation.status وsynthetic_content_info.advertiser_attestation.source غير قابلَين للتغيير في هذه الإصدارات. إذا حاولت إجراء طلب تغيير على أيّ من هذين الحقلَين، سيتم عرض أحد الأخطاء التالية: "The field attempted to be mutated is immutable" أو "Field cannot be set". ستصبح هذه الحقول قابلة للتعديل بالكامل بدءًا من الإصدار 25. ننصحك باستخدام الواجهة الآن لإنشاء واختبار المنطق الداخلي حتى يكون نظامك جاهزًا لإمكانات الكتابة الكاملة عند إطلاق الإصدار 25.
موافقات الجهات المتعددة	الميزات الجديدة	إصدار تجريبي: هذه الميزة قيد التجربة حاليًا، وقد تتغير في الإصدارات المستقبلية. تمت إضافة إمكانية مراجعة موافقات التفويض من جهات متعدّدة (MPA): تمت إضافة المورد MultiPartyAuthReview وMultiPartyAuthReviewService المقابل. تمت إضافة تعداد MultiPartyAuthReviewStatus لتتبُّع حالة المراجعة. تمت إضافة CustomerUserAccess.pending_multi_party_auth_review للربط بمراجعة في انتظار المراجعة. تمت إضافة MutateCustomerUserAccessResult.multi_party_auth_review وMutateCustomerUserAccessInvitationResult.multi_party_auth_review لعرض اسم مورد المراجعة المرتبط. تمت إضافة MultiPartyAuthReviewError لأخطاء التحقّق.

الإصدار 23.2 (‎25/03/2026)

تمّت إضافة الميزات والتحديثات الجديدة التالية في الإصدار 23.2 من Google Ads API. لا تتضمّن الإصدارات الثانوية، مثل الإصدار 23.2، تغييرات غير متوافقة مع الإصدارات السابقة.

الميزات والتحديثات	النوع	الوصف
مواد العرض
VideoEnhancement	مورد جديد	يحتوي على معلومات خاصة بإعلانات الفيديو المحسّنة، مثل ما إذا كانت من إنشاء Google أو من تقديم المعلِن. يمكنك الاطّلاع على لمحة عن تحسينات الفيديو لمزيد من المعلومات.
AppTopCombinationView	مورد جديد	مورد للقراءة فقط يقدّم إحصاءات عن مجموعات مواد العرض الأعلى أداءً في "حملات التطبيقات".
CustomerAsset	ميزة جديدة	تمت إضافة إمكانية استرداد CustomerAsset مع ضبط field_type على BUSINESS_LOGO.
الحملات
AdGroupAd.start_date_time AdGroupAd.end_date_time	حقول جديدة	توفير قيود جدولة أكثر تفصيلاً على تواريخ الحملة لا تتوفّر هذه الميزة إلا لبعض أنواع المجموعات الإعلانية.
HotelSettingInfo.disable_hotel_setting	حقل جديد	تتيح هذه السمة إيقاف خلاصة الفنادق في "حملات زيادة الطلب".
بنود عامة
CustomerClientLinkError	قيم التعداد الجديدة / الأخطاء	تمّت إضافة رمزي خطأ جديدَين: MAX_CUSTOMER_LIMIT_REACHED وACCOUNT_CREATION_POLICY_VIOLATION.
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS	تغيير السلوك	يحدث خطأ الآن عند محاولة استخدام فئة نوع العملاء هذه من قائمة المستخدمين التي تم إيقافها نهائيًا.
التخطيط
GenerateTrendingInsights GenerateCreatorInsights	الميزات الجديدة	تمت إضافة إمكانية استخدام مجموعات مخصّصة من "و" و/أو "أو" للعناصر والمواضيع وشرائح الجمهور.
ReachPlanService.GenerateReachForecast	قيم التعداد الجديدة	تمّت إضافة فئات عمرية جديدة يمكن استهدافها، مثل AGE_RANGE_21_44 أو AGE_RANGE_21_49.
youtube_select_lineup_targeting	حقل جديد	تمت إضافة هذا الحقل إلى ReachPlanService.ListPlannableProducts الذي سيحلّ محلّ youtube_select_lineups. يتم حاليًا ملء كلا الحقلين.
ReachPlanSurface	قيمة تعداد جديدة	تمت إضافة IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS كخيار لمساحة العرض.
Forecast	حقل جديد	تمّت إضافة clicks إلى استراتيجية "الحصول على الحدّ الأقصى من النقرات" (تكلفة النقرة) في "حملات زيادة الطلب" في ReachPlanService.GenerateReachForecast.
partnership_opportunities	حقل جديد	تمت إضافة الملفات إلى ContentCreatorInsightsService.GenerateCreatorInsights وContentCreatorInsightsService.GenerateTrendingInsights.
التقارير
biddable_indirect_install_first_in_app_conversion_micros	حقل جديد	تمت إضافة هذه الميزة إلى المراجع Campaign وCustomer وAdGroup.
الفيديوهات
ShareablePreviewService	ميزة جديدة	تمت إضافة دعم لمعاينات "بث YouTube المباشر" من خلال ضبط preview_type على YOUTUBE_LIVE_PREVIEW. تمت إضافة UNSUPPORTED_AD_TYPE وTOO_MANY_RESOURCES_IN_REQUEST إلى ShareablePreviewError. لا تتوفّر هذه الميزة إلا لبعض أنواع الإعلانات.

الإصدار 23.1 (‎25/02/2026)

تمت إضافة الميزات والتحديثات الجديدة التالية في الإصدار 23.1 من Google Ads API. لا تحتوي الإصدارات الثانوية، مثل الإصدار 23.1، على تغييرات غير متوافقة.

الميزات والتحديثات	النوع	الوصف
إدارة الحساب
advertising_partner_properties.allowed_domain	حقل جديد	تمت إضافته إلى الموردَين ProductLinkInvitation وProductLink. ولن يتمكّن الشريك الإعلاني من عرض الإعلانات إلا على هذا النطاق.
Customer.contains_eu_political_advertising	حقل جديد	تعرض هذه الطريقة حالة بيان الإفصاح على مستوى الحساب عمّا إذا كان يحتوي على إعلانات سياسية تستهدف الاتحاد الأوروبي، وتعرض EuPoliticalAdvertisingStatus.
الحملات
Campaign.text_guidelines	حقل جديد	أتحنا استخدام "إرشادات النصوص" التي يمكن استخدامها مع "حملات الأداء الأفضل" و"الحملات على شبكة البحث" للتحكّم آليًا في مواد العرض النصية من إنشاء الذكاء الاصطناعي. في text_guidelines، يمكنك تحديد term_exclusions وmessaging_restrictions.
CampaignPrimaryStatusReason	قيم التعداد الجديدة	تمت إضافة CAMPAIGN_NOT_BOOKED وBOOKING_HOLD_EXPIRING وBOOKING_HOLD_EXPIRED وBOOKING_CANCELLED لتقديم الأسباب الرئيسية للحالة في الحملات التي تستخدم استراتيجية عروض الأسعار FIXED_CPM.
Campaign.VideoCampaignSettings.reservation_ad_category_self_disclosure Campaign.VideoCampaignSettings.booking_details	حقول جديدة	تمّت إضافة إمكانية الإفصاح الذاتي عن فئة "الإعلانات المحجوزة" وتفاصيل الحجز للقراءة فقط.
Campaign.missing_eu_political_advertising_declaration	حقل جديد	تتيح طلب البحث عن الحملات التي لا تتضمّن بيانات إفصاح عمّا إذا كانت تحتوي على إعلانات سياسية تستهدف الاتحاد الأوروبي، وتتيح أيضًا فلترة هذه الحملات.
الإحالات الناجحة
ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS	قيمة تعداد جديدة	تتيح تتبُّع المستخدمين الذين يشاهدون إعلانًا ثم يشاهدون فيديو من القناة نفسها.
بنود عامة
CriterionErrorEnum.CANNOT_TARGET_ONLY_UNDETERMINED	قيمة التعداد الجديدة / الخطأ	يتم عرض هذا الخطأ عند محاولة استهداف فئة "غير محدّد" فقط في سمات الخصائص الديمغرافية.
الحوافز
IncentiveErrorEnum	قيم التعداد الجديدة / الأخطاء	تمّت إضافة رمزي خطأ جديدَين: MAX_INCENTIVES_REDEEMED وACCOUNT_TOO_OLD. يمكن أن تظهر هذه الأخطاء للطلبات التي يتم إرسالها في 11 مارس 2026 أو بعد هذا التاريخ.
التخطيط
GenerateBenchmarksMetrics	ميزة جديدة	تمت إضافة إمكانية تصنيف البيانات حسب التاريخ باستخدام BreakdownDefinition.
ReachPlanService.GenerateReachForecast	قيمة تعداد جديدة	تمّت إضافة GOOGLE_DISPLAY_NETWORK كمساحة عرض يمكن استهدافها في "حملات زيادة الطلب" التي تستخدم استراتيجية "تحقيق الحدّ الأقصى من الإحالات الناجحة".
GenerateTrendingInsights	حقول جديدة	تمت إضافة معلومات خط الاتجاه السابق في TrendInsightDataPoint إلى TrendInsights عند البحث حسب الموضوع.
التقارير
مقاييس عدد مرات الظهور للمستخدمين الفرديين	حقول جديدة	أضفنا مقاييس جديدة توضّح عدد المستخدمين الذين شاهدوا إعلانك مرّتين أو ثلاث أو أربع أو خمس أو عشر مرات على الأقل: unique_users_two_plus وunique_users_three_plus وunique_users_four_plus وunique_users_five_plus وunique_users_ten_plus.
SearchTermMatchSource	قيمة تعداد جديدة	أضفنا VERTICAL_ADS_DATA_FEED لدعم خلاصات بيانات الإعلانات العمودية، مثل استهداف كيانات "إعلانات السفر".
YouTubeVideoUpload
YouTubeVideoUpload	خدمة أو مرجع جديد	تمت إضافة خدمة YouTubeVideoUpload لإتاحة تحميل الفيديوهات وإدارتها على YouTube، ومورد YouTubeVideoUpload لإتاحة استرداد حالة التحميل والبيانات الوصفية. لا تتوفّر هذه الميزة إلا لخدمة REST ومكتبة برامج Python.

الإصدار 23 (‎28/01/2026)

تمت إضافة الميزات والتحديثات والتغييرات غير المتوافقة التالية في الإصدار 23 من Google Ads API، وهو إصدار رئيسي.

يمكنك الاطّلاع على الترقية إلى أحدث إصدار للحصول على إرشادات.

تغييرات قد تؤدي إلى أعطال

الحالة المبدئية	الحالة الجديدة	نوع التغيير	إرشادات التنفيذ
الإعلانات
مشاركة الإعلانات مسموح بها	AdGroupAdError.AD_SHARING_NOT_ALLOWED	تغيير في السلوك	لم يعُد مسموحًا بمشاركة الإعلانات بين مجموعات إعلانية متعدّدة. ستعرض الطلبات التي تحاول مشاركة الإعلانات الخطأ AD_SHARING_NOT_ALLOWED.
دعم CallAd وCallAdInfo	بلا	إزالة	تمت إزالة إمكانية استخدام "الإعلانات للاتصال". يُرجى الرجوع إلى مقالة مركز المساعدة لمحة عن "الإعلانات للاتصال".
الحملات
Campaign.start_date Campaign.end_date	Campaign.start_date_time Campaign.end_date_time	إعادة التسمية / الاستبدال	استخدِم حقول التاريخ والوقت الجديدة لتحديد مكوّنات الوقت للحملات. تتم إزالة الحقول الأصلية التي تحتوي على التاريخ فقط.
حملات زيادة الطلب
DemandGenMultiAssetAdInfo.lead_form_only	بلا	إزالة	تمت إزالة الحقل lead_form_only. عدِّل المراجع في الرمز.
التقارير
مقاييس وتعداد تصنيفات أداء مواد العرض المجمّعة	بلا	إزالة	تمت إزالة مقاييس تصنيف أداء مواد العرض المجمّعة. لم يعُد يتم عرض تعداد تصنيفات الأداء لكلّ من "شبكة البحث" و"الشبكة الإعلانية".

الميزات والتحديثات (غير المتوافقة مع الإصدارات السابقة)

الميزات والتحديثات	النوع	الوصف
الإعلانات
AdFormatType	قيم التعداد الجديدة	تمّت إضافة أنواع تنسيقات جديدة: TEXT وVERTICAL_ADS_BOOKING_LINK وVERTICAL_ADS_PROMOTION.
مواد العرض
asset_group مشاهدة	حقول جديدة	تمت إضافة المقاييس التالية: metrics.engagements وmetrics.engagement_rate وmetrics.average_cpe.
asset_group_asset مشاهدة	حقول جديدة	تمت إضافة المقاييس التالية: metrics.average_cpe وmetrics.average_cpm وmetrics.trueview_average_cpv وmetrics.video_trueview_view_rate وmetrics.video_trueview_views وmetrics.interaction_event_types.
Asset.orientation	حقل جديد	تمّت إضافة حقل الاتجاه للقراءة فقط إلى مواد عرض الصور والفيديوهات.
CampaignAsset	ميزة جديدة	تمت إضافة إمكانية استرداد مواد عرض الحملة مع ضبط field_type على HEADLINE وDESCRIPTION.
ServedAssetFieldType	قيم التعداد الجديدة	تمّت إضافة HEADLINE_AS_SITELINK_POSITION_ONE وHEADLINE_AS_SITELINK_POSITION_TWO وDESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE وDESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO لمواد العرض التي يتم عرضها كروابط أقسام الموقع.
BusinessMessageAsset	الميزات الجديدة / الدعم	مواد عرض الرسائل من العملاء المعدَّلة: أضفنا إمكانية استخدام Facebook Messenger وZalo كموفّري خدمات. تمت إضافة FACEBOOK_MESSENGER وZALO إلى BusinessMessageProvider. تمت إضافة الحقلَين facebook_messenger_info وzalo_info. تمت إضافة CUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETS إلى AssetError.
الفوترة
InvoiceService.ListInvoices	خيارات جديدة	يمكنك الآن عرض تفاصيل أكثر دقة في Invoice، بما في ذلك تقسيم التكلفة على مستوى الحملة والتكاليف التنظيمية المفصّلة ومعلومات التسوية، وذلك من خلال ضبط include_granular_level_invoice_details في ListInvoicesRequest.
RegulatoryFeeType UnitOfMeasure	تعدادات جديدة	تمت إضافة تعدادات مساعدة للرسوم التنظيمية ووحدات القياس.
الحملات
CampaignError	قيم التعداد الجديدة / الأخطاء	تمّت إضافة رمزي الخطأ DURATION_TOO_LONG_FOR_TOTAL_BUDGET وEND_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET.
الإحالات الناجحة
ConversionActionCategory	قيمة تعداد جديدة	تمت إضافة YOUTUBE_FOLLOW_ON_VIEWS لتتبُّع المستخدمين الذين يشاهدون إعلانًا ثم يشاهدون فيديو من القناة نفسها.
حملات زيادة الطلب
DemandGenVideoResponsiveAdInfo.companion_banner	حقل جديد	أتحنا استخدام إعلانات البانر المصاحبة في "إعلانات الفيديو المتجاوبة" ضمن "حملات زيادة الطلب".
الحوافز
تمت إضافة ميزة "اختَر هديتك": تمت إضافة الطريقة FetchIncentive لاسترداد الحوافز المخصّصة المتاحة لأحد المستخدمين. تمت إضافة الطريقة ApplyIncentive لتطبيق حافز محدّد على حساب عميل. تمت إضافة المرجع AppliedIncentive (يمكن البحث فيه باستخدام Search وSearchStream) لتقديم تفاصيل الاسترداد. تمت إضافة رموز خطأ جديدة في IncentiveError وAuthenticationError.INVALID_EMAIL_ADDRESS. لتسهيل التعامل الآلي الأكثر دقة مع حالات الأعطال، سنضيف رموز خطأ إضافية إلى IncentivesService في الإصدارات المستقبلية. ننصحك بمتابعة الإشعارات القادمة وملاحظات الإصدار الخاصة برموز الخطأ الجديدة هذه للتأكّد من أنّ تطبيقاتك يمكنها التعامل مع أوضاع الأعطال الجديدة هذه.
التخطيط
AudienceInsightsDimension.LIFE_EVENT_USER_INTEREST	قيمة تعداد جديدة	تتيح إنشاء شرائح جمهور باستخدام "الأحداث في الحياة" في GenerateAudienceCompositionInsights وGenerateSuggestedTargetingInsights وGenerateInsightsFinderReport وGenerateCreatorInsights. لا تتوفّر "أحداث الحياة" لطرق AudienceInsightsService الأخرى، مثل AudienceInsightsService.GenerateAudienceOverlap وAudienceInsightsService.GenerateTargetingSuggestionMetrics.
ReachPlanService.GenerateConversionRates	حقول / خيارات جديدة	يتضمّن الردّ الآن مساحات عرض لدعم اقتراحات معدّل الإحالات الناجحة استنادًا إلى عناصر التحكّم في مساحة العرض (مثل Gmail وShorts). تتوفّر هذه الميزة في "حملات زيادة الطلب" فقط.
LanguageDistribution	حقل / نوع جديد	تمت إضافة هذه السمة إلى YouTubeChannelInsights لتقديم تفاصيل حول توزيع اللغات في محتوى قناة على YouTube.
BenchmarksService	خدمة جديدة	تقارن هذه الأداة بيانات الإعلانات على YouTube بمقاييس الأداء في المجال.
AudienceInsightsService.GenerateAudienceDefinition	طريقة جديدة	تترجم هذه الميزة وصفًا نصيًا حرًا للجمهور المستهدف إلى سمات جمهور مطابقة باستخدام الذكاء الاصطناعي التوليدي.
YouTubeChannelInsights.relevance_score	حقل جديد	تقيِّم هذه الميزة مدى ملاءمة صانع محتوى لموضوع معيّن، مع الأخذ في الاعتبار عدد المشاهدات.
TrendInsightMetrics.trend_change_percent	حقل جديد	تمثّل هذه السمة نسبة التغيّر في قيمة مؤشر معيّن خلال فترة المقارنة.
الاقتراحات
GenerateRecommendationsRequest	حقل جديد	تمت إضافة is_new_customer. عند ضبطها على true لاقتراحات CAMPAIGN_BUDGET، تستخدِم نموذجًا محسّنًا للعملاء الجدد (يُنصح به فقط للعملاء الذين ليس لديهم حملات).
التقارير
AdGroupAdAssetView	دعم الميزات / المقاييس الجديدة	تتيح الآن مقاييس مرات الظهور والأداء والإحالات الناجحة لـ RESPONSIVE_DISPLAY_AD.
شريحة ad_sub_network_type	شريحة جديدة	تقدّم هذه السمة تفصيلاً دقيقًا للأداء ضمن شبكة إعلانية. تتوفّر هذه الميزة في البداية لـ "حملات زيادة الطلب" على YouTube ("الإعلانات أثناء عرض الفيديو" و"الإعلانات ضمن الخلاصة" وShorts). يجب تحديدها مع ad_network_type.
تقارير "حملات الأداء الأفضل"	ميزة جديدة	تم تفعيل تقسيم أنواع شبكات الإعلانات لحملات الأداء الأفضل.
UserLocationView GeographicView	إتاحة شرائح جديدة	مقاييس الدعم مقسّمة حسب تاريخ الإحالة الناجحة: conversions_by_conversion_date وall_conversions_by_conversion_date وconversions_value_by_conversion_date وall_conversions_value_by_conversion_date وvalue_per_conversions_by_conversion_date وvalue_per_all_conversions_by_conversion_date وcross_device_conversions_by_conversion_date وcross_device_conversions_value_by_conversion_date.
شرائح الإعلانات العمودية	شرائح جديدة	تمت إضافة شرائح الجمهور التالية: vertical_ads_event_participant_display_names وvertical_ads_hotel_class وvertical_ads_listing وvertical_ads_listing_brand وvertical_ads_listing_city وvertical_ads_listing_country وvertical_ads_listing_region وvertical_ads_partner_account وvertical_ads_vertical.
PerStoreView MatchedLocationInterestView	مراجع جديدة لإعداد التقارير	تمت إضافة PerStoreView للاستعلام عن تفاصيل موقع المتجر، وMatchedLocationInterestView (لحملات AI Max) لتقديم مقاييس الأداء حسب المواقع الجغرافية التي تهمّك.
تسوّق
ShoppingPerformanceView	إتاحة مقاييس جديدة	تتوفّر الآن المقاييس التالية مقسّمة حسب تاريخ الإحالة الناجحة: conversions_by_conversion_date وall_conversions_by_conversion_date وconversions_value_by_conversion_date وvalue_per_conversions_by_conversion_date وvalue_per_all_conversions_by_conversion_date.
ShoppingPerformanceView	إتاحة مقاييس جديدة	تمت إضافة دعم لـ: search_budget_lost_impression_share وsearch_rank_lost_impression_share وsearch_budget_lost_absolute_top_impression_share وsearch_rank_lost_absolute_top_impression_share.
ShoppingProduct.product_image_uri	حقل جديد	تمت الإضافة إلى ShoppingProduct.
الإعلانات العمودية
AdGroup.vertical_ads_format_setting	حقل جديد	تتيح هذه الميزة التحكّم في أشكال الإعلانات التي يمكن عرضها في "الحملات على شبكة البحث" باستخدام خلاصات السفر.
AdGroupCriterion SharedCriterion	حقول / معايير جديدة	تمت إضافة نوع المعيار vertical_ads_item_group_rule_list إلى AdGroupCriterion وvertical_ads_item_group_rule إلى SharedCriterion للسماح باستهداف مجموعات عناصر في "حملات البحث" باستخدام خلاصات السفر.
دمج خلاصة بيانات الأداء مع إعلانات الفئة	ميزة جديدة	يمكنك الآن ربط خلاصة بيانات الإعلانات المتخصّصة بحملة على شبكة البحث تستخدم ميزات AI Max لعرض إعلانات السفر التي تتضمّن عروضًا ترويجية للفنادق وروابط حجز إلى جانب الإعلانات النصية. يمكنك التحكّم في التنسيقات باستخدام vertical_ads_format_setting وتحديد القواعد باستخدام vertical_ads_item_group_rule. تقسيم التقارير حسب AdFormatType وسمات خلاصة بيانات الإعلانات العمودية
الفيديوهات
AdVideoAssetInfo.ad_video_asset_feature_control	حقل جديد	تمت إضافة خيارات التحكّم في الميزات لمواد عرض إعلانات الفيديو.
CampaignCriterionError	قيمة التعداد الجديدة / الخطأ	تمت إضافة رمز الخطأ INVALID_VIDEO_LINEUP_ID.
مقاييس إمكانية سماع المحتوى على YouTube	المقاييس الجديدة	أضفنا مقاييس إمكانية سماع الإعلانات الصوتية على YouTube، والتي توضّح ما إذا كان الإعلان مسموعًا وعدد مرّات الظهور التي يمكن فيها قياس إمكانية سماع الإعلان.

الإصدارات الرئيسية والثانوية من الإصدار 22

يتضمّن الإصدار 22 من Google Ads API الميزات والتحديثات والتغييرات غير المتوافقة التالية.

الإصدار 22.2 (‎24/06/2026)

تمّت إضافة الميزات والتحديثات الجديدة التالية في الإصدار 22.2 من Google Ads API. لا تتضمّن الإصدارات الثانوية، مثل الإصدار 22.2، تغييرات غير متوافقة مع الإصدارات السابقة.

الميزات والتحديثات	النوع	الوصف
بنود عامة
Asset.synthetic_content_info Ad.synthetic_content_info	حقول جديدة	أن تتضمّن شهادات صحة للمحتوى الاصطناعي أو من إنشاء الذكاء الاصطناعي، مقسّمة إلى advertiser_attestation (الإقرارات التي يقدّمها المعلِن مباشرةً) وsystem_attestation (شهادات الصحة التي ترصدها أنظمة Google تلقائيًا أو تقدّمها). لمساعدتك في التخطيط لعملية الدمج القادمة للإصدار 25، سيتم طرح واجهة لتعديل حقول شهادة المعلِن في وقت مبكر للإصدار 22 والإصدارات الأحدث. تظهر الواجهة في هذه الإصدارات، ولكن سيظل synthetic_content_info.advertiser_attestation.status وsynthetic_content_info.advertiser_attestation.source غير قابلَين للتغيير في هذه الإصدارات. إذا حاولت إجراء طلب تغيير على أيّ من هذين الحقلَين، سيتم عرض أحد الأخطاء التالية: "The field attempted to be mutated is immutable" أو "Field cannot be set". ستصبح هذه الحقول قابلة للتعديل بالكامل بدءًا من الإصدار 25. ننصحك باستخدام الواجهة الآن لإنشاء واختبار المنطق الداخلي حتى يكون نظامك جاهزًا لإمكانات الكتابة الكاملة عند إطلاق الإصدار 25.
موافقات الجهات المتعددة	الميزات الجديدة	إصدار تجريبي: هذه الميزة قيد التجربة حاليًا، وقد تتغير في الإصدارات المستقبلية. تمت إضافة إمكانية مراجعة موافقات التفويض من جهات متعدّدة (MPA): تمت إضافة المورد MultiPartyAuthReview وMultiPartyAuthReviewService المقابل. تمت إضافة تعداد MultiPartyAuthReviewStatus لتتبُّع حالة المراجعة. تمت إضافة CustomerUserAccess.pending_multi_party_auth_review للربط بمراجعة في انتظار المراجعة. تمت إضافة MutateCustomerUserAccessResult.multi_party_auth_review وMutateCustomerUserAccessInvitationResult.multi_party_auth_review لعرض اسم مورد المراجعة المرتبط. تمت إضافة MultiPartyAuthReviewError لأخطاء التحقّق.

الإصدار 22.1 (‎25-02-2026)

تمت إضافة الميزة الجديدة التالية في الإصدار 22.1 من Google Ads API. لا تحتوي الإصدارات الثانوية، مثل الإصدار 22.1، على تغييرات غير متوافقة مع الإصدارات السابقة.

الميزات والتحديثات	النوع	الوصف
إدارة الحساب
Customer.contains_eu_political_advertising	حقل جديد	تعرض هذه الطريقة حالة بيان الإفصاح على مستوى الحساب عمّا إذا كان يحتوي على إعلانات سياسية تستهدف الاتحاد الأوروبي، وتعرض EuPoliticalAdvertisingStatus.
الحملات
Campaign.missing_eu_political_advertising_declaration	حقل جديد	تتيح طلب البحث عن الحملات التي لا تتضمّن بيانات إفصاح عمّا إذا كانت تحتوي على إعلانات سياسية تستهدف الاتحاد الأوروبي، وتتيح أيضًا فلترة هذه الحملات.

الإصدار 22 (‎15/10/2025)

تمت إضافة الميزات والتحديثات والتغييرات غير المتوافقة التالية في الإصدار 22 من Google Ads API، وهو إصدار رئيسي.

يمكنك الاطّلاع على الترقية إلى أحدث إصدار للحصول على إرشادات.

تغييرات قد تؤدي إلى أعطال

الحالة المبدئية	الحالة الجديدة	نوع التغيير	إرشادات التنفيذ
حملات زيادة الطلب
BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros	minimum_budget_amount_micros	إعادة التسمية / تصحيح الأخطاء الإملائية	أعِد تسمية المراجع لاستخدام اسم الحقل المعدَّل.
بنود عامة
ما مِن حدّ أقصى لعدد العمليات في AddBatchJobOperations	الحد الأقصى لعدد العمليات لكل طلب هو 10,000 عملية	تغيير في السلوك	تأكَّد من أنّ أي طلب AddBatchJobOperations لا يحتوي على أكثر من 10,000 عملية.
تم تحديد الحد الأقصى لحجم الصفحة بشكل غير ملحوظ عند 1,000 في ListBatchJobResultsRequest	عرض الخطأ INVALID_PAGE_SIZE	تغيير في السلوك	تأكَّد من ضبط ListBatchJobResultsRequest.page_size على 1,000 أو أقل، لأنّ طلب حجم صفحة أكبر سيؤدي الآن إلى حدوث خطأ.
حملات الأداء الأفضل
تصنيفات أداء مواد العرض	بلا	إزالة	تمت إزالة ميزة تصنيفات أداء مواد العرض وقائمة تعداد تصنيفات الأداء المرتبطة بها من "حملات الأداء الأفضل". عدِّل عمليات الدمج وفقًا لذلك.
Campaign.url_expansion_opt_out	علم FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION في AssetAutomationSetting	الإزالة أو الاستبدال	استخدِم إعدادات التشغيل الآلي لمواد العرض النصية الخاصة بميزة "توسيع عنوان URL النهائي". تمت إزالة حقل إيقاف ميزة "توسيع عنوان URL" على مستوى الحملة.
التخطيط
views	trueview_views	الإزالة أو الاستبدال	استبدِل المراجع إلى views بالحقل الجديد trueview_views في ReachPlanService.
الفيديوهات
average_cpv video_view_rate video_views video_view_rate_in_feed video_view_rate_in_stream video_view_rate_shorts	trueview_average_cpv video_trueview_view_rate video_trueview_views video_trueview_view_rate_in_feed video_trueview_view_rate_in_stream video_trueview_view_rate_shorts	عمليات إعادة التسمية	تعديل سلاسل طلبات البحث وعمليات الدمج لاستخدام أسماء المقاييس الجديدة التي تمثّل مشاهدات الفيديو على TrueView

الميزات والتحديثات (غير المتوافقة مع الإصدارات السابقة)

الميزات والتحديثات	النوع	الوصف
مواد العرض
AssetFieldType.LANDING_PAGE_PREVIEW	قيمة تعداد جديدة	تمت إضافته كنوع حقل جديد لمادة عرض الصورة.
AssetGenerationService	خدمة جديدة (إصدار تجريبي)	يسمح بإنشاء مواد عرض نصية ومواد عرض صور باستخدام الذكاء الاصطناعي التوليدي: GenerateText: لإنشاء نص استنادًا إلى عنوان URL النهائي والطلبات والكلمات الرئيسية وما إلى ذلك GenerateImages: تنشئ هذه الأداة صورًا استنادًا إلى عنوان URL النهائي أو الطلبات أو إعادة صياغة سياق صور المنتجات. يتم عرض الأخطاء مع رموز من AssetGenerationError. تتوفّر في البداية لمجموعة محدودة فقط من المشاركين في الإصدار التجريبي المغلق.
الحملات
AppCampaignBiddingStrategyGoalType	قيم التعداد الجديدة	تمّت إضافة أهداف جديدة إلى "حملات التطبيقات لجذب عمليات التثبيت" من أجل التحسين بدون تحديد هدف: OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA: استخدِمها مع استراتيجية "تحقيق الحد الأقصى من الإحالات الناجحة" العادية. OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS: استخدِمها مع استراتيجية "تحقيق الحد الأقصى من قيمة الإحالات الناجحة" العادية.
BiddingStrategyType	ميزة جديدة	تمّت إضافة إمكانية استخدام نوع استراتيجية عروض الأسعار "نسبة الإنفاق الثابتة".
Campaign.feed_types	حقل جديد	تعرِض هذه السمة أنواع الخلاصات المرفقة بحملة. بالنسبة إلى "حملات الأداء الأفضل"، يمكن أن يشير ذلك إلى مجال النشاط التجاري، مثل MERCHANT_CENTER_FEED للبيع بالتجزئة.
استهداف المجموعة المشتركة	ميزة جديدة	تم السماح بإرفاق مجموعات مشترَكة من الكلمات الرئيسية السلبية بحملات على قنوات متعددة (لحملات التطبيقات) وحملات محلية.
حملات زيادة الطلب
TargetCPC bidding	ميزة جديدة	تمّت إضافة استراتيجية عروض أسعار للحصول على الحدّ الأقصى من النقرات بتكلفة النقرة المستهدَفة: يمكنك ضبط تكلفة النقرة المستهدَفة على مستوى الحملة باستخدام Campaign.target_cpc وتجاوزها على مستوى المجموعة الإعلانية باستخدام AdGroup.target_cpc_micros.
AssetAutomationType.GENERATE_DESIGN_VERSIONS_FOR_IMAGES	قيمة تعداد جديدة	في حال تفعيل هذه الميزة في DemandGenMultiAssetAdInfo، ستتم إضافة عناصر تصميم وتضمين مواد عرض نصية في مواد عرض الصور لإنشاء مواد عرض صور جديدة بنِسب عرض إلى ارتفاع مختلفة (تكون هذه الميزة مفعّلة تلقائيًا).
AssetAutomationType.GENERATE_VIDEOS_FROM_OTHER_ASSETS	قيمة تعداد جديدة	في حال تفعيلها مقابل DemandGenMultiAssetAdInfo، تنشئ فيديوهات باستخدام مواد عرض أخرى، مثل الصور والنصوص، ويمكن استخدامها بعد ذلك لإنشاء مثيلات جديدة من DemandGenVideoResponsiveAdInfo (يتم تفعيلها تلقائيًا).
بنود عامة
ListBatchJobResultsRequest الاحتياطي لحجم الصفحة	تغيير السلوك	إذا لم يتم ضبط page_size أو كانت قيمته 0، سيتم ضبط القيمة التلقائية الآن على 1,000 كحد أقصى (كانت القيمة المعروضة سابقًا هي INVALID_PAGE_SIZE).
QuotaError	قيمة التعداد الجديدة / الخطأ	تمت إضافة PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED للإشارة إلى تجاوز الحد الأقصى لمعدّل تفعيل ملف الدفع.
حملات الأداء الأفضل
إعدادات برمجة مواد العرض	قيم التعداد الجديدة	تمت إضافة خيارات جديدة لتفعيل ميزة التشغيل الآلي لمواد عرض "حملات الأداء الأفضل": GENERATE_IMAGE_ENHANCEMENT: تتيح إنشاء صور محسّنة تلقائيًا (القص التلقائي). يتم تفعيل هذه الميزة تلقائيًا. GENERATE_IMAGE_EXTRACTION: مصدر الصور من عناوين URL النهائية، ويتم ضبطها تلقائيًا على إعداد "إضافات الصور الديناميكية" في الحساب.
شرائح إعداد التقارير في "حملات الأداء الأفضل"	شرائح جديدة	تمّت إضافة شرائح جمهور جديدة خاصة بـ "حملات الأداء الأفضل": ad_using_product_data: تشير إلى ما إذا كان الإعلان يستخدم بيانات المنتجات من Google Merchant Center. ad_using_video: تشير إلى ما إذا كان الإعلان يستخدم مادة عرض فيديو.
التخطيط
قوائم بيانات شركاء إدارة علاقات العملاء	ميزة جديدة / قيمة تعداد جديدة	تمّت إضافة THIRD_PARTY_PARTNER_DATA إلى مصادر بيانات نظام إدارة علاقات العملاء، بالإضافة إلى رموز الخطأ في التحقّق من صحة شرائح جمهور الشركاء (مثل قبول بنود الخدمة، والارتباط المفقود، وما إلى ذلك).
مقاييس صنّاع المحتوى في البث المباشر	حقل جديد	تمت إضافة YouTubeMetrics.is_active_live_stream_creator، وهي قيمة تعرضها "إحصاءات صنّاع المحتوى" للإشارة إلى ما إذا كان صانع المحتوى قد نشر بثًا مباشرًا في آخر 90 يومًا.
البيانات الوصفية لمصدر نظام إدارة علاقات العملاء القابل للتخطيط	رسالة جديدة	أضفنا PlannableUserListMetadata داخل PlannableUserList، التي تعرضها ReachPlanService.ListPlannableUserLists، لعرض أنواع مصادر بيانات نظام إدارة علاقات العملاء.
إتاحة فيديوهات وصنّاع محتوى ذوي صلة في TrendInsight	حقول جديدة	أضفنا إمكانية استخدام السمتَين related_videos وrelated_creators على TrendInsight، وسمات الساعات في video_properties وpublish_date.
تحسينات على InsightsFinder	ميزة جديدة	يتيح GenerateInsightsFinderReport الآن استخدام parental_status وincome_ranges والمزيد من المجموعات الأكثر تعقيدًا لاستهداف شرائح الجمهور باستخدام AND/OR.
التقارير
أنواع النقرات الجديدة	قيم التعداد الجديدة	تمت إضافة CLICK_TO_MESSAGE_THIRD_PARTY_CLICK وCLICK_TO_MESSAGE_LANDING_PAGE_CLICK.
تقسيم AssetGroupAsset	إتاحة شرائح جديدة	يمكن الآن تقسيم AssetGroupAsset حسب device وconversion_action وconversion_action_name وconversion_action_category.
الإعلانات المتجاوبة على شبكة البحث في AdGroupAdAssetView	دعم الميزات / المقاييس الجديدة	تتيح AdGroupAdAssetView الآن بشكل كامل مقاييس الأداء والإحالات الناجحة لـ RESPONSIVE_SEARCH_AD (في السابق، كان يتم عرض مرّات الظهور فقط).
تقسيمات مقاييس مجموعات طلبات البحث الاستكشافية	إتاحة شرائح جديدة	يمكن الآن تقسيم المقاييس clicks_unique_query_clusters وconversions_unique_query_clusters وimpressions_unique_query_clusters حسب حقول التاريخ.
TargetingExpansionView	مرجع جديد لإعداد التقارير	تمت إضافة TargetingExpansionView لعرض مقاييس التوسّعات التي تتجاوز الاستهداف اليدوي، مثل التوسّع غير المستند إلى كلمات رئيسية في "AI Max في الحملات على شبكة بحث Google".
تسوّق
حلّ مشكلة نطاق Shopping	إصلاح الخطأ	تم إصلاح نطاق مقاييس الحملة والمجموعة الإعلانية في المرجع ShoppingProduct.
الأهداف الموحَّدة
أهداف الاحتفاظ بالعملاء	ميزة جديدة	تمّت إضافة إمكانية استخدام أهداف الاحتفاظ بالعملاء لتحسين الحملة من أجل إعادة جذب العملاء الحاليين (على سبيل المثال، استخدام target_option مع TARGET_SPECIFIC أو TARGET_ALL).
الفيديوهات
مقاييس أوقات مشاهدة الفيديو	حقول جديدة	أضفنا مقاييس مدة وقت المشاهدة: video_watch_time_duration_millis (المدة الإجمالية) وaverage_video_watch_time_duration_millis (متوسط المدة لكل مرة ظهور).

ملاحظات الإصدار المؤرشفة

يمكنك الاطّلاع على الإصدارات المتوقّفة نهائيًا للاطّلاع على ملاحظات الإصدار المؤرشفة.