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

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

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

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

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

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

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

التغييرات على الخدمات ومكوناتها
GoogleAdsService Search وSearchStream طلب

الخطأ الذي يحدث عند تقييد طلبك لأنّه مكلف جدًا سيكون إما QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION أو QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION بدلاً من 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.

الإصدار 15 إلى الإصدار 16

التغييرات على الخدمات ومكوناتها
AccountLink تمت إزالة الرابطَين data_partner وgoogle_ads في linked_account. استخدِم ProductLinkService وProductLinkInvitationService بدلاً من ذلك.
CampaignLifecycleGoal عند تعديل عنصر CampaignLifecycleGoal حالي في السابق، سيتم إصدار عملية create تتضمّن متطلبات معيّنة. أصبح بإمكانك الآن إصدار عملية update كما هو الحال مع أنواع الموارد الأخرى.
الإبلاغ عن خطأ تؤدي الآن حالتان تم عرضهما لخطأ ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT العام إلى ظهور رسائل خطأ أكثر تحديدًا:
  • CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT
  • CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS
AudienceInsightsAttributeMetadata تمت إزالة الحقل score.
KeywordMatchTypeRecommendation في حال عدم ضبط نوع مطابقة الكلمة الرئيسية، ستعرض واجهة برمجة التطبيقات الآن UNSPECIFIED بدلاً من UNKNOWN للحقل recommended_match_type.

الإصدار 14 إلى الإصدار 15

التغييرات على الخدمات ومكوناتها
AssetGroupListingGroupFilter تمت إعادة تسمية حقل التعداد "vertical" ليصبح feed_type.
MediaFileService تمّت إزالة الخدمة لأنّها لم تعُد ضرورية. يمكنك الاطّلاع على التغيير في ImageAdInfo أدناه.
ImageAdInfo تم استبدال الحقل media_file بالحقل image_asset.
MerchantCenterLinkService لقد تم استبدال الخدمة بـ ProductLinkInvitationService و ProductLinkService.
Campaign.ShoppingSetting تمت إزالة الحقل sales_country. تم إرجاع المعلومات الآن في الحقل feed_label.
ProductBiddingCategoryConstant تم استبداله بـ ProductCategoryConstant. وقد تمت إعادة تسمية حقول متعددة وفقًا لذلك، يُرجى الاطّلاع على التغييرات الثلاثة التالية أدناه.
ListingDimensionInfo تم استبدال الحقل product_bidding_category بـ product_category.
ListingGroupFilterDimension تم استبدال الحقل product_bidding_category بـ product_category.
إبلاغ shopping_performance_view حقول الأقسام التالية:
  • product_bidding_category_level1
  • product_bidding_category_level2
  • product_bidding_category_level3
  • product_bidding_category_level4
  • product_bidding_category_level5
تم استبدالها بما يلي:
  • product_category_level1
  • product_category_level2
  • product_category_level3
  • product_category_level4
  • product_category_level5
Campaign.shopping_setting تمت إزالة دعم إنشاء "حملات على شبكة البحث" باستخدام هذا الحقل.
CampaignCriterion.listing_scope تمت إزالة دعم إنشاء "حملات على شبكة البحث" باستخدام هذا الحقل.
إبلاغ sk_ad_network_conversions تم استبدال metrics.sk_ad_network_conversions بالعنوان metrics.sk_ad_network_installs.
OfflineConversionClientSummary تم نقل الحقل offline_conversion_client_summaries من Customer إلى مورد من المستوى الأعلى يمكنك طلبه بشكل منفصل.

تغيير طلب البحث من:

SELECT customer.offline_conversion_client_summaries
FROM customer
إلى: 
SELECT
  offline_conversion_upload_client_summary.client,
  offline_conversion_upload_client_summary.status,
  offline_conversion_upload_client_summary.total_event_count,
  offline_conversion_upload_client_summary.successful_event_count,
  offline_conversion_upload_client_summary.last_upload_date_time,
  ...
FROM offline_conversion_upload_client_summary

استخدِم أداة إنشاء طلبات البحث للاطّلاع على قائمة الحقول المتاحة للاختيار والفلترة.
OfflineConversionUploadAlert تغيّر الاسم إلى OfflineConversionAlert.
OfflineConversionUploadError تغيّر الاسم إلى OfflineConversionError.
AdNetworkType تم دمج التعدادين YOUTUBE_SEARCH و YOUTUBE_WATCH في تعداد واحد: YOUTUBE.