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

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

الإصدارات الرئيسية والثانوية من الإصدار 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_input (الإقرارات المقدَّمة مباشرةً من المعلِن) وsystem_input (شهادات الصحة التي يتم رصدها تلقائيًا أو التي يقدّمها النظام). تمت إعادة توفير هذه الميزة في الإصدارَين 23 و22. لمساعدتك في التخطيط لعملية الدمج القادمة للإصدار 25، سيتم طرح واجهة لتعديل حقول شهادة المعلِن في وقت مبكر للإصدار 22 والإصدارات الأحدث. تظهر الواجهة في هذه الإصدارات، ولكن سيظل synthetic_content_info.advertiser_attestation.status و synthetic_content_info.advertiser_attestation.source غير قابلَين للتغيير في هذه الإصدارات. إذا حاولت إجراء طلب تغيير على أيّ من هذين الحقلَين، سيتم عرض أحد الأخطاء التالية: "The field attempted to be mutated is immutable" أو "Field cannot be set". ستصبح هذه الحقول قابلة للتعديل بالكامل بدءًا من الإصدار 25. ننصحك باستخدام الواجهة الآن لإنشاء واختبار المنطق الداخلي حتى يكون نظامك جاهزًا للاستفادة من إمكانات الكتابة الكاملة عند إطلاق الإصدار 25.
الموافقة المتعددة الجهات	الميزات الجديدة	إصدار تجريبي: هذه الميزة قيد التجربة حاليًا، وقد تتغير في الإصدارات المستقبلية. تمت إضافة إمكانية إجراء مراجعات تتطلّب موافقة جهات متعددة: تمت إضافة المورد MultiPartyAuthReview وMultiPartyAuthReviewService المقابل. تمت إضافة تعداد MultiPartyAuthReviewStatus لتتبُّع حالة المراجعة. تمت إضافة CustomerUserAccess.pending_multi_party_auth_review للربط بمراجعة في انتظار المراجعة. تمت إضافة MutateCustomerUserAccessResult.multi_party_auth_review وMutateCustomerUserAccessInvitationResult.multi_party_auth_review لعرض اسم مورد المراجعة المرتبط. تمت إضافة MultiPartyAuthReviewError لأخطاء التحقّق. تمت إعادة نقل هذه الميزة إلى الإصدارات v23.3 وv22.2 وv21.2.
IncentiveService.FetchIncentive	تغيير السلوك	عند تقديم عنوان بريد إلكتروني غير صالح في الطلب، يعود الآن إلى عرض عروض الحوافز التلقائية بدلاً من عرض الخطأ AuthenticationError.INVALID_EMAIL_ADDRESS.
التخطيط
GenerateCreatorInsightsRequest.search_topics	حقل جديد	تمت الإضافة إلى خدمة ContentCreatorInsightsService.GenerateCreatorInsights. يبحث هذا الخيار عن صنّاع محتوى يتحدثون عن موضوع في البلد المحدّد في country_locations (يمكن البحث عن بلد واحد فقط).
CREATOR_TOPIC_INSIGHTS	قيمة تعداد جديدة	تمت إضافته إلى InsightsKnowledgeGraphEntityCapabilities للإشارة إلى الكيانات التي تتيح البحث عن صنّاع المحتوى الذين يتحدثون عن موضوع معيّن. يجب استخدام هذه الكيانات في الحقل search_topics. تم استردادها باستخدام AudienceInsightsService.ListAudienceInsightsAttributes.
KnowledgeGraphEntitySearchOptions	النوع الجديد / الخيارات الجديدة	يتضمّن خيارات بحث إضافية عن المواضيع في ListAudienceInsightsAttributes، بما في ذلك خيارات لاسترداد جميع المواضيع المتوافقة كسمات لصنّاع المحتوى، والفلترة حسب الإمكانات.
GenerateCreatorInsightsRequest.supplemental_data GenerateTrendingInsightsRequest.supplemental_data	حقول جديدة	مدخلات اختيارية لطُرق ContentCreatorInsightsService يؤدي توفير هذا الحقل إلى ملء المواقع الجغرافية أو سمات صانع المحتوى الإضافية في الردّ.
local_creator_insights related_local_creators	حقول جديدة	تتمّ تعبئة هذه السمة عندما يحتوي supplemental_data على تعداد LOCAL_CREATOR_DATA. تعرض هذه الميزة صنّاع المحتوى المحليين الذين شاهدوا المحتوى في البلد المحدّد أو يقيمون فيه ووافقوا على مشاركة بيانات الموقع الجغرافي.
GenerateTrendingInsightsRequest.sub_country_locations	حقل جديد	تمت إضافة ContentCreatorInsightsService.GenerateTrendingInsights، ما يتيح البحث عن إحصاءات المؤشرات الرائجة باستخدام الموقع الجغرافي للبلد والمواقع الجغرافية الفرعية للبلد.
التقارير
PerformanceMaxPlacementView	إضافة شرائح الجمهور	تمّت إتاحة تقسيمها من خلال ad_network_type.
تسوّق
Campaign.ShoppingSetting.ignore_brand_exclusion_in_shopping_ads	حقل جديد	في حال اختيار "true"، يتم تجاهل استبعادات العلامات التجارية في "إعلانات Shopping". تتوفّر هذه الميزة في "حملات Shopping" فقط.
الاستهداف
CriterionErrorEnum.CANNOT_TARGET_LANGUAGE	قيمة التعداد الجديدة / الخطأ	يتم عرض هذا الخطأ عند محاولة استهداف لغة غير مسموح بها.
الفيديوهات
DataLink.youtube_link_metadata	حقل جديد	يحتوي على brand_channel_id لتحديد معرّف قناة العلامة التجارية المرتبطة على YouTube.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

الميزات والتحديثات	النوع	الوصف
بنود عامة
موافقات جهات متعددة	الميزات الجديدة	إصدار تجريبي: هذه الميزة قيد التجربة حاليًا، وقد تتغير في الإصدارات المستقبلية. تمت إضافة إمكانية مراجعة الموافقات من جهات متعددة: تمت إضافة المورد MultiPartyAuthReview وMultiPartyAuthReviewService المقابل. تمت إضافة تعداد MultiPartyAuthReviewStatus لتتبُّع حالة المراجعة. تمت إضافة CustomerUserAccess.pending_multi_party_auth_review للربط بمراجعة في انتظار المراجعة. تمت إضافة MutateCustomerUserAccessResult.multi_party_auth_review وMutateCustomerUserAccessInvitationResult.multi_party_auth_review لعرض اسم مورد المراجعة المرتبط. تمت إضافة MultiPartyAuthReviewError لأخطاء التحقّق.

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

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

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

الإصدار 21 (‎06/08/2025)

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

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

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

الحالة المبدئية	الحالة الجديدة	نوع التغيير	إرشادات التنفيذ
الحملات
المرتجعات CriterionError.INVALID_LISTING_GROUP_HIERARCHY	المرتجعات CriterionError.LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION	تغيير رمز الخطأ	بالنسبة إلى الطلبات التي تم تفعيل ميزة "التعطُّل الجزئي" فيها، تعامَل مع رمز الخطأ الجديد بدلاً من رمز الخطأ الأصلي في التسلسل الهرمي.
الإحالات الناجحة
الوصول إلى وضع "debug_enabled" في ConversionUploadService	بدون	إزالة	تتم إزالة الحقل debug_enabled. عدِّل الرمز الذي يشير إلى هذه المَعلمة لكي لا يتم ضبطها أو طلب البحث عنها.
التغييرات في الإعلانات السياسية عن الاتحاد الأوروبي
بيانات اختيارية تقدّمها بنفسك عن الحملات للإعلانات السياسية في الاتحاد الأوروبي	حقل contains_eu_political_advertising مطلوب للحملات الجديدة	قاعدة التحقّق / التغيير في السلوك	سيتعذّر تنفيذ طلبات البيانات المُرسَلة إلى واجهة برمجة التطبيقات لإنشاء حملات جديدة مع ظهور الخطأ FieldError.REQUIRED إذا لم يتم ضبط هذا الحقل. اعتبارًا من 22 سبتمبر 2025، لن يتم عرض الحملات المصنّفة على أنّها CONTAINS_EU_POLITICAL_ADVERTISING في الاتحاد الأوروبي.
المعايير القابلة للتعديل بدون إقرار ذاتي	تعذُّر تعديل CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION	قاعدة التحقّق / التغيير في السلوك	اضبط حالة الإقرار الذاتي قبل محاولة إنشاء أو تعديل معايير استهداف القرب أو الموقع الجغرافي أو مجموعة المواقع الجغرافية على مستوى الحملة أو المجموعة الإعلانية للحملات الحالية.
التجارب التي لا تتضمّن متطلبات الإقرار الذاتي	تعذُّر تعديل ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION	قاعدة التحقّق / التغيير في السلوك	تأكَّد من إكمال الإقرارات الذاتية في حملات التجربة.
حملات الأداء الأفضل
تكون القيمة التلقائية لـ brand_guidelines_enabled هي false	القيمة التلقائية هي true	تغيّر السلوك	بالنسبة إلى "حملات الأداء الأفضل" الجديدة، يتم تفعيل إرشادات الهوية البصرية للعلامة التجارية تلقائيًا. اضبط الحقل على false بشكل صريح إذا كان يجب إيقافها.
التخطيط
نوع وسيطة الإدخال الأصلية لـ AudienceInsightsService.GenerateTargetingSuggestionMetrics	إدخال من النوع InsightsAudience	تغيير النوع	عدِّل عمليات التنفيذ لتمرير نوع الإدخال الجديد الذي يتيح استخدام مجموعة من الاهتمامات AND-of-ORs، ما يسمح بمقاييس الوصول المحتمل لتعريفات شرائح الجمهور المخصّصة.

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

الميزات والتحديثات	النوع	الوصف
‫AI Max في الحملات على شبكة بحث Google
‫ai_max_setting.enable_ai_max في Campaign	حقل جديد	تتيح ميزة AI Max توسيع نطاق مطابقة عبارات البحث (مع مراعاة التشغيل الآلي السابق لمواد العرض النصية وقوائم العلامات التجارية إلى أن يتم إيقافها). يشير الحقل Campaign.ai_max_setting.bundling_required إلى ما إذا كان يجب تفعيل AI Max لتطبيق هذه الإعدادات أو تعديلها، ويمكن أن يؤدي AdGroup.ai_max_ad_group_setting.disable_search_term_matching إلى إيقاف المطابقة على مستوى المجموعة الإعلانية. اطّلِع على تحقيق أداء أفضل باستخدام "AI Max في الحملات على شبكة بحث Google".
CampaignError.AI_MAX_MUST_BE_ENABLED	قيمة التعداد الجديدة / الخطأ	يحدث هذا الخطأ عند تفعيل التشغيل الآلي لمواد العرض النصية التي تستخدم ميزة "توسيع عنوان URL" في "الحملات على شبكة البحث" بدون تفعيل AI Max.
الاستهداف على مستوى المجموعة الإعلانية	ميزة جديدة	تمّت إضافة إمكانية استخدام قوائم العلامات التجارية والمواقع الجغرافية وصفحات الويب (قواعد عناوين URL) في "AI Max في الحملات على شبكة بحث Google" على مستوى المجموعة الإعلانية.
ai_max_search_term_ad_combination_view	مرجع جديد لإعداد التقارير	تعرض التقارير الأداء استنادًا إلى مجموعات من عبارات البحث والعناوين والصفحات المقصودة.
شريحة search_term_match_type	قيمة تعداد جديدة	تمت إضافة AI_MAX كخيار لنوع مطابقة عبارة البحث.
مواد العرض
PromotionAsset	حقول جديدة	تمت إضافة الخيارات terms_and_conditions_text وterms_and_conditions_uri وoneof promotion_trigger (promotion_barcode_info وpromotion_qr_code_info). يمكنك الاطّلاع على لمحة عن مواد العرض الخاصة بالعروض الترويجية.
AssetAutomationType.FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION	قيمة تعداد جديدة	تمّت إضافة AssetAutomationType للتحكّم في إنشاء النصوص والصفحات المقصودة آليًا من عناوين URL النهائية في "الحملات على شبكة البحث".
AutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAsset	خدمة أو طريقة جديدة	تتيح هذه الميزة إزالة مواد عرض "توسيع عنوان URL النهائي" المنشأة تلقائيًا من الحملات.
ServedAssetFieldType.DESCRIPTION_PREFIX	قيمة تعداد جديدة	تمت إضافة هذه السمة لتصحيح مشكلة في إعداد التقارير حيث تم عرض النوع على أنّه UNKNOWN في ad_group_ad_asset_combination_view.
الحملات
CampaignPrimaryStatusReason.MISSING_LOCATION_TARGETING	قيمة تعداد جديدة	يتم عرض هذا الخطأ عندما لا تتضمّن الحملات المحظورة جغرافيًا استهدافًا حسب الموقع الجغرافي (الذي يعرض الآن الخطأ LOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGN إذا تم الاستهداف خارج المنطقة المسموح بها).
دمج إحصاءات التطبيقات من تطبيقات خارجية	حقول جديدة	تمت إضافة دعم VideoCustomer.third_party_integration_partners وCampaign.third_party_integration_partners. اطّلِع على مقالة تتبُّع الإحالات الناجحة للتطبيقات باستخدام إحصاءات التطبيقات الخارجية.
Campaign.advertising_partner_ids	توافق الحقل الجديد	يمكن الآن ضبط الحقل للحملات الحالية (يظلّ غير قابل للتغيير بعد ضبطه).
مواضع الإعلانات السلبية على مستوى الحساب الإداري	ميزة جديدة	تسمح هذه السمة باستبعاد قوائم مواضع الإعلان في جميع حسابات المعلِنين الفردية باستخدام CustomerNegativeCriterion.
إعدادات التفاوت في استراتيجيات "عائد الإنفاق الإعلاني المستهدَف"	حقول جديدة	تمّت إضافة دعم TargetRoas.target_roas_tolerance_percent_millis (لاستراتيجيات المحفظة في "حملات شبكة البحث") في MaximizeConversionValue وTargetRoas.
LocationInterestView	مرجع جديد لإعداد التقارير	تلخّص هذه السمة أداء معايير المواقع الجغرافية التي تهمّ المجموعة الإعلانية.
الإحالات الناجحة
شريحة conversion_attribution_event_type	قيمة تعداد جديدة	تمت إضافة ENGAGED_VIEW إلى خيارات نوع تحديد مصدر الإحالة الناجحة.
الحملات لزيادة الطلب
CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM	قيمة التعداد الجديدة / الخطأ	تمت إضافته استعدادًا لفرض حدّ أدنى للميزانيات اليومية في "حملات زيادة الطلب". يتم عرض التفاصيل باستخدام budgetDailyMinimumErrorDetails.
حملات الأداء الأفضل
campaign_search_term_view	مرجع جديد لإعداد التقارير	تجمع مقاييس عبارات البحث على مستوى الحملة، ما يتيح تحليل عبارات البحث وإعداد التقارير لها في "حملات الأداء الأفضل".
التخطيط
ReachPlanService.ListPlannableUserInterests	طريقة جديدة	تتيح هذه السمة اكتشاف الاهتمامات المشتركة القابلة للتخطيط والاهتمامات في السوق لـ generateReachForecast.
AdditionalApplicationInfo	حقل جديد	تمت إضافته كإدخال اختياري في ReachPlanService.ListPlannableUserLists.
قائمة سمات AudienceInsights	ميزة جديدة	يجلب AudienceInsightsService.ListAudienceInsightsAttributes الآن قوائم المستخدمين التابعة للطرف الأول المتاحة.
‫AudienceCompositionInsights استهداف قوائم إدارة علاقات العملاء	ميزة جديدة	تعرض الدالة AudienceInsightsService.GenerateAudienceCompositionInsights الآن تفاصيل مؤشر قائمة المستخدمين للسمات AudienceInsightsDimension: AGE_RANGE وGENDER وAFFINITY_USER_INTEREST وIN_MARKET_USER_INTEREST.
TrendInsightMetrics نسبة الجمهور	حقل جديد	تمثّل هذه السمة حصة شريحة من الجمهور في مؤشر معيّن.
فئات KnowledgeGraphAttributeMetadata	حقول جديدة	تتم فلترة سمات "الرسم البياني المعرفي" حسب الفئات المطابقة.
التقارير
مقاييس مشاهدات مواد العرض	الميزات / المقاييس الجديدة	تمت إضافة مقاييس جديدة متعددة إلى AssetGroupAsset وChannelAggregateAssetView وCampaignAggregateAssetView. تعرض "حملات الأداء الأفضل" الآن أيضًا القيم الحقيقية لـ impressions.
إضافات أدوات الاختيار	ميزة جديدة	تمت إتاحة إمكانية البحث عن AssetSet وCampaignAssetSet معًا داخل ChangeStatus.
search_term_targeting_status	شريحة جديدة	شريحة قابلة للاختيار في طريقة عرض عبارات البحث في الحملة
final_url_expansion_asset_view	مرجع جديد لإعداد التقارير	تعرض هذه التقارير تفاصيل أداء مواد عرض توسيع عنوان URL النهائي.
تعديلات قيم AssetGroup	حقول جديدة	تمّت إضافة دعم لمقياسَي value_adjustment وall_value_adjustment في تقرير AssetGroup.
landing_page_source	شريحة جديدة	توفّر هذه السمة شريحة مصدر للصفحة المقصودة في landing_page_view.
search_term_match_source	شريحة جديدة	شريحة قابلة للاختيار في طرق عرض عبارات البحث والحملات.
match_type	شريحة جديدة	مفتاح المقطع القابل للتحديد في عرض الكلمات الرئيسية
إعداد تقارير عن مجموعات طلبات البحث الفريدة حسب النية	حقول جديدة	تمت إضافة clicks_unique_query_clusters وconversions_unique_query_clusters وimpressions_unique_query_clusters للإبلاغ عن مجموعات فريدة من نوايا البحث.
ClickType.VEHICLE_ASSETS	قيمة تعداد جديدة	تتبُّع النقرات وإعداد تقارير عنها تكون مرتبطة تحديدًا بأشكال إعلانات المركبات في التقرير click_view
استكشاف آفاق جديدة للمزايدة
إعدادات التفاوت في استراتيجيات البحث	الحقول / الإعدادات الجديدة	تسمح هذه السمة بتفعيل ميزة "استكشاف عروض الأسعار الذكية" في "الحملات على شبكة البحث" من خلال ضبط target_roas_tolerance_percent_millis على قيمة تتراوح بين 10,000 (‏10%) و30,000 (‏30%) شاملةً (تتطلّب استراتيجية "تحقيق الحد الأقصى من الإحالات الناجحة" ضبط target_roas). يمكنك الاطّلاع على مشاركة المدوّنة حول استكشاف عروض الأسعار الذكية ومقالة مركز المساعدة.
التوافق مع تقارير التنوّع	ميزة جديدة	تتوفّر الآن تقارير التنوّع المجمّعة للمقاييس التالية لمجموعات نوايا طلبات البحث الفريدة. تتوفّر طريقة عرض مقسّمة حسب الوقت في واجهة مستخدم "إعلانات Google": clicks_unique_query_clusters conversions_unique_query_clusters impressions_unique_query_clusters
الفيديوهات
YouTubeVideoListAsset	مورد / حقل جديد	تسمح بإنشاء روابط بين الحملات ومواد عرض قوائم الفيديوهات باستخدام Asset.youtube_video_list_asset. يمكنك الاطّلاع على استخدام الفيديوهات ذات الصلة.
إضافات البيانات الوصفية للإحصاءات	حقول جديدة	إضافة بيانات وصفية جديدة إلى YouTubeChannelInsights وYouTubeVideoAttributeMetadata
أنواع النقرات التفاعلية	قيم التعداد الجديدة	تمت إضافة أنواع النقرات: VIDEO_RELATED_VIDEOS_CLICK وVIDEO_CHANNEL_CLICK وPRODUCT_ASSETS.
VideoAdInventoryControl.allow_non_skippable_in_stream	حقل جديد	تسمح هذه الميزة بعرض "إعلانات الفيديو المتجاوبة مع مختلف الأجهزة" كإعلانات غير قابلة للتخطي أثناء عرض الفيديو في الحملات التي تجمع بين أشكال الإعلانات القابلة للتخطي وغير القابلة للتخطي.
إعدادات تحديد تسلسل الفيديوهات	حقول جديدة	تمت إضافة إعدادات تسلسل للقراءة فقط: Campaign.VideoCampaignSettings.video_ad_sequence وVideoAdSequenceStepSetting. مزيد من المعلومات عن تحديد تسلسل إعلانات الفيديو
استهداف قوائم الفيديوهات	نوع المعيار أو الحقل الجديد	تمت إضافة نوع المعيار VIDEO_LINEUP والحقل المقابل في CampaignCriterion وAdGroupCriterion. هذه الميزة متوفّرة فقط للحسابات المُدرَجة في القائمة المسموح بها.
مشاهدات مواضع إعلانات "ملاءمة المحتوى"	مراجع جديدة لإعداد التقارير	تمّت إضافة تقرير "ملاءمة المحتوى" على مستوى التفاصيل (detail_content_suitability_placement_view) والمجموعة (group_content_suitability_placement_view). مزيد من المعلومات حول تقرير "ملاءمة المحتوى"

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

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