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

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

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

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

  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 خواهد بود. برای جزئیات بیشتر به پست وبلاگ مراجعه کنید.

درخواست‌های 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 برمی‌گرداند.