منسوخ شدن ویژگی‌های بایگانی‌شده

این جدول، منسوخ شدن ویژگی‌های اعلام‌شده‌ای را که بر نسخه‌های منسوخ‌شده‌ی Display & Video 360 API یا Structured Data File تأثیر گذاشته‌اند، فهرست می‌کند. این جدول، تاریخ اولیه‌ی مؤثر و شرح منسوخ شدن را به همراه اقدامات پیشنهادی و پیوندهایی به مستندات مربوطه ارائه می‌دهد:

توجه: برای اطلاع از منسوخ شدن‌هایی که بر نسخه‌های زنده تأثیر گذاشته‌اند، به صفحه منسوخ شدن‌های اعلام‌شده اصلی ما مراجعه کنید.

ویژگی	تاریخ شروع به کار	توضیحات
محدودیت‌های دسترسی به اقلام در یوتیوب در SDF	۲۴ مارس ۲۰۲۵	در ۲۴ مارس ۲۰۲۵، فایل‌های داده ساختاریافته (Structured Data Files) هنگام ایجاد یا به‌روزرسانی موارد خطی، نیاز به استفاده از قالب‌های تبلیغاتی گسترده‌تری خواهند داشت. این به معنای موارد زیر است: SDF نسخه‌های ۶ و ۷ دیگر از ایجاد ورودی‌های جدید فایل Line Item با مقدار Subtype "Reach" پشتیبانی نمی‌کنند. ورودی‌های جدید در فایل‌های SDF Line Item با Subtype «Reach» باید از مقدار «Responsive» در ستون TrueView Video Ad Formats استفاده کنند. ورودی‌های موجود با Subtype «Reach» نمی‌توانند مقدار ستون TrueView Video Ad Formats خود را به‌روزرسانی کنند. ورودی‌های جدید در فایل‌های SDF Line Item با مقدار Subtype "Reach" نیاز به جمعیت ستون TrueView Video Ad Inventory Control دارند.
خطای عدم تطابق شریک/تبلیغ‌کننده جدید sdfdownloadtasks.create	۶ مارس ۲۰۲۵	در تاریخ ۶ مارس ۲۰۲۵، درخواست‌های sdfdownloadtasks.create که از یک فیلتر موجودیت والد برای فیلتر کردن بر اساس تبلیغ‌کنندگانی که فرزند مجموعه partnerId نیستند استفاده می‌کنند، شروع به بازگرداندن خطای 400 خواهند کرد.
به‌روزرسانی به اندازه پیش‌فرض صفحه firstAndThirdPartyAudiences.list	۶ مارس ۲۰۲۵	در تاریخ ۶ مارس ۲۰۲۵، اندازه پیش‌فرض صفحه برای درخواست‌های firstAndThirdPartyAudiences.list از ۱۰۰ به ۵۰۰۰ به‌روزرسانی خواهد شد. برای جلوگیری از وقفه در سرویس، ادغام خود را به‌روزرسانی کنید تا پارامتر پرس‌وجوی pageSize مربوط به درخواست‌های firstAndThirdPartyAudiences.list خود را روی اندازه صفحه دلخواه خود تنظیم کنید.
هدف‌گذاری بهینه برای اقلام خطی با استفاده از پیشنهاد قیمت ثابت	۶ مارس ۲۰۲۵	در ۶ مارس ۲۰۲۵: درخواست‌های ایجاد یا به‌روزرسانی منابع LineItem برای تنظیم فیلد BiddingStrategy fixedBid و فیلد TargetingExpansionConfig به true enableOptimizedTargeting خطای 400 را برمی‌گردانند. ورودی‌های موجود در فایل‌های داده ساختاریافته‌ی ردیفی که مقدار ستون «نوع استراتژی پیشنهاد قیمت» آنها «ثابت» و مقدار ستون «هدف‌گذاری بهینه‌شده» آنها «درست» باشد، در هنگام آپلود فایل ایجاد یا به‌روزرسانی نمی‌شوند. ردیف‌های موجود که از قیمت‌گذاری ثابت استفاده می‌کنند، به‌روزرسانی می‌شوند تا هدف‌گذاری بهینه‌شده غیرفعال شود. برای جلوگیری از هرگونه وقفه در سرویس: منابع موجود برای اقلام خطی که از هر دو روش قیمت‌گذاری ثابت و هدف‌گذاری بهینه استفاده می‌کنند را به‌روزرسانی کنید. هنگام ایجاد یا به‌روزرسانی منابع اقلام خطی با استفاده از Display & Video 360 API یا Structured Data Files، تأیید کنید که ادغام شما شامل تعیین یک استراتژی قیمت‌گذاری ثابت و هدف‌گذاری بهینه نباشد.
دوره محدودیت فرکانس بیش از 30 روز	۲۸ فوریه ۲۰۲۵	در ۲۸ فوریه ۲۰۲۵: درخواست‌های ایجاد یا به‌روزرسانی منابع LineItem ، InsertionOrder و Campaign برای استفاده از یک شیء FrequencyCap با فیلد timeUnit تنظیم‌شده روی TIME_UNIT_LIFETIME یا فیلد timeUnit تنظیم‌شده روی TIME_UNIT_MONTH و فیلد timeUnitCount تنظیم‌شده روی ۲، خطای 400 را برمی‌گردانند. ورودی‌های موجود در بخش‌های Line Item ، Insertion Order و Campaign Structured Data Files که مقدار ستون "دوره تناوب" آنها "Lifetime" یا مقدار ستون "دوره تناوب" آنها "Months" و مقدار ستون "مقدار تناوب" آنها "2" باشد، در هنگام آپلود فایل ایجاد یا به‌روزرسانی نخواهند شد. کمپین‌های موجود، سفارش‌های درج و ردیف‌های فروش به‌روزرسانی خواهند شد تا از دوره تناوب ۳۰ روزه یا کمتر استفاده کنند. برای جلوگیری از هرگونه وقفه در سرویس: منابع کمپین، ترتیب درج و ردیف‌های موجود که از دوره محدودیت تکرار بیش از ۳۰ روز استفاده می‌کنند را به ۳۰ روز یا کمتر به‌روزرسانی کنید. هنگام ایجاد یا به‌روزرسانی منابع کمپین، ترتیب درج یا ردیف آیتم‌ها با استفاده از Display & Video 360 API یا Structured Data Files، تأیید کنید که ادغام شما، دوره زمانی بیش از 30 روز را برای حداکثر تکرار تنظیم نمی‌کند.
پرواز در اسرع وقت برای Pacing سفارش‌های الحاقی	۵ نوامبر ۲۰۲۴	در تاریخ ۵ نوامبر ۲۰۲۴، هنگام تنظیم فیلد pacing ترتیب درج، PACING_TYPE_ASAP دیگر با PACING_PERIOD_FLIGHT سازگار نخواهد بود. pacingType برای همه ترتیب‌های درج موجود با این پیکربندی به PACING_TYPE_AHEAD به‌روزرسانی می‌شود. برای جلوگیری از هرگونه وقفه در سرویس، pacing هر دستور درج موجود را با استفاده از PACING_TYPE_ASAP و PACING_PERIOD_FLIGHT به‌روزرسانی کنید.
هدف‌گذاری بهینه‌شده برای هر ردیف کالا برای زیرمجموعه‌ای از استراتژی‌های پیشنهاد قیمت	۳۰ سپتامبر ۲۰۲۴	در تاریخ 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 تنظیم شده‌اند، به‌روزرسانی می‌شوند تا targetingExpansion.enableOptimizedTargeting روی False تنظیم شود. برای جلوگیری از هرگونه وقفه در سرویس، موارد خطی خود را که از این استراتژی‌های پیشنهاد قیمت استفاده می‌کنند، به‌روزرسانی و تأیید کنید که هدف‌گیری بهینه فعال نشده باشد.
مخاطبان شخص ثالث و اول شخص اوراکل	۳۰ سپتامبر ۲۰۲۴	در تاریخ 30 سپتامبر 2024، منابع FirstAndThirdPartyAudience از Oracle غیرفعال خواهند شد. پس از غیرفعال شدن، این مخاطبان از هرگونه هدف‌گیری منابع موجود و مخاطبان ترکیبی حذف می‌شوند. اگر یک مورد خطی یا فقط مخاطبان غیرفعال را هدف قرار دهد یا به طور منفی هر مخاطب غیرفعال را هدف قرار دهد، این به‌روزرسانی به طور خودکار آن مورد خطی را متوقف می‌کند. برای جلوگیری از هرگونه وقفه در سرویس، قبل از تاریخ انقضا، مخاطبان اوراکل را از لیست مخاطبان هدف موجود و مخاطبان ترکیبی شناسایی و حذف کنید.
هدف‌گذاری محتوا برای موارد خطی یوتیوب و شرکا	۳۰ سپتامبر ۲۰۲۴	در تاریخ 30 سپتامبر 2024، مقادیر زیر برای انواع هدف‌گذاری شناسایی‌شده برای موارد مربوط به یوتیوب و شرکا از بین خواهند رفت: 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 CONTENT_RATING_TIER_FAMILIES TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION : SENSITIVE_CATEGORY_EMBEDDED_VIDEO SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO گزینه‌های هدف‌گیری غروب آفتاب به‌طور خودکار از هدف‌گیری آیتم‌های خطی موجود حذف می‌شوند. این مقادیر همچنان برای استفاده در هدف‌گیری سطح تبلیغ‌کننده در دسترس خواهند بود. برای جلوگیری از هرگونه وقفه در سرویس، این هدف‌گیری را قبل از تاریخ انقضا از هرگونه آیتم موجود در خط YouTube & Partners حذف کنید.
فیلد publisherReviewStatuses در منابع خلاق	۲۶ ژوئن ۲۰۲۴	از تاریخ ۲۶ ژوئن ۲۰۲۴، فیلد publisherReviewStatuses از بین می‌رود و هنگام بازیابی منابع Creative خالی خواهد بود.
خرید مبتنی بر نتیجه	۱ آگوست ۲۰۲۳	در تاریخ ۱ آگوست ۲۰۲۳، سفارش‌های درج با استفاده از خرید مبتنی بر نتیجه، که توسط مقدار فیلد 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 بازگردانده نخواهند شد.
امکان فیلتر کردن درخواست‌های advertisers.lineItems.list بر اساس چهار فیلد اضافی	۲۱ ژوئن ۲۰۲۳	در ۲۱ ژوئن ۲۰۲۳، advertisers.lineItems.list دیگر از فیلتر کردن بر اساس فیلدهای زیر پشتیبانی نخواهد کرد: flight.triggerId targetedChannelId targetedNegativeKeywordListId warningMessages برای جلوگیری از وقفه در سرویس، تمام منطق فیلتر را با استفاده از این چهار فیلد قبل از ۲۱ ژوئن ۲۰۲۳ حذف کنید.
امکان فیلتر کردن یا مرتب‌سازی درخواست‌های لیست بر اساس فیلدهای budget.budget_segments. date_range.end_date و flight.dateRange.endDate تاریخ اولیه اجرا به‌روزرسانی شد	۲۱ ژوئن ۲۰۲۳	در تاریخ ۲۱ ژوئن ۲۰۲۳، فیلدهای budget.budget_segments. date_range.end_date و flight.dateRange.endDate دیگر به ترتیب در پارامترهای filter و query orderBy advertisers.insertionOrders.list و advertisers.lineItems.list پذیرفته نخواهند شد. پس از این تاریخ، درخواست‌هایی که از این فیلدها در پارامترهای query مربوط به filter و orderBy استفاده می‌کنند، خطا برمی‌گردانند. برای جلوگیری از وقفه در سرویس، قبل از ۲۱ ژوئن ۲۰۲۳، تمام منطق فیلتر و سفارش را با استفاده از این دو فیلد حذف کنید.
استفاده از عملگر OR بین محدودیت‌های فیلدهای مختلف در فیلترهای LIST تاریخ اولیه اجرا به‌روزرسانی شد	۲۱ ژوئن ۲۰۲۳	در ۲۱ ژوئن ۲۰۲۳، پارامترهای filter درخواست LIST دیگر اجازه استفاده از عملگرهای منطقی OR را بین محدودیت‌های فیلدهای مختلف نخواهند داد. برای مثال، منابعی که با رشته فیلتر lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR insertionOrderId="123" شناسایی شده‌اند، باید با استفاده از دو درخواست LIST با رشته‌های فیلتر زیر بازیابی شوند: lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" insertionOrderId="123" برای جزئیات بیشتر در مورد محدودیت‌های عملگرهای منطقی، به راهنمای ما در مورد فیلتر کردن درخواست‌های LIST مراجعه کنید. پارامترهای پرس و جوی filter تمام فراخوانی‌های LIST موجود خود را بررسی کنید و تأیید کنید که آنها قبل از ۲۱ ژوئن ۲۰۲۳ به درستی از عملگر منطقی OR استفاده می‌کنند تا از وقفه در سرویس جلوگیری شود.
محدودیت‌های سهمیه API موجود	۳۰ مه ۲۰۲۳	در تاریخ 30 مه 2023، محدودیت‌های استفاده موجود با یک ساختار سهمیه‌بندی ترکیبی جایگزین خواهد شد که موارد زیر را انجام می‌دهد: درخواست‌های روزانه به ازای هر سهمیه پروژه را حذف می‌کند. برای روش‌های واجد شرایط، به ازای هر تبلیغ‌کننده در هر پروژه، درخواست‌هایی را در هر دقیقه تعیین می‌کند. این محدودیت‌های جدید، انعطاف‌پذیری بیشتری در استفاده از API ایجاد کرده و امکان موازی‌سازی درخواست‌ها را در بین تبلیغ‌کنندگان فراهم می‌کند. جزئیات این تغییر در مستندات محدودیت سهمیه موجود ما موجود است.
انواع مخاطبان FirstAndThirdPartyAudience بر اساس فعالیت و سقف تکرار	۲۰ مه ۲۰۲۳	جدول زمانی: ۲۰ مه ۲۰۲۳: دیگر نمی‌توانید منابع FirstAndThirdPartyAudience با AudienceType برابر با ACTIVITY_BASED یا FREQUENCY_CAP را به هدف‌گیری مخاطب در سطر یا ترتیب درج اختصاص دهید. درخواست‌هایی که این مخاطبان را به هدف‌گیری مخاطب در یک سطر اختصاص می‌دهند، خطا برمی‌گردانند. این شامل درخواست‌های advertisers.lineItems.duplicate و advertisers.lineItems.generateDefault می‌شود، اگر سطر ایجاد شده شامل مخاطبان منسوخ شده در هدف‌گیری مخاطب خود باشد. ۸ ژوئن ۲۰۲۳: مخاطبان تحت تأثیر از تمام ردیف‌های هدف‌گیری و ترتیب درج و از تمام مخاطبان ترکیبی حذف خواهند شد. اگر یک ردیف در هنگام حذف این مخاطبان قادر به نمایش تبلیغات نباشد، تبلیغات متوقف می‌شوند. در این تاریخ، این مخاطبان دیگر با استفاده از سرویس firstAndThirdPartyAudiences قابل بازیابی نخواهند بود. وظایف پیشنهادی: توصیه می‌کنیم هنگام به‌روزرسانی‌های بعدی در هدف‌گذاری اقلام خطی خود، فوراً استفاده از مخاطبان تحت تأثیر را متوقف کنید. تمام مخاطبان تحت تأثیر را از ردیف‌های موجود و هدف‌گذاری ترتیب درج حذف کنید. در مورد به‌روزرسانی هدف‌گذاری مخاطبان، در راهنمای مخاطبان هدف ما بخوانید.
انواع برنامه‌های نصب‌شده و دستگاه‌های تلفن همراه جدید GoogleAudience	۲۰ مه ۲۰۲۳	جدول زمانی: ۲۰ مه ۲۰۲۳: دیگر نمی‌توانید منابع GoogleAudience با نوع GoogleAudienceType برابر با GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS یا GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES را به هدف‌گیری مخاطب در سطر یا ترتیب درج اختصاص دهید. درخواست‌هایی که این مخاطبان را به هدف‌گیری مخاطب در یک سطر اختصاص می‌دهند، خطا برمی‌گردانند. این شامل درخواست‌های advertisers.lineItems.duplicate و advertisers.lineItems.generateDefault می‌شود، اگر سطر ایجاد شده شامل مخاطبان منسوخ شده در هدف‌گیری مخاطب خود باشد. ۸ ژوئن ۲۰۲۳: مخاطبان تحت تأثیر از تمام ردیف‌های هدف‌گیری و ترتیب درج و از تمام مخاطبان ترکیبی حذف خواهند شد. اگر یک ردیف در هنگام حذف این مخاطبان قادر به نمایش تبلیغات نباشد، نمایش آنها متوقف خواهد شد. در این تاریخ، این مخاطبان نیز دیگر با استفاده از سرویس googleAudiences قابل بازیابی نخواهند بود. وظایف پیشنهادی: توصیه می‌کنیم هنگام به‌روزرسانی‌های بعدی در هدف‌گذاری اقلام خطی خود، فوراً استفاده از مخاطبان تحت تأثیر را متوقف کنید. تمام مخاطبان تحت تأثیر را از ردیف‌های موجود و هدف‌گذاری ترتیب درج حذف کنید. در مورد به‌روزرسانی هدف‌گذاری مخاطبان، در راهنمای مخاطبان هدف ما بخوانید.
محرک‌های دستی	۱۷ مه ۲۰۲۳	جدول زمانی: ۱۷ مه ۲۰۲۳: نمایش آیتم‌های خطی که از تریگرهای دستی استفاده می‌کنند در Display & Video 360 متوقف خواهد شد. اگر پس از این تاریخ تریگر دستی مرتبط با یک آیتم خطی فعال را فعال کنید، آن آیتم خطی تبلیغات نمایش نخواهد داد. ۱ آگوست ۲۰۲۳: سرویس advertisers.manualTriggers در DV360 API نسخه ۱ و ۲، مقدار enum LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER در DV360 API نسخه ۱ و فیلد LineItemFlight.triggerId در DV360 API نسخه ۱ غیرفعال خواهند شد. پس از این تاریخ، درخواست‌های ارسالی به این سرویس‌ها یا این فیلدها با خطا مواجه خواهند شد. اقدامات توصیه شده: فوراً استفاده از محرک‌های دستی برای شروع و توقف ارائه اقلام خطی را متوقف کنید. ارسال درخواست به سرویس advertisers.manualTriggers را متوقف کنید. فیلدهای flight.flightDateType و flight.triggerId را برای همه آیتم‌های خط با استفاده از triggerهای دستی به‌روزرسانی کنید.
گسترش هدف‌گیری	۲۵ مارس ۲۰۲۳	جایگزینی ویژگی گسترش هدف‌گیری با هدف‌گیری بهینه ، به تدریج از ۲۵ مارس ۲۰۲۳ تا اوایل مه ۲۰۲۳ ارائه شد. تغییرات مرتبط با Display & Video 360 API و رفتار Structured Data Files و همچنین اقدامات پیشنهادی در یک پست وبلاگ اعلام شد.