این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

به آخرین نسخه ارتقا دهید

به‌طور دوره‌ای، ممکن است بخواهید از نسخه اصلی قدیمی‌تر API Google Ads به نسخه اصلی جدیدتر ارتقا دهید. ممکن است به این دلیل باشد که یک نسخه در حال غروب است، یا ممکن است به این دلیل باشد که می خواهید از یک ویژگی جدید استفاده کنید. توصیه می کنیم همیشه به جدیدترین نسخه ارتقا دهید.

برای برنامه ریزی ارتقاهای خود، برنامه منسوخ شدن ما را بررسی کنید. برای آشنایی با نحوه عملکرد نسخه‌سازی ، راهنمای نسخه‌سازی ما را ببینید.

در اینجا یک چک لیست برای کمک به شما برای شروع فرآیند ارتقا وجود دارد:

با تغییر نسخه های اصلی، نقطه پایان شما تغییر می کند. کتابخانه های مشتری خود را برای استفاده از جدیدترین نقطه پایانی به روز کنید.
برای مشاهده تغییراتی که در هر نسخه ارائه شده است ، یادداشت های انتشار را مرور کنید.
جداول زیر را برای مناطق خاصی که باید روی نسخه‌ای که به آن ارتقا می‌دهید تمرکز کنید، بررسی کنید.

برای یک نمای کلی جامع از تغییرات بر اساس تفاوت بین پروتوهای دو نسخه، به جدول تفاوت نگاه کنید.

نسخه 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`	اگر نوع مطابقت کلمه کلیدی تنظیم نشده باشد، API اکنون به جای `UNKNOWN` برای فیلد `recommended_match_type` `UNSPECIFIED` برمی‌گرداند.

نسخه 14 تا 15

تغییرات در خدمات و اجزای آنها
`AssetGroupListingGroupFilter`	فیلد enum `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` .