از نسخه 2 به نسخه 3 مهاجرت کنید

آخرین به روز رسانی: 2023-10-31

درخواست خود را مهاجرت کنید

مهاجرت از نسخه 2 به نسخه 3 مستلزم به روز رسانی URL های نقطه پایانی برای فراخوانی نسخه 3 و به روز رسانی برنامه خود برای حسابرسی برای تغییرات شکسته است.

تماس‌های API خود را از نسخه ۲ به نسخه ۳ به‌روزرسانی کنید

برای استفاده از v3 به جای v2، باید درخواست های خود را برای استفاده از نقاط پایانی جدید v3 به روز کنید.

به عنوان مثال، برای فراخوانی متد advertisers.get با v2، از URL زیر استفاده کنید:

GET https://displayvideo.googleapis.com/v2/advertisers/advertiserId

برای نسخه 3، URL را به موارد زیر به روز کنید:

GET https://displayvideo.googleapis.com/v3/advertisers/advertiserId

اگر از کتابخانه سرویس گیرنده برای درخواست به API استفاده می کنید، از جدیدترین نسخه کتابخانه مشتری استفاده کنید و پیکربندی خود را برای استفاده از v3 به روز کنید.

تغییرات لازم را انجام دهید

ما در حال معرفی تعدادی از تغییرات شکسته در نسخه 3 هستیم. دستورالعمل‌های زیر را مرور کنید و تغییرات مورد نیاز مربوط به استفاده فعلی خود از Display & Video 360 API را انجام دهید.

  • منابع YoutubeAdGroup و YoutubeAdGroupAd با منابع AdGroup و AdGroupAd جایگزین شده اند. این منابع جدید تقریباً اطلاعات مشابه منابع v2 را ارائه می دهند، اما ممکن است از نام فیلدهای به روز شده یا انواع enum استفاده کنند. در ادغام، استفاده‌های خود از منابع YoutubeAdGroup یا YoutubeAdGroupAd را با منابع AdGroup و AdGroupAd جایگزین کنید و تماس‌ها را با سرویس‌های v2 زیر به سرویس v3 مربوطه به‌روزرسانی کنید:
  • ارجاع به اشیاء YoutubeAndPartnersBiddingStrategy به یک فیلد جدید youtubeAndPartnersBid در شیء عمومی BiddingStrategy منتقل شده است. فیلد biddingStrategy از شی YoutubeAndPartnersSettings حذف شده است. ادغام خود را برای بازیابی استراتژی پیشنهاد قیمت برای موارد خط YouTube یا گروه های تبلیغاتی از شی BiddingStrategy در قسمت bidStrategy در منبع LineItem یا AdGroup به روز کنید.
  • نام فیلد thirdPartyMeasurementSettings به thirdPartyMeasurementConfigs در شی YoutubeAndPartnersSettings و شی YoutubeAndPartnersThirdPartyMeasurementSettings به ThirdPartyMeasurementConfigs تغییر نام داده شده است. ادغام خود را برای بازیابی اطلاعات پیکربندی اندازه گیری شخص ثالث با استفاده از فیلد و شی جدید به روز کنید.

هنگام ایجاد آگهی‌دهندگان، پیکربندی‌های صورت‌حساب مورد نیاز را لحاظ کنید

billingConfig اکنون یک فیلد ضروری در منبع Advertiser است. advertisers.create خود را به‌روزرسانی کنید. درخواست‌ها را ایجاد کنید تا تأیید کنید که این فیلد تنظیم شده است. اطلاعات صورت‌حساب پیش‌فرض را می‌توان از طریق قسمت جدید billingConfig منبع Partner برای شریک اصلی بازیابی کرد.

از فیلد جدید برای کنترل هدف گذاری بهینه استفاده کنید

یک فیلد بولی enableOptimizedTargeting جدید جایگزین فیلد targetingExpansionLevel در شی TargetingExpansionConfig شده است.

برای استفاده از فیلد KPI جدید، ادغام سفارش درج را به روز کنید

یک فیلد kpi جدید جایگزین فیلد performanceGoal در منبع InsertionOrder شده است. این فیلد جدید از یک شی Kpi به جای شی PerformanceGoal استفاده می کند و از فیلدها و enum های جدید استفاده می کند.

ارجاع به خدمات و فیلدهای منسوخ شده را حذف کنید

موجودیت‌های مختلفی در نسخه 3 حذف شده‌اند تا با حذف ویژگی‌های گذشته هماهنگ شوند:

تغییرات اضافی

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

ویژگی های اضافه شده به نسخه 3 پس از راه اندازی اولیه را می توان در یادداشت های انتشار ما یافت.

مدیریت لیست مکان مجاورت

در نسخه 3 می‌توانید فهرست‌های مکان مجاورت را به طور کامل مدیریت کنید، به شما این امکان را می‌دهد که از سرویس advertisers.locationLists.assignedLocations برای ایجاد و حذف مکان‌های اختصاص داده شده به TARGETING_LOCATION_TYPE_PROXIMITY منابع LocationList استفاده کنید. مکان ها با استفاده از شناسه منابع TARGETING_TYPE_POI TargetingOption شناسایی می شوند. این موارد را می توان با استفاده از targetingTypes.targetingOptions.search بازیابی کرد.

امکان ساخت الگوریتم های پیشنهادی سفارشی مبتنی بر قانون

در نسخه 3، می‌توانید الگوریتم‌های مناقصه سفارشی مبتنی بر قانون را با استفاده از سرویس‌های customBiddingAlgorithms ، media ، customBiddingAlgorithms.rules بسازید و بازیابی کنید.

این ویژگی در نسخه بتا است و فقط برای شرکای مجاز در دسترس است. اگر شریک شما در لیست مجاز نباشد، درخواست شما با خطا مواجه خواهد شد.