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

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

رقم الإصدار الرئيسي v26

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

الإصدار 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.
أسباب الخطأ الخاصة بالفنادق في 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 يمثّل حزمة كلمات رئيسية في دراسة تحسُّن في "بحث Google". تمت إضافة شرائح جديدة قابلة للاختيار (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.

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

يتضمّن الإصدار 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 لضبط عمليات الإلغاء الخاصة بالحملة.
بنود عامة
حقول التعداد المتداخلة في رسائل الطلب والردّ في Incentive Service: 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.

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

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

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