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

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

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

این صفحه تاریخ‌های منسوخ شدن و غروب آفتاب را برای نسخه‌های 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` `CONTENT_RATING_TIER_FAMILIES` `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` `False` BIDDING_STRATEGYO, `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED` یا `bidStrategy.performanceGoalAutoBid.performanceGoalType` تنظیم شده روی `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM` برای تنظیم `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` به‌روزرسانی کنید.