انحرافات اعلام شده

این صفحه تاریخ‌های منسوخ شدن و غروب آفتاب را برای نسخه‌های API و ویژگی‌های فردی در Display & Video 360 API فهرست می‌کند.

تاریخ‌های منسوخ شدن و غروب آفتاب برای API نیز در وبلاگ برنامه‌نویس Google Ads اعلام می‌شود.

منسوخ شدن نسخه

نسخه های Display & Video 360 API به طور منظم منتشر، منسوخ و غروب می شوند. این مراحل به صورت زیر تعریف می شوند:

• انتشار : نسخه از هر وضعیت آلفا یا بتا خارج می شود و پایدار در نظر گرفته می شود. ممکن است همچنان ویژگی های اضافه شده برای نسخه منتشر شود.
• منسوخ شدن : نسخه در حال بازنشستگی است و تاریخ پایان پشتیبانی (غروب آفتاب) اعلام شده است. کاربران باید قبل از غروب آفتاب به نسخه جدیدتر مهاجرت کنند. ویژگی های اضافه شده دیگر برای نسخه منتشر نخواهد شد.
• غروب : نسخه دیگر پشتیبانی نمی شود. درخواست‌هایی که به نسخه ارسال می‌شود یک خطا را برمی‌گرداند.

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

نسخه API	تاریخ انتشار	تاریخ منسوخ شدن	تاریخ غروب آفتاب	راهنمای مهاجرت
v3	31 اکتبر 2023
v2	6 دسامبر 2022	15 فوریه 2024	3 سپتامبر 2024	از نسخه 2 به نسخه 3 مهاجرت کنید
v1	9 مارس 2020	13 مارس 2023	14 سپتامبر 2023	از v1 به v2 مهاجرت کنید

حذف ویژگی ها

وبلاگ برنامه‌نویس Google Ads ما را برای اطلاعیه‌های مربوط به حذف ویژگی‌های مهم آینده دنبال کنید.

جدول زیر تمام موارد منسوخ شدن ویژگی های اعلام شده را فهرست می کند، تاریخ شروع اولیه و شرحی از انحلال را همراه با اقدامات توصیه شده و پیوندهایی به اسناد مربوطه ارائه می دهد:

ویژگی	تاریخ شروع اولیه	توضیحات
توسعه هدف گذاری	25 مارس 2023	جایگزینی ویژگی گسترش هدف‌گیری با هدف‌یابی بهینه شده ، از ۲۵ مارس ۲۰۲۳ تا اوایل ماه مه ۲۰۲۳ به‌تدریج اجرا شد. تغییرات مربوط به Display & Video 360 API و رفتار فایل‌های داده ساختاریافته و همچنین اقدامات توصیه‌شده در یک پست وبلاگ اعلام شد.
محرک های دستی	17 مه 2023	جدول زمانی: 17 مه 2023: موارد خطی که از محرک‌های دستی استفاده می‌کنند در Display & Video 360 متوقف می‌شوند. اگر پس از این تاریخ یک راه‌انداز دستی مرتبط با یک مورد خط فعال را فعال کنید، مورد خط تبلیغاتی را نمایش نمی‌دهد. 1 آگوست 2023: سرویس advertisers.manualTriggers در DV360 API نسخه 1 و نسخه 2، مقدار فهرست LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER در DV360 API v1، و قسمت LineItemFlight.triggerId در DV360 API v1 غروب خواهد کرد. پس از این تاریخ، درخواست‌هایی که به این سرویس‌ها یا این فیلدها ارسال می‌شود، با خطا مواجه می‌شوند. اقدامات توصیه شده: فوراً استفاده از محرک‌های دستی را برای شروع و توقف سرویس اقلام خط متوقف کنید. درخواست به سرویس advertisers.manualTriggers را متوقف کنید. فیلدهای flight.flightDateType و flight.triggerId را برای همه موارد خط با استفاده از محرک‌های دستی به‌روزرسانی کنید.
برنامه‌های نصب‌شده و دستگاه‌های تلفن همراه جدید انواع GoogleAudience	20 مه 2023	جدول زمانی: 20 مه 2023: دیگر نمی‌توانید منابع GoogleAudience را با GoogleAudienceType از GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS یا GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES به هدف‌یابی مخاطب خط یا سفارش درج اختصاص دهید. درخواست‌هایی که این مخاطبان را به هدف‌یابی مخاطب خطی اختصاص می‌دهند، با خطا مواجه می‌شوند. این شامل درخواست‌های advertisers.lineItems.duplicate و advertisers.lineItems.generateDefault می‌شود، در صورتی که مورد خط ایجاد شده شامل مخاطبان منسوخ شده در هدف‌گیری مخاطبانش باشد. 8 ژوئن 2023: مخاطبان تحت تأثیر از همه هدف‌گذاری مورد خط و سفارش درج و از همه مخاطبان ترکیبی حذف خواهند شد. اگر زمانی که این مخاطبان حذف می‌شوند، یک مورد خطی نتواند تبلیغات را ارائه دهد، موقتاً متوقف می‌شود. در این تاریخ، این مخاطبان دیگر با استفاده از سرویس googleAudiences قابل بازیابی نخواهند بود. وظایف پیشنهادی: توصیه می‌کنیم هنگام به‌روزرسانی‌های آینده برای هدف‌یابی مورد خط خود، فوراً استفاده از مخاطبان تحت تأثیر را متوقف کنید. همه مخاطبان تحت تأثیر را از هدف گذاری مورد خط موجود و سفارش درج حذف کنید. درباره به‌روزرسانی هدف‌گیری مخاطب در راهنمای مخاطبان هدف ما بخوانید.
انواع FirstAndThirdPartyAudience بر اساس فعالیت و محدودیت فرکانس	20 مه 2023	جدول زمانی: 20 مه 2023: دیگر نمی‌توانید منابع FirstAndThirdPartyAudience را با AudienceType ACTIVITY_BASED یا FREQUENCY_CAP به هدف‌یابی مخاطب خطی یا سفارش درج اختصاص دهید. درخواست‌هایی که این مخاطبان را به هدف‌یابی مخاطب خطی اختصاص می‌دهند، با خطا مواجه می‌شوند. این شامل درخواست‌های advertisers.lineItems.duplicate و advertisers.lineItems.generateDefault می‌شود، در صورتی که مورد خط ایجاد شده شامل مخاطبان منسوخ شده در هدف‌گیری مخاطبانش باشد. 8 ژوئن 2023: مخاطبان تحت تأثیر از همه هدف‌گذاری مورد خط و سفارش درج و از همه مخاطبان ترکیبی حذف خواهند شد. اگر زمانی که این مخاطبان حذف می‌شوند، یک مورد خطی نتواند تبلیغات را ارائه دهد، موقتاً متوقف می‌شود. در این تاریخ، این مخاطبان نیز دیگر با استفاده از سرویس firstAndThirdPartyAudiences قابل بازیابی نخواهند بود. وظایف پیشنهادی: توصیه می‌کنیم هنگام به‌روزرسانی‌های آینده برای هدف‌یابی مورد خط خود، فوراً استفاده از مخاطبان تحت تأثیر را متوقف کنید. همه مخاطبان تحت تأثیر را از هدف گذاری مورد خط موجود و سفارش درج حذف کنید. درباره به‌روزرسانی هدف‌گیری مخاطب در راهنمای مخاطبان هدف ما بخوانید.
محدودیت های سهمیه API موجود	30 مه 2023	در 30 می 2023، محدودیت‌های استفاده موجود با ساختار سهمیه ترکیبی جایگزین می‌شود که موارد زیر را انجام می‌دهد: حذف درخواست ها در روز به ازای هر سهمیه پروژه. یک درخواست در دقیقه برای هر تبلیغ کننده در هر سهمیه پروژه برای روش های واجد شرایط ایجاد می کند. این محدودیت‌های جدید به انعطاف‌پذیری بیشتری در استفاده از API اجازه می‌دهد و موازی‌سازی درخواست‌ها را در بین تبلیغ‌کنندگان ممکن می‌سازد. جزئیات این تغییر در اسناد محدودیت سهمیه موجود ما موجود است.
OR استفاده از اپراتور بین محدودیت های فیلدهای مختلف در فیلترهای LIST تاریخ شروع اولیه به روز شد	21 ژوئن 2023	در 21 ژوئن 2023، پارامترهای filter درخواست LIST دیگر اجازه استفاده از عملگرهای منطقی OR را بین محدودیت های فیلدهای مختلف نمی دهد. برای مثال، منابع شناسایی شده با رشته فیلتر lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR insertionOrderId="123" باید با استفاده از دو درخواست LIST با رشته های فیلتر زیر بازیابی شوند: lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" insertionOrderId="123" برای جزئیات بیشتر در مورد محدودیت‌های عملگرهای منطقی ، به راهنمای نحوه فیلتر کردن درخواست‌های LIST مراجعه کنید. پارامترهای جستجوی filter همه تماس‌های LIST موجود خود را بررسی کنید و بررسی کنید که آنها قبل از 21 ژوئن 2023 از عملگر منطقی OR به درستی استفاده می‌کنند تا از وقفه در سرویس جلوگیری شود.
امکان فیلتر کردن یا درخواست لیست سفارش بر اساس budget.budget_segments. date_range.end_date فیلدهای budget.budget_segments. date_range.end_date و flight.dateRange.endDate تاریخ شروع اولیه به روز شد	21 ژوئن 2023	در 21 ژوئن 2023، budget.budget_segments. date_range.end_date و flight.dateRange.endDate دیگر به ترتیب در قسمت advertisers.insertionOrders.list و advertisers.lineItems.list filter و orderBy پارامترهای پرس و جو پذیرفته نمی شوند. پس از این تاریخ، درخواست‌هایی که از این فیلدها در پارامترهای پرس و جو filter و orderBy استفاده می‌کنند، با خطا مواجه می‌شوند. قبل از 21 ژوئن 2023 تمام منطق فیلتر و سفارش را با استفاده از این دو فیلد حذف کنید تا از وقفه در سرویس جلوگیری کنید.
امکان فیلتر کردن درخواست‌های advertisers.lineItems.list با چهار فیلد اضافی	21 ژوئن 2023	در 21 ژوئن 2023، advertisers.lineItems.list دیگر از فیلتر کردن با فیلدهای زیر پشتیبانی نخواهد کرد: flight.triggerId targetedChannelId targetedNegativeKeywordListId warningMessages تمام منطق فیلتر را با استفاده از این چهار قسمت قبل از 21 ژوئن 2023 حذف کنید تا از وقفه در سرویس جلوگیری شود.
خرید مبتنی بر نتیجه	1 آگوست 2023	در 1 اوت 2023، سفارش‌های درج با استفاده از خرید مبتنی بر نتیجه، که با مقدار فیلد billableOutcome BILLABLE_OUTCOME_PAY_PER_CLICK یا BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION تعریف شده‌اند، و موارد خط فرزند آنها بایگانی می‌شوند. این تغییر بر درخواست‌های زیر تأثیر می‌گذارد: تلاش برای استفاده از advertisers.insertionOrders.create برای ایجاد یک سفارش درج با استفاده از خرید مبتنی بر نتیجه، خطای 400 را برمی‌گرداند. تلاش برای استفاده از advertisers.lineItems.create ، advertisers.lineItems.duplicate ، یا advertisers.lineItems.generateDefault برای ایجاد یک مورد خطی تحت سفارش درج با استفاده از خرید مبتنی بر نتیجه، خطای 400 را برمی‌گرداند. با توجه به اینکه منابع بایگانی شده به طور پیش‌فرض در درخواست‌های LIST گنجانده نمی‌شوند، منابع تحت تأثیر دیگر به‌طور پیش‌فرض توسط روش‌های advertisers.insertionOrders.list و advertisers.lineItems.list برگردانده نمی‌شوند.
publisherReviewStatuses قسمت Statuses در منابع خلاق	26 ژوئن 2024	از 26 ژوئن 2024، قسمت publisherReviewStatuses غروب می‌کند و هنگام بازیابی منابع Creative خالی می‌شود.
زیرمجموعه هدف‌یابی محتوا برای موارد خط YouTube & Partners	30 سپتامبر 2024	در 30 سپتامبر 2024، مقادیر زیر برای انواع هدف شناسایی شده برای موارد خط YouTube & Partners غروب می‌کند: TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION : CONTENT_RATING_TIER_UNRATED CONTENT_RATING_TIER_GENERAL CONTENT_RATING_TIER_PARENTAL_GUIDANCE CONTENT_RATING_TIER_TEENS CONTENT_RATING_TIER_MATURE TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION : SENSITIVE_CATEGORY_EMBEDDED_VIDEO SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO گزینه های هدف گذاری غروب به طور خودکار از هدف گذاری مورد خط موجود حذف می شود. برای جلوگیری از هرگونه وقفه در سرویس، قبل از غروب آفتاب، این هدف‌گیری را از همه موارد خط YouTube & Partners موجود حذف کنید.
مخاطبان شخص اول و شخص ثالث اوراکل	30 سپتامبر 2024	در 30 سپتامبر 2024، منابع FirstAndThirdPartyAudience از Oracle غروب خواهند کرد. به محض غروب آفتاب، این مخاطبان از هر منبع هدف موجود و مخاطب ترکیبی حذف خواهند شد. اگر یک مورد خطی فقط مخاطبان غروب خورشید را هدف قرار دهد یا مخاطبان غروب خورشید را هدف قرار دهد، این به‌روزرسانی به‌طور خودکار آن مورد خط را متوقف می‌کند. برای جلوگیری از هرگونه وقفه در سرویس، قبل از غروب آفتاب، مخاطبان Oracle را از مخاطبان مورد خط موجود و مخاطبان ترکیبی شناسایی و حذف کنید.
هدف گذاری بهینه سازی شده برای زیرمجموعه ای از استراتژی های پیشنهادی	30 سپتامبر 2024	در 30 سپتامبر 2024، منابع LineItem با استفاده از زیرمجموعه‌ای از استراتژی‌های پیشنهاد قیمت، دیگر با هدف‌یابی بهینه سازگاری ندارند. با این تغییر، منابع LineItem با targetingExpansion.enableOptimizedTargeting بر روی True و bidStrategy.maximizeSpendAutoBid.performanceGoalType روی BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA ، BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN , BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED یا bidStrategy.performanceGoalAutoBid.performanceGoalType تنظیم شده روی BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM برای False targetingExpansion.enableOptimizedTargeting به روز رسانی می شود. برای جلوگیری از هرگونه وقفه در سرویس، به‌روزرسانی و بررسی کنید که موارد خط شما با استفاده از این استراتژی‌های پیشنهادی، هدف‌یابی بهینه را روشن نکرده باشند.
برای سفارشات درج Pacing پرواز کنید	5 نوامبر 2024	در تاریخ 5 نوامبر 2024، PACING_TYPE_ASAP دیگر با PACING_PERIOD_FLIGHT هنگام تنظیم فیلد pacing ترتیب درج سازگار نخواهد بود. pacingType برای همه سفارش‌های درج موجود با این پیکربندی به PACING_TYPE_AHEAD به‌روزرسانی می‌شود. برای جلوگیری از هرگونه وقفه در سرویس، pacing هر گونه سفارش درج موجود را با استفاده از PACING_TYPE_ASAP و PACING_PERIOD_FLIGHT به‌روزرسانی کنید.