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

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

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

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

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

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

الإصدار 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