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

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

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

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

الإصدار 25.2‏ (‎23/09/2026)

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

الميزات والتحديثات	النوع	الوصف
مواد العرض
خيارات عناوين URL للحساب AssetGroup	حقول جديدة	تمّت إضافة إمكانية استخدام خيارات عناوين URL على AssetGroup، ما يتيح للمعلِنين تحديد نماذج التتبّع والمَعلمات المخصّصة ولاحقات عناوين URL النهائية على مستوى مجموعة مواد العرض: AssetGroup.tracking_url_template: نموذج عنوان URL لإنشاء عنوان URL للتتبّع. AssetGroup.url_custom_parameters: قائمة بعمليات الربط التي سيتم استخدامها لاستبدال علامات مَعلمات عناوين URL المخصّصة في tracking_url_template أو final_urls أو final_mobile_urls. AssetGroup.final_url_suffix: نموذج عنوان URL لإلحاق المَعلمات بعناوين URL الخاصة بالصفحات المقصودة التي يتم عرضها باستخدام ميزة "التتبُّع الموازي".
الحملات
معلومات حول الزحف التلقائي إلى الفيديوهات	حقول وقيم تعدادية جديدة	تمّت إضافة AutomatedVideoCrawlSetting إلى Campaign.AssetAutomationSetting، بالإضافة إلى AssetAutomationType.AUTOMATED_VIDEO_CRAWL، ما يتيح لك تحديد إعدادات الزحف التلقائي إلى الفيديو في "حملة الأداء الأفضل". يحتوي AutomatedVideoCrawlSetting.automated_video_crawl_infos على قائمة بإدخالات AutomatedVideoCrawlInfo، يضبط كل منها url الزحف وsource_platform (VideoCrawlSourcePlatform: LANDING_PAGE أو SOCIAL أو YOUTUBE) وحالة الموافقة enabled.
أخطاء مُضاعِف القيمة في ميزة "تحسين مراحل نشاط العملاء"	قيم التعداد والأخطاء الجديدة	تمت إضافة أسباب جديدة لخطأ التحقّق من الصحة عند ضبط مُضاعِفات القيمة (value_multiplier وhigh_lifetime_value_multiplier) لميزة "تحسين الحملات استنادًا إلى قيمة العميل ومراحل نشاطه": GoalError: HIGH_LIFETIME_VALUE_MULTIPLIER_PRESENT_BUT_VALUE_MULTIPLIER_ABSENT HIGH_LIFETIME_VALUE_MULTIPLIER_LESS_THAN_OR_EQUAL_TO_VALUE_MULTIPLIER CampaignGoalConfigError: HIGH_LIFETIME_VALUE_MULTIPLIER_PRESENT_BUT_VALUE_MULTIPLIER_ABSENT HIGH_LIFETIME_VALUE_MULTIPLIER_LESS_THAN_OR_EQUAL_TO_VALUE_MULTIPLIER CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_MULTIPLIER_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE
SmartCampaignSettingService.GeneratePMaxDraftCampaign	ميزة جديدة	تمّت إضافة SmartCampaignSettingService.GeneratePMaxDraftCampaign للسماح بإنشاء مسودة "حملة أداء أفضل" من "حملة ذكية" حالية، وتمّت تهيئتها بحالة CampaignStatus.PAUSED وحالة إنشاء CampaignCreationStatus.INCOMPLETE (راجِع تحويل الحملات الذكية إلى "حملات أداء أفضل"): اضبط قيمة GeneratePMaxDraftCampaignRequest.validate_only على true للتحقّق من صحة الإحالة الناجحة وتلقّي أي تحذيرات بشأن التحقّق من الصحة أو مشاكل في الإحالة الناجحة في GeneratePMaxDraftCampaignResponse.validated_info بدون إنشاء حملة اختبارية. (اترك gbp_enabled وimage_enabled بدون ضبط أو اضبطهما على false، إذ لا تتوفّر حاليًا إمكانية ضبطهما على true وسيؤدي ذلك إلى عرض الخطأ SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED أو SmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.) تعرض الدالة GeneratePMaxDraftCampaignResponse أسماء موارد الكيانات التي تم إنشاؤها (pmax_campaign وcampaign_budget وasset_group وassets) بالإضافة إلى validated_info.
الإحالات الناجحة
مرات ظهور الإعلان على Firebase	أنواع وفئات جديدة لإجراءات الإحالات الناجحة	تم عرض نوعَي إجراءات الإحالات الناجحة FIREBASE_ANDROID_APP_AD_IMPRESSION وFIREBASE_IOS_APP_AD_IMPRESSION، ما يتيح لك استرداد إجراءات الإحالات الناجحة هذه وتعديلها. تم أيضًا عرض فئة IN_APP_AD_REVENUE في ConversionActionCategory لتتبُّع الإيرادات الناتجة عن تحقيق الربح من الإعلانات داخل التطبيق.
بنود عامة
BusinessProfileLocationSyncError	تعداد وأخطاء جديدة	تمت إضافة أسباب لأخطاء مزامنة الموقع الجغرافي في "الملف التجاري" عند مزامنة المواقع الجغرافية في AssetSet من النوع LOCATION_SYNC. بدلاً من عرض الخطأ العام UNKNOWN، تعرض واجهة برمجة التطبيقات الآن الخطأ BusinessProfileLocationSyncError مع أسباب محدّدة (EMAIL_INVALID وOAUTH_TOKEN_INVALID وACCOUNT_REMOVED وNO_PERMISSION_TO_ACCESS_LOCATION_ACCOUNT).
التخطيط
مقاييس الشريحة المئوية BenchmarksService.GenerateBenchmarksMetrics	الميزات الجديدة	تم تعديل BenchmarksService.GenerateBenchmarksMetrics لتقديم مقاييس تمثّل الوضع التنافسي للعميل بين المعلِنين الآخرين بتنسيق شريحة مئوية. يتم عرض المقاييس في PercentileMetrics في الحقل الجديد CustomerMetrics.percentile_metrics (في كلّ من GenerateBenchmarksMetricsResponse.customer_metrics وBreakdownMetrics.customer_metrics) ويتم تمثيلها باستخدام BenchmarksCustomerPercentileTier. لا تتم تعبئة CustomerMetrics.percentile_metrics إلا عند استيفاء الشرطين التاليين في GenerateBenchmarksMetricsRequest: تم طلب PERCENTILE_DATA في supplemental_data. يتم ضبط BenchmarksSource.all_advertisers على benchmarks_source (الذي يتطلّب أيضًا تحديد category_filter). تمّت إضافة إمكانية استخدام مقاييس النسبة المئوية لتواريخ ربع السنة المفتوح ضمن ListBenchmarksAvailableDatesResponse.supported_dates (يتمّ عرضها من خلال BenchmarksService.ListBenchmarksAvailableDates). في حين أنّ مقاييس إجمالي العملاء (CustomerMetrics.aggregate_metrics) ومقاييس معدّل العملاء (CustomerMetrics.average_rate_metrics) ومقاييس النسبة المئوية للعملاء (CustomerMetrics.percentile_metrics) متاحة في جميع التواريخ في supported_dates (بما في ذلك أرباع السنة المفتوحة)، لا تتوفّر مقاييس حصة العملاء (CustomerMetrics.share_metrics) ومقاييس المعدّل لمصدر مقاييس الأداء (average_benchmarks_metrics، مثل average_cpm لإعلانات "/Apparel/Clothing") لأرباع السنة المفتوحة ويتمّ حذفها من الردّ ما لم يقع date_range المطلوب ضمن النطاق الأضيق ListBenchmarksAvailableDatesResponse.supported_dates_for_all_metrics. تمّت إضافة خطأ مخصّص BenchmarksError.NO_METRICS_FOUND يشير إلى عدم العثور على مقاييس للتركيبة المحدّدة من المدخلات لتحسين سهولة الاستخدام.
الأسماء المعرّفة لقنوات على YouTube في "إحصاءات صنّاع المحتوى"	ميزة جديدة	تم تعديل ContentCreatorInsightsService.GenerateCreatorInsights لدعم البحث عن طريق الأسماء المعرّفة لقنوات على YouTube باستخدام YouTubeChannels.youtube_channel_handles (يجب أن تبدأ الأسماء المعرّفة للقنوات الصالحة بـ @، مثل @channel_handle). يشبه هذا الخيار البحث عن طريق معرّفات قنوات YouTube. تحتوي الاستجابة على إحصاءات حول صنّاع المحتوى المطلوبين على YouTube.
الاقتراحات
اقتراحات بشأن عروض أسعار التكلفة لكل إجراء وعائد الإنفاق الإعلاني	اقتراحات جديدة	تمّت إضافة Recommendation.raise_target_cpa_performance_bid_too_low_recommendation (RAISE_TARGET_CPA_PERFORMANCE_BID_TOO_LOW) وRecommendation.lower_target_roas_performance_bid_too_low_recommendation (LOWER_TARGET_ROAS_PERFORMANCE_BID_TOO_LOW)، بالإضافة إلى ApplyRecommendationOperation.raise_target_cpa_performance_bid_too_low وApplyRecommendationOperation.lower_target_roas_performance_bid_too_low، للمساعدة في رفع سقف التكلفة المحدّد لكل إجراء أو خفض عائد الإنفاق الإعلاني المستهدَف عندما تكون عروض الأسعار منخفضة جدًا بحيث لا يمكن للحملات على "شبكة البحث" المشاركة في المزادات: توفّر RaiseTargetCpaPerformanceBidTooLowRecommendation recommended_target_multiplier (عامل أكبر من 1.0) وcurrent_average_target_cpa_micros، ويمكنك تطبيقها باستخدام RaiseTargetCpaPerformanceBidTooLowParameters مع target_cpa_multiplier. توفّر LowerTargetRoasPerformanceBidTooLowRecommendation recommended_target_multiplier (عامل أقل من 1.0) وcurrent_average_target_roas، ويمكنك تطبيقها باستخدام LowerTargetRoasPerformanceBidTooLowParameters مع target_roas_multiplier.
التقارير
شرائح سمات برامج رحلات الفنادق	شرائح جديدة	تمت إضافة شرائح سمات خطة السفر وحجز الفنادق التالية إلى Segments (يمكن اختيارها باستخدام campaign وad_group وcustomer): استبدِل Segments.advance_booking_window بفترة الحجز المُسبَق لبرنامج الرحلة بالأيام. ‫Segments.length_of_booking: مدة الحجز لبرنامج الرحلة بالأيام. Segments.start_date استبدِل بتاريخ بدء الحجز بالتنسيق yyyy-MM-dd. Segments.start_day_of_week: يوم بدء الأسبوع (DayOfWeek) للحجز. ‫Segments.user_set_dates: تشير إلى ما إذا تم اختيار تواريخ محدّدة من قِبل المستخدم (HotelDateSelectionType).
مقاييس الإعلانات العمودية	المقاييس الجديدة	تمت إضافة المقاييس التالية لإعداد تقارير إعلانات الفنادق والسفر في Metrics (يمكن اختيارها باستخدام campaign وad_group وcustomer): ‫Metrics.vertical_ads_average_booking_value_micros: متوسط السعر اليومي المرجّح بالنقرات بالوحدات الصغيرة، بما في ذلك الضرائب والرسوم، على مدار إجمالي مدة الإقامة في حجوزات الفنادق Metrics.vertical_ads_potential_impressions: إجمالي عدد مرّات الظهور المؤهّلة والمحدودة بعدد مرّات الظهور المتاحة في سياق طلب البحث Metrics.vertical_ads_price_difference_percentage: الفرق بالنسبة المئوية بين السعر الذي يقدّمه المعلِن وأدنى سعر منافس للعقار نفسه.
شرائح الإعلانات العمودية	شرائح جديدة	تمت إضافة الأقسام التالية لإعداد تقارير إعلانات الفنادق والسفر في Segments (يمكن اختيارها باستخدام campaign وad_group وcustomer): ‫Segments.vertical_ads_price_tier: فئة سعر المعلِن (HotelPriceBucket) مقارنةً بالمنافسين في المزاد استبدِل Segments.vertical_ads_rate_rule_id برقم تعريف قاعدة السعر المرتبط بقاعدة السعر الخاصة بالمعلِن. ‫Segments.vertical_ads_rate_type: نوع السعر (HotelRateType) لحجز الفندق

الإصدار 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. تمت إضافة حقل campaign_new_customer_acquisition_settings إلى المورد CampaignGoalConfig للسماح بتجاوز الإعدادات على مستوى الحملة في ميزة "اكتساب عملاء جدد". تمت إضافة تعداد 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 غير قابلَين للتغيير في هذه الإصدارات. إذا حاولت إجراء طلب تغيير على أيّ من هذين الحقلَين، سيتم عرض أحد الأخطاء التالية: "الحقل الذي تمت محاولة تعديله غير قابل للتغيير" أو "لا يمكن ضبط الحقل". ستصبح هذه الحقول قابلة للتعديل بالكامل بدءًا من الإصدار 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	حقل جديد	في حال ضبط القيمة على "صحيح"، يتم تجاهل استبعادات العلامات التجارية في "إعلانات 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، وما إلى ذلك) وقيم الاحتمالية (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 غير قابلَين للتغيير في هذه الإصدارات. إذا حاولت إجراء طلب تغيير على أيّ من هذين الحقلَين، سيتم عرض أحد الأخطاء التالية: "الحقل الذي تمت محاولة تعديله غير قابل للتغيير" أو "لا يمكن ضبط الحقل". ستصبح هذه الحقول قابلة للتعديل بالكامل بدءًا من الإصدار 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، والتي توضّح ما إذا كان الإعلان مسموعًا وعدد مرّات الظهور التي يمكن فيها قياس إمكانية سماع الإعلان.

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

يتضمّن الإصدار 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 غير قابلَين للتغيير في هذه الإصدارات. إذا حاولت إجراء طلب تغيير على أيّ من هذين الحقلَين، سيتم عرض أحد الأخطاء التالية: "الحقل الذي تمت محاولة تعديله غير قابل للتغيير" أو "لا يمكن ضبط الحقل". ستصبح هذه الحقول قابلة للتعديل بالكامل بدءًا من الإصدار 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 (متوسط المدة لكل مرة ظهور).

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

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