قد ترغب بشكل دوري في الترقية من إصدار رئيسي قديم من Google Ads API إلى إصدار رئيسي أحدث. قد يرجع ذلك إلى إيقاف العمل بإصدار معيّن، أو إلى رغبتك في استخدام ميزة جديدة. ننصحك بالترقية دائمًا إلى أحدث إصدار.
اطّلِع على الجدول الزمني للإيقاف النهائي للتخطيط لعمليات الترقية. راجِع دليل تحديد الإصدارات لمعرفة آلية عمل الإصدارات.
في ما يلي قائمة تحقُّق لمساعدتك في بدء عملية الترقية:
- ستتغير نقطة النهاية عند تغيير الإصدارات الرئيسية. حدِّث مكتبات البرامج لاستخدام أحدث نقطة نهاية.
- يمكنك مراجعة ملاحظات الإصدار للاطّلاع على التغييرات التي تم تقديمها في كل إصدار.
- راجع الجداول أدناه لمعرفة مجالات محددة للتركيز عليها في الإصدار الذي تقوم بالترقية إليه.
للحصول على نظرة عامة شاملة حول التغييرات استنادًا إلى الفرق بين النماذج الأوّلية من النسختين، راجِع جدول الاختلافات.
الإصدار 16 إلى الإصدار 17
التغييرات على الخدمات ومكوناتها | |
---|---|
GoogleAdsService
Search وSearchStream طلب |
الخطأ الذي يحدث عند تقييد طلبك لأنّه مكلف جدًا سيكون إما |
GoogleAdsService
Search طلب |
سيؤدي تمرير |
Campaign و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 العام
إلى ظهور رسائل خطأ أكثر تحديدًا:
|
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 |
حقول الأقسام التالية:
|
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 .
|