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

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

ملخّص الإصدار والروابط السريعة

يمكنك استخدام الجدول التالي للانتقال مباشرةً إلى التغييرات التي قد تؤدي إلى عطل أو الميزات الجديدة أو جداول الاختلافات في ملفات proto في إصدار معيّن:

الإصدار	تاريخ الإصدار	تغييرات قد تؤدي إلى أعطال	الميزات والتحديثات	جدول الاختلافات في Proto
v26.1 (الأحدث)	2026-10-28	لا شيء (إصدار ثانوي)	ميزات الإصدار 26.1 وتحديثاته	الاختلافات بين الإصدار 25 والإصدار 26 من بروتوكول proto
v26	2026-10-14	التغييرات التي قد تؤدي إلى عطل في الإصدار 26	ميزات الإصدار 26 وتحديثاته	الاختلافات بين الإصدار 25 والإصدار 26 من بروتوكول proto
v25.2	2026-09-23	لا شيء (إصدار ثانوي)	ميزات الإصدار 25.2 وتحديثاته	v24 versus v25 proto diffs
v25.1	2026-08-19	لا شيء (إصدار ثانوي)	ميزات الإصدار 25.1 وتحديثاته	v24 versus v25 proto diffs
v25	2026-07-22	التغييرات التي قد تؤدي إلى عطل في الإصدار 25	ميزات الإصدار 25 وتحديثاته	v24 versus v25 proto diffs
v24.2	2026-06-24	لا شيء (إصدار ثانوي)	الميزات والتعديلات في الإصدار 24.2	الاختلافات بين الإصدار 23 والإصدار 24 من ملفات proto
v24.1	2026-05-13	لا شيء (إصدار ثانوي)	ميزات الإصدار 24.1 وتحديثاته	الاختلافات بين الإصدار 23 والإصدار 24 من proto
v24	2026-04-22	التغييرات التي قد تؤدي إلى عطل في الإصدار 24	ميزات الإصدار 24 وتحديثاته	الاختلافات بين الإصدار 23 والإصدار 24 من واجهة برمجة التطبيقات
v23.3	2026-06-24	لا شيء (إصدار ثانوي)	ميزات الإصدار 23.3 وتحديثاته	v22 versus v23 proto diffs
v23.2	2026-03-25	لا شيء (إصدار ثانوي)	ميزات الإصدار 23.2 وتحديثاته	v22 versus v23 proto diffs
v23.1	2026-02-25	لا شيء (إصدار ثانوي)	الميزات والتحديثات في الإصدار 23.1	v22 versus v23 proto diffs
v23	2026-01-28	التغييرات التي قد تؤدي إلى عطل في الإصدار 23	ميزات الإصدار 23 وتحديثاته	v22 versus v23 proto diffs

أرقام الإصدارات الرئيسية وأرقام الإصدارات الثانوية من الإصدار 26

يتضمّن الإصدار 26 من Google Ads API الميزات الجديدة والتعديلات والتغييرات التالية التي قد تؤدي إلى عطل.

الإصدار 26.1‏ (‎28/10/2026)

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

الميزات والتحديثات	النوع	الوصف
مواد العرض
تتبُّع تحصيل قيمة العروض الترويجية الخارجية	رسائل وحقول وتعدادات وأخطاء جديدة	تمت إضافة الحقل الثابت PromotionAsset.external_redeem_info من النوع ExternalRedeemInfo لتحديد تفاصيل تتبُّع عمليات الاستخدام الخارجية لعرض ترويجي: ‫ExternalRedeemInfo.partner_promotion_id: رسالة ExternalPartnerId غير قابلة للتغيير تحتوي على معرّف عدد صحيح (int_value) أو سلسلة (string_value) للعرض الترويجي في نظام الشريك. هذا الحقل مطلوب عندما يتم ضبط حقل code_source على GOOGLE_GENERATED. ‫ExternalRedeemInfo.code_type: مطلوبة وغير قابلة للتغيير. نوع الرمز الترويجي في وضع عدم الاتصال (OfflinePromotionCodeType: SINGLE_USE_PROMOTION_CODE أو MULTI_USE_PROMOTION_CODE). ‫ExternalRedeemInfo.code_source: مطلوبة وغير قابلة للتغيير. مصدر الرمز الترويجي خارج الإنترنت (OfflinePromotionCodeSource: CUSTOMER_UPLOADED أو GOOGLE_GENERATED). تمت أيضًا إضافة رمز الخطأ AssetError.PARTNER_PROMOTION_ID_TYPE_INCOMPATIBLE الذي تعرضه واجهة برمجة التطبيقات عندما يستخدم الحقل partner_promotion_id تنسيقًا لا تقبله عملية دمج العروض الترويجية في الحساب.
الحملات
تحديد أولوية القنوات بشكل متسلسل وحدود الإنفاق القصوى في ميزانيات الحملات	الميزات والموارد والخدمات والحقول والتعدادات الجديدة	أضفنا إمكانية تحديد أولوية القنوات في العرض الانحداري ووضع حد الإنفاق الأقصى في الميزانية لميزانيات الحملات، ما يتيح لك التحكّم في كيفية توزيع الميزانية على قنوات الشبكة (المواقع المملوكة وتحت إدارة Google، وشبكة شركاء البحث، و"شبكة Google الإعلانية"). لمزيد من المعلومات، يُرجى الاطّلاع على منشور المدوّنة حول ميزتَي تحديد أولوية القنوات وتوزيع الميزانية. تمت إضافة الحقل CampaignBudget.budget_network_settings من النوع BudgetNetworkSettings، والذي يحتوي على رسالة BudgetNetworkSetting واحدة كحدّ أقصى لكل نوع قناة إعلانية (advertising_channel_type) في الحقل BudgetNetworkSettings.settings. يحدّد كل إعداد قنوات الشبكة (NetworkChannelType: OWNED_AND_OPERATED وSEARCH_PARTNER وGOOGLE_DISPLAY) لمستويات الأولوية (ChannelPriorityTier: TIER1 وTIER2) في الحقل BudgetNetworkSetting.channel_priorities (من النوع ChannelPriorityConfig). يمكن أن يحدّد أحد الإعدادات أيضًا الحد الأقصى لحصة الميزانية التي تنفقها قنوات الشبكة من المستوى الثانوي في الحقل BudgetNetworkSetting.budget_caps (من النوع BudgetCapConfig). يحدّد الحقل BudgetCapConfig.cap_percent_millis الحد الأقصى بوحدات النسبة المئوية (1,000 = 1% و100,000 = 100% و0 = 0% إيقاف). في حال عدم ضبط هذه السياسة، يتم تطبيق الإعدادات التلقائية على مستوى العميل في المورد CustomerBudgetNetworkSetting. تمّت إضافة الحقل CampaignBudget.budget_network_eligibility للقراءة فقط من النوع BudgetNetworkEligibility، والذي يشير إلى ما إذا كانت الميزانية مؤهَّلة (eligible) لتحديد الأولويات في العرض بدون انقطاع وحدود الإنفاق الأقصى في الميزانية، وإذا لم تكن مؤهَّلة، يشير إلى أسباب عدم الأهلية (ineligible_reasons من النوع BudgetNetworkIneligibleReason). تمت إضافة المورد CustomerBudgetNetworkSetting، وهو عنصر فردي لكل عميل يحمل اسم المورد customers/{customer_id}/customerBudgetNetworkSettings. يحتوي حقل budget_network_settings من النوع BudgetNetworkSettings على الإعدادات التلقائية التي تنطبق على كل ميزانية حملة لم يتم ضبط حقل CampaignBudget.budget_network_settings فيها. تمت إضافة خدمة CustomerBudgetNetworkSettingService باستخدام طريقة CustomerBudgetNetworkSettingService.MutateCustomerBudgetNetworkSetting لإنشاء الإعداد أو تعديله. يمكنك أيضًا تغيير المورد من خلال طريقة GoogleAdsService.Mutate والاستعلام عنه من خلال الطريقتَين GoogleAdsService.Search وGoogleAdsService.SearchStream. تمت إضافة التعداد BudgetNetworkSettingError الذي تعرضه واجهة برمجة التطبيقات عندما تكون إعدادات شبكة الميزانية غير صالحة.
خطأ في تفعيل "حملة زيادة الطلب" المنقولة	تعداد وخطأ جديدان	تمت إضافة التعداد DemandGenCampaignError مع رمز الخطأ DemandGenCampaignError.CANNOT_ACTIVATE_MIGRATED_CAMPAIGN. تعرض واجهة برمجة التطبيقات هذا الخطأ إذا حاولت تفعيل "حملة زيادة طلب" تم نقلها قبل إزالة الحملة الأصلية، أو عندما تكون حملة أخرى تم نقلها للحملة الأصلية نفسها نشطة.
بنود عامة
تفاصيل الخدمة والفئة المؤهّلة لـ "الخدمات المحلّية"	خدمة ورسائل وحقول جديدة	تمت إضافة خدمة LocalServicesEligibilityService باستخدام طريقة LocalServicesEligibilityService.CheckLocalServicesEligibility للتحقّق من أهلية العميل للاستفادة من "الخدمات المحلّية" ورقم تعريف بطاقة بيانات "الملف التجاري على Google" ‏ (CheckLocalServicesEligibilityRequest). تعرض رسالة CheckLocalServicesEligibilityResponse ما يلي: ‫eligible: تشير إلى ما إذا كان العميل مؤهلاً لاستخدام "الخدمات المحلّية". eligible_goals (من النوع EligibleGoal): يربط كل نوع عميل محتمل مؤهَّل (EligibleGoal.lead_type) بفئات الخدمة المؤهَّلة (EligibleGoal.categories من النوع EligibleCategory)، بما في ذلك رقم تعريف كل فئة (category_id) واسم العرض (display_name) وأرقام تعريف أنواع المهام المتاحة (job_types) وأرقام تعريف عبارات الشرح للنشاط التجاري (callouts). ‫suggestion_reasons (من النوع SuggestionReason): يقدّم أسبابًا نصية قصيرة ومفصّلة (short_text وlong_text) توضّح مشاكل الأهلية (مثل مشاكل الترخيص).
إعدادات مقدّمي الخدمات الخارجيين لتحصيل قيمة العروض في "الخدمات المحلّية"	الحقل المعدَّل والرسائل الجديدة والحقول الجديدة	تم تعديل الحقل Customer.local_services_settings من OUTPUT_ONLY إلى "قابل للتغيير". تم أيضًا إضافة الحقل LocalServicesSettings.redemption_provider_info من النوع RedemptionProviderInfo لضبط مقدّم خدمة التحصيل الخارجي لحساب "الخدمات المحلّية". تحتوي هذه الرسالة على حقل RedemptionProviderInfo.external_merchant_id المطلوب من النوع ExternalPartnerMerchantId، والذي يحتوي على معرّف تاجر إما عدد صحيح (numeric_id) أو سلسلة أحرف تتراوح بين 1 و50 حرفًا (alphanumeric_id).
الاقتراحات
اقتراح "التحسين لزيادة عدد العملاء الجدد"	اقتراح جديد	تمت إضافة قيمة التعداد RecommendationType.OPTIMIZE_FOR_NEW_CUSTOMERS والحقول التالية لإتاحة تحسين الحملات لاكتساب عملاء جدد (باستخدام قيمة تصاعدية للإحالة الناجحة المعبَّر عنها بالوحدات العادية للعملة المحلية للحساب، وليس بالوحدات الصغيرة): ‫Recommendation.optimize_for_new_customers_recommendation (من النوع OptimizeForNewCustomersRecommendation): يعرض الحقل recommended_incremental_conversion_value. ApplyRecommendationOperation.optimize_for_new_customers (من النوع OptimizeForNewCustomersParameters): يقبل الحقلَين account_default_incremental_conversion_value وcampaign_override_incremental_conversion_value عند تطبيق الاقتراح.
التقارير
فئات معدّل تكرار إعداد تقارير مدى الوصول ومعلومات حالة المقياس	مقاييس ورسائل وتعدادات جديدة	تمت إضافة المقاييس التالية إلى رسالة Metrics، لإكمال مجموعة فئات معدّل تكرار الظهور البالغ عددها N+ (من 1+ إلى 10+) لإعداد تقارير مدى الوصول: Metrics.unique_users_six_plus Metrics.unique_users_seven_plus Metrics.unique_users_eight_plus Metrics.unique_users_nine_plus تمت أيضًا إضافة مقاييس ReachMetricInfo التالية إلى رسالة Metrics لتوفير معلومات إضافية عن الحالة (الحقل ReachMetricInfo.reach_metric_states من النوع ReachMetricState، مثلاً عند حجب قيمة لأسباب تتعلق بالخصوصية أو الجودة) لكل مقياس من مقاييس المستخدمين الفريدين: Metrics.unique_users_info Metrics.unique_users_two_plus_info Metrics.unique_users_three_plus_info Metrics.unique_users_four_plus_info Metrics.unique_users_five_plus_info Metrics.unique_users_six_plus_info Metrics.unique_users_seven_plus_info Metrics.unique_users_eight_plus_info Metrics.unique_users_nine_plus_info Metrics.unique_users_ten_plus_info
إتاحة استخدام "نسبة ظهور الإعلان في أعلى الصفحة على شبكة البحث" و"نسبة النقر على الإعلان على شبكة البحث" لبرنامج رحلة حجز الفندق وشرائح الإعلانات في قطاعات محددة	المقاييس والشرائح المعدَّلة	تمت إتاحة مقياسَي Metrics.search_top_impression_share وMetrics.search_click_share على نطاق أوسع لتتمكّن من اختيارهما مع شرائح برنامج رحلات حجز الفنادق والإعلانات في قطاعات معيّنة التالية: Segments.advance_booking_window Segments.length_of_booking Segments.start_date Segments.start_day_of_week Segments.user_set_dates Segments.vertical_ads_event_participant_display_names Segments.vertical_ads_hotel_class Segments.vertical_ads_listing Segments.vertical_ads_listing_brand Segments.vertical_ads_listing_city Segments.vertical_ads_listing_country Segments.vertical_ads_listing_region Segments.vertical_ads_listing_user_rating Segments.vertical_ads_listing_venue Segments.vertical_ads_partner_account Segments.vertical_ads_price_tier Segments.vertical_ads_rate_rule_id Segments.vertical_ads_rate_type Segments.vertical_ads_vertical
الاستهداف
استبعادات دخل الأسرة في "حملات الأداء الأفضل"	توسيع نطاق الدعم	تمت إتاحة استبعاد فئات دخل الأسرة في "حملات الأداء الأفضل". استبعِد مستويات دخل الأسرة من خلال إنشاء مورد CampaignCriterion سلبي مع ضبط الحقل income_range.

الإصدار 26‏ (‎14/10/2026)

تمت إضافة الميزات الجديدة والتعديلات والتغييرات التي قد تؤدي إلى عطل التالية في الإصدار 26 من Google Ads API، وهو إصدار رئيسي.

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

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

الحالة المبدئية	الحالة الجديدة	نوع التغيير	إرشادات التنفيذ
الحملات
الحقل الاختياري country_code في LocalServicesPmaxCampaignSettings	حقل مطلوب أثناء إنشاء "حملة الأداء الأفضل" في "الخدمات المحلّية" (LocalServicesPmaxCampaignSettings.country_code)	تغيير في السلوك	تأكَّد من تحديد country_code (بالإضافة إلى السمة listing_id المطلوبة حديثًا) عند إنشاء "حملات الأداء الأفضل" في "الخدمات المحلّية".
الإحالات الناجحة
حقل enhanced_conversions_for_leads_enabled في ConversionTrackingSetting (Customer.conversion_tracking_setting)	بلا	إزالة	استخدِم ConversionTrackingSetting.enablement_setting في Customer.conversion_tracking_setting بدلاً من ذلك لفحص إعدادات "الإحالات الناجحة المحسّنة" على مستوى الحساب.
الاستهداف
حقول المعايير الخاصة بالفنادق في AdGroupBidModifier: hotel_date_selection_type hotel_advance_booking_window hotel_length_of_stay (min_nights وmax_nights) hotel_check_in_day hotel_check_in_date_range	حقول المعايير غير المرتبطة بمجال معيّن في AdGroupBidModifier: user_set_dates من النوع UserSetDatesInfo advance_booking_window من النوع AdvanceBookingWindowInfo length_of_booking من النوع LengthOfBookingInfo (min_days وmax_days) start_day_of_week من النوع StartDayOfWeekInfo start_date_range من النوع StartDateRangeInfo	إعادة التسمية أو الإزالة	عدِّل المراجع لاستخدام حقول المعايير غير المرتبطة بمجال معيّن، والتي تظل متاحة فقط لـ "إعلانات الفنادق" في "حملات الفنادق" و"الحملات على شبكة البحث للسفر". تبقى أرقام تعريف المعايير وسلوك الاستهداف وتعديلات عروض الأسعار الحالية كما هي، ويتم نقل قيم min_nights وmax_nights إلى min_days وmax_days بدون تحويل. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تعديل عروض الأسعار باستخدام معدِّلات عروض الأسعار.
HotelDateSelectionType ونوع segments.user_set_dates	DateSelectionType	إعادة تسمية / تغيير النوع	استخدِم DateSelectionType بدلاً من HotelDateSelectionType لتعديلات عروض الأسعار على مستوى user_set_dates وsegments.user_set_dates.
أسباب الأخطاء المتعلّقة بالفنادق في CriterionError: HOTEL_LENGTH_OF_STAY_OVERLAPS_WITH_EXISTING_CRITERION HOTEL_ADVANCE_BOOKING_WINDOW_OVERLAPS_WITH_EXISTING_CRITERION HOTEL_CHECK_IN_DATE_RANGE_OVERLAPS_WITH_EXISTING_CRITERION HOTEL_CHECK_IN_DATE_RANGE_START_DATE_TOO_EARLY HOTEL_CHECK_IN_DATE_RANGE_END_DATE_TOO_LATE HOTEL_CHECK_IN_DATE_RANGE_REVERSED	أسباب الأخطاء غير المرتبطة بمجال معيّن في CriterionError: LENGTH_OF_BOOKING_OVERLAPS_WITH_EXISTING_CRITERION ADVANCE_BOOKING_WINDOW_OVERLAPS_WITH_EXISTING_CRITERION START_DATE_RANGE_OVERLAPS_WITH_EXISTING_CRITERION START_DATE_RANGE_START_DATE_TOO_EARLY START_DATE_RANGE_END_DATE_TOO_LATE START_DATE_RANGE_REVERSED	إعادة التسمية	عدِّل معالجة الأخطاء للتحقّق من أسباب الأخطاء الجديدة غير المرتبطة بمجال معيّن.

الميزات والتحديثات (غير المسبّبة لتعطُّل التطبيق)

الميزات والتحديثات	النوع	الوصف
مواد العرض
مقدّمو خدمات الرسائل التجارية عبر LINE والرسائل القصيرة	الحقول الجديدة وقيم التعداد	تمت إضافة LINE وSMS كمقدِّمَي رسائل في BusinessMessageAsset، بما في ذلك الحقلَين الجديدَين BusinessMessageAsset.line_info وBusinessMessageAsset.sms_info بالإضافة إلى BusinessMessageProvider.LINE وBusinessMessageProvider.SMS.
AssetGroupError.UNSUPPORTED_LOCAL_SERVICES_CATEGORY	قيمة تعداد جديدة / خطأ	تمت إضافة AssetGroupError للإشارة إلى الحالات التي لا تتوافق فيها فئة محدّدة في GoogleLocalServicesInfo (AssetGroup.google_local_services_info) مع "حملات الأداء الأفضل" في "الخدمات المحلّية".
الحملات
إنشاء "حملة أداء أفضل" في "الخدمات المحلّية"	ميزات وحقول وأخطاء جديدة	تم تعديل PmaxCampaignSettings.local_services_enabled من OUTPUT_ONLY إلى IMMUTABLE، ما يسمح لعملاء واجهة برمجة التطبيقات الخارجيين بتحديد local_services_enabled = true عند إنشاء "حملات أداء أفضل" جديدة في "الخدمات المحلّية". تمت أيضًا إضافة LocalServicesPmaxCampaignSettings.listing_id لعرض معرّف بيانات "الملف التجاري على Google" المرتبط بـ "حملة الأداء الأفضل" في "الخدمات المحلّية" (تم وضع علامة "مطلوب" عليه أثناء إنشاء "حملة الأداء الأفضل" في "الخدمات المحلّية")، وتمت إضافة رمز الخطأ CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID.
أخطاء التحقّق من صحة "حملات الخدمات المحلّية"	قيم تعداد وأخطاء جديدة	تمت إضافة أخطاء جديدة في التحقّق من صحة البيانات في "حملات الخدمات المحلّية": CampaignError: LOCAL_SERVICES_MULTIPLE_PERFORMANCE_MAX_CAMPAIGNS_NOT_ALLOWED LOCAL_SERVICES_AGREEMENT_REQUIRED AssetSetLinkError: LOCATION_ASSET_DOES_NOT_MATCH_CAMPAIGN_LISTING_ID CampaignConversionGoalError وCampaignGoalConfigError: CANNOT_UNLINK_LOCAL_SERVICES_GOAL_FROM_LOCAL_SERVICES_CAMPAIGN GOAL_NOT_ALLOWED_FOR_LOCAL_SERVICES_CAMPAIGN LOCAL_SERVICES_GOAL_NOT_ALLOWED_FOR_NON_LOCAL_SERVICES_CAMPAIGN ConversionGoalCampaignConfigError: CANNOT_DISABLE_CAMPAIGN_OVERRIDE_GOALS_FOR_LOCAL_SERVICES_CAMPAIGN
التحقّق من رابط حساب Hotel Center	قيمة تعداد جديدة / خطأ	تمّت إضافة رمز الخطأ CampaignError.HOTEL_PROPERTY_ASSET_SET_HOTEL_CENTER_LINK_REQUIRED إلى CampaignError للإشارة إلى أنّ ربط مجموعة مواد عرض خاصة بفندق (Campaign.hotel_property_asset_set) بـ "حملة الأداء الأفضل" المستندة إلى أهداف السفر يتطلّب رابطًا نشطًا لحساب على Hotel Center.
الحد الأدنى للميزانية اليومية في "حملات زيادة الطلب"	حقل جديد	تمّت إضافة الحقل demand_gen_info.minimum_budget_per_day_micros إلى CurrencyConstant، والذي يحدّد الحدّ الأدنى للميزانية المطلوبة يوميًا لـ "حملات زيادة الطلب" بهذه العملة. يتم تعديل قيمة هذا الحقل عند تغيير الحدّ الأدنى للميزانية الذي تفرضه واجهة برمجة التطبيقات.
إعدادات قياس التحسُّن للحملات	حقل جديد	تمّت إضافة Campaign.lift_measurement_config لعرض اسم المورد الخاص بإعدادات قياس مدى التحسّن المرتبطة بالحملة.
التحقّق من صحة حملة AI Max تجريبية	قيمة تعداد جديدة / خطأ	تمت إضافة رمز الخطأ ExperimentArmError.ADOPT_AI_MAX_CAMPAIGN_ALREADY_ENABLED إلى ExperimentArmError عند محاولة إنشاء تجربة ADOPT_AI_MAX لحملة تم تفعيل ميزات AI Max فيها (أو تم تفعيلها ضمن الطلب نفسه قبل إنشاء مجموعة تجربة).
نوع بيانات قائمة حملة تسوّق	توسيع نطاق الدعم	توسيع نطاق إتاحة Campaign.listing_type ليشمل "حملات تسوّق"
تعديلات على البيان الذاتي للإعلانات السياسية عن الاتحاد الأوروبي	السلوك المعدَّل والحقول الجديدة	أصبحت سمة Campaign.contains_eu_political_advertising اختيارية الآن لبعض الحملات التي لا تستهدف الاتحاد الأوروبي بشكل إيجابي. باستثناء ما هو مذكور في "حملات DEMAND_GEN" التي تتضمّن استهدافًا تمّت ترقيته، يكون الحقل اختياريًا إذا كانت الحملة تستوفي جميع الشروط التالية بعد تنفيذ الطلب: لا تتضمّن أي معيار إيجابي للموقع الجغرافي في الحملة داخل الاتحاد الأوروبي لا تحتوي على أي معيار إيجابي لحملة مجموعة المواقع الجغرافية أو القرب تحتوي على معيار واحد على الأقل للمواقع الجغرافية الإيجابية في الحملة خارج الاتحاد الأوروبي بالنسبة إلى حملات "DEMAND_GEN" التي تستخدم upgraded_targeting، يكون الحقل اختياريًا إذا كانت كل مجموعة إعلانية نشطة ضمن الحملة تستوفي جميع الشروط التالية بعد تنفيذ الطلب: لا تحتوي على معيار إيجابي للمجموعة الإعلانية حسب الموقع الجغرافي داخل الاتحاد الأوروبي لا يحتوي على أي معيار إيجابي للمجموعة الإعلانية لمجموعات المواقع الجغرافية أو القرب تحتوي على معيار واحد على الأقل للمجموعة الإعلانية للموقع الجغرافي الإيجابي خارج الاتحاد الأوروبي هذا الحقل اختياري أيضًا للحملات التي لا تتضمّن مجموعات إعلانية نشطة. إذا أدّى طلب إلى إنشاء مجموعة إعلانية لا تستوفي هذه الشروط، يتم عرض الخطأ AdGroupError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION. تنطبق هذه التغييرات على كلّ من الحملات الجديدة والحالية. في بعض الحالات، لا يمكن إنشاء حملة جديدة إلا إذا تمت إضافة معايير في الطلب نفسه، لذا استخدِم GoogleAdsService.Mutate لتجميع عمليات التغيير. تم تعديل Campaign.missing_eu_political_advertising_declaration لمطابقة التغييرات في Campaign.contains_eu_political_advertising. تمت إضافة السمة GeoTargetConstant.require_eu_political_advertising_declaration للإشارة إلى ما إذا كان الموقع الجغرافي يقع داخل الاتحاد الأوروبي أو خارجه. تمت إضافة CampaignCriterion.require_eu_political_advertising_declaration وAdGroupCriterion.require_eu_political_advertising_declaration. يجب إدخال Campaign.contains_eu_political_advertising إذا كان هذا الحقل true لأي معيار على مستوى الحملة ضمن الحملة (أو لأي معيار نشط على مستوى المجموعة الإعلانية في حملات DEMAND_GEN التي تمّت ترقية استهدافها). تعرض الحقول القيمة true إذا كان حقل negative للمعيار هو false وكان المعيار موقعًا جغرافيًا داخل الاتحاد الأوروبي أو موقعًا جغرافيًا مجاورًا (بغض النظر عمّا إذا كان يتداخل مع أراضي الاتحاد الأوروبي) أو مجموعة مواقع جغرافية (بغض النظر عمّا إذا كانت تتداخل مع أراضي الاتحاد الأوروبي).
الإحالات الناجحة
إعدادات موحّدة لميزة "الإحالات الناجحة المحسّنة"	الحقول الجديدة والتعداد	تمّت إضافة ConversionTrackingSetting.enablement_setting وConversionTrackingSetting.effective_enablement_setting (في Customer.conversion_tracking_setting) لعرض الإعدادات الموحّدة لميزة "الإحالات الناجحة المحسّنة" للحساب، والتي يتم تمثيلها باستخدام التعداد الجديد EnhancedConversionsConfig.
ConversionActionCategory.MESSAGE_LEAD	قيمة تعداد جديدة	تمت إضافتها إلى ConversionActionCategory لدعم التفاعلات عبر الرسائل أو المحادثات التي تشير إلى الاهتمام بعرض أحد المعلنين.
ConversionAttributionEventType.CLICK	قيمة تعداد جديدة	تمت إضافتها إلى ConversionAttributionEventType لتمثيل الإحالات الناجحة المنسوبة إلى نقرة على إعلان، والتي تم تضمينها سابقًا في قيمة التعداد UNKNOWN.
بنود عامة
تعديلات على العملاء المحتملين في "الخدمات المحلّية"	حقل جديد وقيمة تعداد جديدة	تمت إضافة الحقل LocalServicesLead.campaign إلى المورد LocalServicesLead لربط عميل محتمل بحملته المرتبطة. تمت إضافة COUPON إلى LocalServicesLeadType لإتاحة أنواع العملاء المحتملين الذين يستخدمون القسائم في "الخدمات المحلّية".
الاقتراحات
اقتراح رفع الميزانية في "شبكة بحث Google"	اقتراح جديد	تمت إضافة RecommendationType.RAISE_BUDGET_PERFORMANCE_TOO_LOW وRecommendation.raise_budget_performance_too_low_recommendation وApplyRecommendationOperation.raise_budget_performance_too_low لإتاحة رفع الميزانيات عندما تكون الميزانيات اليومية منخفضة جدًا في "الحملات على شبكة البحث".
التقارير
قياسات "زيادة البحث"	ميزات وموارد وشرائح ومقاييس جديدة	تمت إضافة إمكانية قياس "زيادة البحث": تمت إضافة مورد جديد بإذن بالقراءة فقط SearchLiftKeywordBundle يمثّل حزمة كلمات رئيسية في دراسة زيادة البحث. تمت إضافة شرائح جديدة قابلة للاختيار (segments.search_lift_keyword_bundle وsegments.search_property) و15 مقياسًا جديدًا لـ مقياس "زيادة البحث" (مثل relative_search_lift وnormalized_incremental_searches وsearch_lift_cost_micros وsearch_lift_impressions) لإتاحة تحليل مقياس "زيادة البحث" باستخدام LiftMeasurementConfig (مرتبطة بالحملات التي تستخدم Campaign.lift_measurement_config). تمت إضافة التعدادات SearchLiftKeywordBundleStatus وSearchLiftMatchingInfoSource وSearchLiftSearchProperty.
عرض مواد عرض ميزة "توسيع عنوان URL النهائي" في "حملات Shopping"	توسيع نطاق الدعم	تم توسيع final_url_expansion_asset_view لإتاحة "حملات تسوّق" (مع إمكانية اختيار ad_group كمورد منسوب إلى جانب final_url_expansion_asset_view.ad_group).
الفيديوهات
الإفصاح عن المحتوى من إنشاء الذكاء الاصطناعي التوليدي على YouTube	الحقول الجديدة والتعداد	تمت إضافة إمكانية الإفصاح عن المحتوى من إنشاء الذكاء الاصطناعي التوليدي في الفيديوهات التي يتم تحميلها على YouTube. تمت إضافة الحقل الجديد YouTubeVideoUpload.video_content_metadata من النوع VideoContentMetadata إلى YouTubeVideoUpload، وهو يحتوي على إعدادات الإفصاح ضمن VideoContentMetadata.generative_content_disclosure من النوع YouTubeVideoUploadGenerativeContentDisclosure.

أرقام الإصدارات الرئيسية والثانوية من الإصدار 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. لا تتضمّن الإصدارات الثانوية، مثل v25.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	تغيير هيكلي	يُرجى تعديل الإشارات إلى هذه الحقول لأنّها أصبحت الآن جزءًا من حقول oneof.
الموارد القديمة 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 ليعكس المخطّط المعدَّل للأهداف الموحّدة: تمت إضافة الحقل new_customer_acquisition_goal_settings إلى المورد Goal لإتاحة إعدادات "اكتساب عملاء جدد". تمت إضافة الحقل 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.

الإصدارات الرئيسية وأرقام الإصدارات الثانوية من v24

يتضمّن الإصدار 24 من Google Ads API الميزات الجديدة والتعديلات والتغييرات التالية التي قد تؤدي إلى عطل.

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

تمت إضافة الميزات والتعديلات الجديدة التالية في الإصدار 24.2 من Google Ads API. لا تتضمّن الإصدارات الثانوية، مثل v24.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: للتجارب التي تختبر أداء حملات تسوّق مقارنةً بـ "حملات الأداء الأفضل".
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. لا تتوفّر هذه الميزة إلا للحسابات المُدرَجة في القائمة المسموح بها.

الإصدارات الرئيسية وأرقام الإصدارات الثانوية من v23

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

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

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