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

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

رقم الإصدار الرئيسي 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" المرتبطة بـ "حملة الأداء الأفضل" في "إعلانات الخدمات المحلية" (يتمّ وضع علامة REQUIRED عليها أثناء إنشاء "حملة الأداء الأفضل" في "إعلانات الخدمات المحلية")، كما تمّت إضافة رمز الخطأ 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 لإتاحة أنواع العملاء المحتملين الذين يستخدمون القسائم في "الخدمات المحلّية".
الاقتراحات
اقتراح زيادة الميزانية على "شبكة البحث"	اقتراح جديد	تمت إضافة 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 مخصّص يشير إلى أنّه لم يتم العثور على أي مقاييس لمجموعة الإدخالات المحدّدة لتحسين سهولة الاستخدام.
الأسماء المعرّفة لقنوات صنّاع المحتوى في "إحصاءات صنّاع المحتوى"	ميزة جديدة	تم تعديل 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.

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

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

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

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

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

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

تمت إضافة الميزات والتحديثات الجديدة التالية في الإصدار 24.1 من Google Ads API. لا تتضمّن الإصدارات الثانوية، مثل 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. لا تتوفّر هذه الميزة إلا للحسابات المُدرَجة في القائمة المسموح بها.

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

يتضمّن الإصدار 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، والتي تتيح معرفة ما إذا كان الإعلان مسموعًا وعدد مرات الظهور التي يمكن قياس قابلية الاستماع فيها.

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

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