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

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

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

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

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

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

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