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

این صفحه تاریخ‌های منسوخ شدن و غروب آفتاب را برای نسخه‌های 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	جایگزینی ویژگی توسعه هدف با هدف‌یابی بهینه ، به تدریج از 25 مارس 2023 تا اوایل می 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 خالی خواهد بود.