تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

الترقية إلى أحدث إصدار

قد ترغب بشكل دوري في الترقية من إصدار رئيسي قديم من Google Ads API إلى إصدار رئيسي أحدث قد يرجع ذلك إلى إيقاف العمل بإصدار معيّن، أو قد يكون السبب أنّك تريد استخدام ميزة جديدة ننصحك بالترقية دائمًا إلى أحدث إصدار.

اطّلِع على الجدول الزمني للإيقاف من أجل التخطيط لعمليات الترقية. اطّلِع على دليل تحديد الإصدارات للتعرُّف على كيفية إجراء ذلك عمل الإصدارات.

في ما يلي قائمة تحقُّق لمساعدتك في بدء عملية الترقية:

ستتغيّر نقطة النهاية عند تغيير الإصدارات الرئيسية. عدِّل مكتبات العملاء لاستخدام أحدث نقطة نهاية.
اطّلِع على ملاحظات الإصدار للاطّلاع على التغييرات التي تم إجراؤها في كل إصدار.
اطّلِع على الجداول أدناه لمعرفة الجوانب المحدّدة التي يجب التركيز عليها في الإصدار الذي تتم الترقية إليه.

لإلقاء نظرة عامة شاملة على التغييرات بناءً على الفرق بين النماذج الأولية من الإصدارَين، اطّلِع على جدول الاختلافات.

الإصدار 17 إلى الإصدار 18

التغييرات على الخدمات ومكوناتها
`GoogleAdsService` طلبات `Search` و`SearchStream`	سيظهر الخطأ عند تقييد طلبك لأنه مكلف للغاية تكون إما `QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION` أو `QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION` بدلاً من ذلك من أصل `QuotaError.RESOURCE_EXHAUSTED`. الاطلاع على المدونة مشاركة للاطّلاع على المزيد من التفاصيل.
`GoogleAdsService`	يعمل `summary_row_setting` حقلان (`return_total_results_count`) في `SearchGoogleAdsRequest` أصبحت الآن جزءًا من الكائن الجديد `SearchSettings`.
`AssetType`	تمت إعادة تسمية قيمة التعداد `DISCOVERY_CAROUSEL_CARD` إلى `DEMAND_GEN_CAROUSEL_CARD` يتوافق ذلك مع تغيير سابق لإعادة تسمية "الحملات أثناء التصفّح" إلى "الحملات لزيادة الطلب".
`AudienceInsightsService.GenerateSuggestedTargetingInsights`	تم نقل الحقول `audience` و`baseline_audience` و `data_month` ضمن الحقل `audience_definition`.
`DemandGenCampaignSettings`	القيمة التلقائية للحقل `upgraded_targeting` هي الآن. `true` بدلاً من `false`
`LocalServicesLeadConversation`	لن تتم تعبئة الحقل `phone_call_details.call_recording_url` للمكالمات الثابتة بعد الآن.

من الإصدار 16 إلى الإصدار 17

التغييرات على الخدمات ومكوناتها
`GoogleAdsService` طلبات `Search` و`SearchStream`	قد يتم تقييد طلبك إذا كان طلب البحث مكلفًا جدًا. إذا كان الأمر كذلك، ستظهر لك رسالة الخطأ `QuotaError.RESOURCE_EXHAUSTED`. يمكنك الاطّلاع على مشاركة المدونة لمعرفة المزيد من التفاصيل.
`GoogleAdsService` `Search` طلب.	سيؤدي تمرير `page_size` إلى `GoogleAdsService.Search` إلى حدوث خطأ `RequestError.PAGE_SIZE_NOT_SUPPORTED`.
`Campaign` و`Ad`	إنّ الحملات التي تتضمّن `AdvertisingChannelType` من `DISCOVERY` ستتضمّن الآن `AdvertisingChannelType` من `DEMAND_GEN` بدلاً من ذلك. إضافةً إلى ذلك، ستغيِّر بعض الإعلانات نوعها وأسماء الحقول المتعلقة بها في التقارير: سيصبح `DISCOVERY_MULTI_ASSET_ADD` `DEMAND_GEN_MULTI_ASSET_ADD` وحقل إعداد التقارير المقابل سيصبح `ad_group_ad.ad.discovery_multi_asset_ad` `ad_group_ad.ad.demand_gen_multi_asset_ad` سيصبح `DISCOVERY_CAROUSEL_AD` `DEMAND_GEN_CAROUSEL_AD` وسيصبح حقل إعداد التقارير المعني `ad_group_ad.ad.discovery_carousel_ad` `ad_group_ad.ad.demand_gen_carousel_ad`. سيصبح `DISCOVERY_VIDEO_RESPONSIVE_AD` `DEMAND_GEN_VIDEO_RESPONSIVE_AD` وحقل إعداد التقارير المقابل سيصبح `ad_group_ad.ad.discovery_video_responsive_ad` `ad_group_ad.ad.demand_gen_video_responsive_ad`
`AdService`	ستتم إزالة نقطة النهاية `GetAd`. ويؤدي ذلك إلى توافق `AdService` مع الخدمات الأخرى في Google Ads API. اطّلِع على دليلنا حول استرداد العناصر للتعرّف على الطريقة المُقترَحة لجلب الإعلانات وأنواع الموارد الأخرى.
`CustomerLifecycleGoal` و`CampaignLifecycleGoal`	تمّت إعادة صياغة طريقة إدارة الشرائح لأهداف مراحل النشاط. اطّلِع على قسم تصنيف شرائح جمهورك في مستندات أهداف مراحل النشاط للاطّلاع على نظرة عامة كاملة.
`ProductLink`	عند إجراء طلب بحث أو طلب مجرى بحث في `GoogleAdsService` لـ `product_link`، يمكنك الآن اختيار الحقول ذات الصلة فقط بمنتج واحد مرتبط. سيؤدي اختيار حقول متعدّدة من منتجات مرتبطة مختلفة إلى حدوث `QuotaError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE` خطأ.
إعداد التقارير	تمت إعادة تسمية الحقل "`metrics.sk_ad_network_conversion_value`" إلى `metrics.sk_ad_network_fine_conversion_value`