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

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

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

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

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

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

نسخه 16 تا 17

تغییرات در خدمات و اجزای آنها
`GoogleAdsService` `Search` و درخواست‌های `SearchStream`	خطای زمانی که درخواست شما به دلیل گرانی بسیار ناچیز است، `QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION` یا `QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION` به جای `QuotaError.RESOURCE_EXHAUSTED` خواهد بود. برای جزئیات بیشتر به پست وبلاگ مراجعه کنید.
درخواست‌های `Search` `GoogleAdsService` .	ارسال یک `page_size` به `GoogleAdsService.Search` منجر به خطای `RequestError.PAGE_SIZE_NOT_SUPPORTED` می شود.
`Campaign` و `Ad`	کمپین‌های دارای `AdvertisingChannelType` of `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`	اگر نوع مطابقت کلمه کلیدی تنظیم نشده باشد، API اکنون به جای `UNKNOWN` برای فیلد `recommended_match_type` `UNSPECIFIED` برمی‌گرداند.