آخرین به روز رسانی: 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 را انجام دهید.
تماس‌های بازیابی منابع YouTube و هدف‌یابی مرتبط با آن‌ها را به‌روزرسانی کنید
- منابع
YoutubeAdGroupوYoutubeAdGroupAdبا منابعAdGroupوAdGroupAdجایگزین شده اند. این منابع جدید تقریباً اطلاعات مشابه منابع v2 را ارائه می دهند، اما ممکن است از نام فیلدهای به روز شده یا انواع enum استفاده کنند. در ادغام، استفاده‌های خود از منابعYoutubeAdGroupیاYoutubeAdGroupAdرا با منابعAdGroupوAdGroupAdجایگزین کنید و تماس‌ها را با سرویس‌های v2 زیر به سرویس v3 مربوطه به‌روزرسانی کنید:-
advertisers.youtubeAdGroupAdsبهadvertisers.adGroupAds -
advertisers.youtubeAdGroupsبهadvertisers.adGroups -
advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptionsبهadvertisers.adGroups.targetingTypes.assignedTargetingOptions
-
- ارجاع به اشیاء
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 حذف شده‌اند تا با حذف ویژگی‌های گذشته هماهنگ شوند:
- سرویس
advertisers.manualTriggersحذف شده است زیرا راه‌اندازهای دستی منسوخ شده‌اند . - فیلد
billableOutcomeاز منبعInsertionOrderحذف شده است زیرا خرید مبتنی بر نتیجه منسوخ شده است .
تغییرات اضافی
علاوه بر تغییرات اساسی ذکر شده در بالا، نسخه 3 ویژگی های جدیدی را نیز معرفی می کند.
ویژگی های اضافه شده به نسخه 3 پس از راه اندازی اولیه را می توان در یادداشت های انتشار ما یافت.
مدیریت لیست مکان مجاورت
در نسخه 3 می‌توانید فهرست‌های مکان مجاورت را به طور کامل مدیریت کنید، به شما این امکان را می‌دهد که از سرویس advertisers.locationLists.assignedLocations برای ایجاد و حذف مکان‌های اختصاص داده شده به TARGETING_LOCATION_TYPE_PROXIMITY منابع LocationList استفاده کنید. مکان ها با استفاده از شناسه منابع TARGETING_TYPE_POI TargetingOption شناسایی می شوند. این موارد را می توان با استفاده از targetingTypes.targetingOptions.search بازیابی کرد.
امکان ساخت الگوریتم های پیشنهادی سفارشی مبتنی بر قانون
در نسخه 3، می‌توانید الگوریتم‌های مناقصه سفارشی مبتنی بر قانون را با استفاده از سرویس‌های customBiddingAlgorithms ، media ، customBiddingAlgorithms.rules بسازید و بازیابی کنید.
این ویژگی در نسخه بتا است و فقط برای شرکای مجاز در دسترس است. اگر شریک شما در لیست مجاز نباشد، درخواست شما با خطا مواجه خواهد شد.