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

این صفحه فهرستی از تاریخ‌های منسوخ شدن و پایان اعتبار نسخه‌های API و ویژگی‌های منحصر به فرد در Display & Video 360 API را ارائه می‌دهد.

تاریخ‌های انقضا و پایان پشتیبانی از API نیز در وبلاگ توسعه‌دهندگان گوگل ادز اعلام خواهد شد.

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

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

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

این جدول تمام نسخه‌های اصلی موجود رابط برنامه‌نویسی کاربردی Display & Video 360، تاریخ انتشار آنها و تاریخ انقضا و پایان عمر آنها را، در صورت اعلام، فهرست می‌کند.

نسخه API	تاریخ انتشار	تاریخ انقضا	تاریخ غروب آفتاب	راهنمای مهاجرت
نسخه ۴	۲۷ مارس ۲۰۲۵
نسخه ۳	۳۱ اکتبر ۲۰۲۳	۲ آوریل ۲۰۲۵	۷ اکتبر ۲۰۲۵	مهاجرت از نسخه ۳ به نسخه ۴
نسخه ۲	۶ دسامبر ۲۰۲۲	۱۵ فوریه ۲۰۲۴	۳ سپتامبر ۲۰۲۴	مهاجرت از نسخه ۲ به نسخه ۳
نسخه ۱	۹ مارس ۲۰۲۰	۱۳ مارس ۲۰۲۳	۱۴ سپتامبر ۲۰۲۳	مهاجرت از نسخه ۱ به نسخه ۲

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

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

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

ویژگی	تاریخ شروع به کار	توضیحات
مدیریت ترتیب درج و هدف‌گیری کمپین در Display & Video 360 API و فایل‌های داده ساختاریافته	۲۳ فوریه ۲۰۲۶	در ۲۳ فوریه ۲۰۲۶، Display & Video 360 ترتیب درج و هدف‌گیری کمپین را غیرفعال خواهد کرد. تغییراتی در API Display & Video 360 و فایل‌های داده ساختاریافته (SDF) ایجاد خواهد شد تا با این تغییر همسو شوند. در Display & Video 360 API، زیرمجموعه‌ای از متدها غیرفعال می‌شوند و در صورت فراخوانی خطا برمی‌گردانند. در SDF، ستون‌های هدف‌گیری در فایل‌های ترتیب درج و کمپین دیگر در هنگام دانلود پر نمی‌شوند و لازم است در هنگام آپلود خالی باشند. توصیه می‌شود کاربران هنگام ایجاد آیتم‌های خطی، هدف‌گیری را مستقیماً به آیتم‌های خطی اختصاص دهند. متدهای Display & Video 360 API زیر در صورت فراخوانی، خطای 404 را برمی‌گردانند: advertisers.campaigns.listAssignedTargetingOptions advertisers.campaigns.targetingTypes.assignedTargetingOptions.get advertisers.campaigns.targetingTypes.assignedTargetingOptions.list advertisers.insertionOrders.listAssignedTargetingOptions advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.create advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.delete advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.get advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.list advertisers.lineItems.generateDefault ورودی‌های SDF کمپین که مقادیری به ستون‌های زیر اختصاص داده باشند، در هنگام آپلود با شکست مواجه می‌شوند: Demographic Targeting Gender Demographic Targeting Age Demographic Targeting Household Income Demographic Targeting Parental Status Geography Targeting - Include Geography Targeting - Exclude Language Targeting - Include Language Targeting - Exclude Digital Content Labels - Exclude Brand Safety Sensitivity Setting Brand Safety Custom Settings Third Party Verification Services Third Party Verification Labels Viewability Targeting Active View Position Targeting - Display On Screen Position Targeting - Video On Screen Position Targeting - Display Position In Content Position Targeting - Video Position In Content Inventory Source Targeting - Authorized Seller Options Inventory Source Targeting - Include Inventory Source Targeting - Exclude Inventory Source Targeting - Target New Exchanges Environment Targeting ورودی‌های SDF مربوط به ترتیب درج که مقادیری به ستون‌های زیر اختصاص داده باشند، در هنگام آپلود با شکست مواجه می‌شوند: Geography Targeting - Include Geography Targeting - Exclude Proximity Targeting Proximity Location List Targeting Language Targeting - Include Language Targeting - Exclude Device Targeting - Include Device Targeting - Exclude Browser Targeting - Include Browser Targeting - Exclude Digital Content Labels - Exclude Brand Safety Sensitivity Setting Brand Safety Custom Settings Third Party Verification Services Third Party Verification Labels Channel Targeting - Include Channel Targeting - Exclude Site Targeting - Include Site Targeting - Exclude App Targeting - Include App Targeting - Exclude App Collection Targeting - Include App Collection Targeting - Exclude Category Targeting - Include Category Targeting - Exclude Content Genre Targeting - Include Content Genre Targeting - Exclude Keyword Targeting - Include Keyword Targeting - Exclude Keyword List Targeting - Exclude Audience Targeting - Include Audience Targeting - Exclude Affinity & In Market Targeting - Include Affinity & In Market Targeting - Exclude Custom List Targeting Inventory Source Targeting - Authorized Seller Options Inventory Source Targeting - Include Inventory Source Targeting - Exclude Inventory Source Targeting - Target New Exchanges Daypart Targeting Daypart Targeting Time Zone Environment Targeting Viewability Omid Targeting Enabled Viewability Targeting Active View Position Targeting - Display On Screen Position Targeting - Video On Screen Position Targeting - Display Position In Content Position Targeting - Video Position In Content Position Targeting - Audio Position In Content Video Player Size Targeting Content Duration Targeting Content Stream Type Targeting Audio Content Type Targeting Demographic Targeting Gender Demographic Targeting Age Demographic Targeting Household Income Demographic Targeting Parental Status Connection Speed Targeting Carrier Targeting - Include Carrier Targeting - Exclude
اعلام کنید که آیا موارد خط به تبلیغات سیاسی اتحادیه اروپا خدمت می‌کنند یا خیر	۸ سپتامبر ۲۰۲۵	از ۸ سپتامبر ۲۰۲۵، هنگام ایجاد یک ردیف آگهی جدید با استفاده از Display & Video 360 API یا SDFها، لازم است اعلام کنید که آیا آن ردیف آگهی، تبلیغات سیاسی اتحادیه اروپا را نمایش می‌دهد یا خیر. این اعلان‌ها را می‌توان به روش‌های زیر انجام داد: با استفاده از فیلد containsEuPoliticalAds در منبع LineItem API Display & Video 360. همچنین می‌توانید این اعلان را با استفاده از فیلدهای جدید در درخواست‌های advertisers.lineItems.duplicate و advertisers.lineItems.generateDefault انجام دهید. استفاده از ستون Contains EU Political Ads در نوع فایل SDF v9 Line Item . اگر تبلیغ‌کننده‌ی والد شما هیچ آیتم خطی که تبلیغات سیاسی اتحادیه‌ی اروپا را ارائه می‌دهد، نداشته باشد، می‌توانید با استفاده از فیلد containsEuPoliticalAds در منبع Display & Video 360 API Advertiser ، در سطح تبلیغ‌کننده اعلام کنید. اگر این فیلد روی DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING تنظیم شده باشد، به تمام آیتم‌های خطی جدید زیر تبلیغ‌کننده، در صورتی که مقدار دیگری مشخص نشده باشد، مقدار یکسانی اختصاص داده می‌شود و اگر مقداری از قبل تنظیم نشده باشد، تمام آیتم‌های خطی موجود زیر تبلیغ‌کننده برای استفاده از همان مقدار به‌روزرسانی می‌شوند. اعلان یک آیتم خطی را می‌توان در هر زمانی پس از ایجاد با استفاده از رابط کاربری، API یا SDF به‌روزرسانی کرد. اگر نمی‌توانید در سطح تبلیغ‌کننده اعلام کنید یا اعلام کرده‌اید که تبلیغات سیاسی اتحادیه اروپا ممکن است تحت عنوان تبلیغ‌کننده شما ارائه شود، برای جلوگیری از وقفه در سرویس، API و ادغام Display & Video 360 خود را قبل از ۸ سپتامبر ۲۰۲۵ به‌روزرسانی کنید: هنگام ایجاد درخواست advertisers.lineItems.create ، فیلد containsEuPoliticalAds را در یک منبع LineItem جدید تنظیم کنید. فیلد containsEuPoliticalAds را در بدنه درخواست هر درخواست advertisers.lineItems.duplicate و advertisers.lineItems.generateDefault تنظیم کنید. به نسخه ۹ فایل‌های داده ساختاریافته مهاجرت کنید و ستون Contains EU Political Ads را برای هر آیتم خط جدید در هنگام آپلود روی Yes یا No تنظیم کنید. برای دستورالعمل‌های گام به گام، به راهنمای مهاجرت نسخه ۹ ما مراجعه کنید. قبل از به‌روزرسانی هدف‌گذاری جغرافیایی برای یک آیتم خطی موجود با استفاده از Display & Video 360 API یا SDF، آیتم خطی را به‌روزرسانی کنید تا یک اعلان ارائه دهد.
تنظیمات دسته‌بندی محتوا برای یوتیوب و شرکایش	۱۲ ژوئن ۲۰۲۵	در ۱۲ ژوئن ۲۰۲۵، به عنوان بخشی از به‌روزرسانی تجربه تناسب برند ، پیکربندی‌های دسته‌بندی محتوا برای آیتم‌های خطی یوتیوب و شرکا دیگر در سطح قابل تغییر نخواهند بود. در عوض، تنظیمات دسته‌بندی محتوا صرفاً در سطح تبلیغ‌کننده کنترل می‌شوند. برای تطبیق با این تغییر، تغییرات زیر در API نمایش و ویدیو ۳۶۰ و فایل‌های داده ساختاریافته اعمال خواهد شد: فیلد contentCategory در اشیاء YoutubeAndPartnersSettings از منابع YouTube & partners LineItem دیگر به‌روزرسانی نخواهد شد. این فیلد در تاریخ بعدی به‌طور کامل حذف خواهد شد. ستون TrueView Content Filter در SDFهای آیتم خطی دیگر قابل نوشتن نخواهد بود. برای جلوگیری از هرگونه وقفه در سرویس: هنگام بررسی موارد خطی YouTube & partners در API، فیلد effectiveContentCategory را به جای فیلد contentCategory بازیابی کنید. هنگام به‌روزرسانی ورودی‌های سطر SDF ، تغییر ستون TrueView Content Filter را متوقف کنید. هنگام ایجاد سطرهای جدید، ستون را خالی نگه دارید.
به‌روزرسانی‌های بودجه ردیف‌های بودجه با بهینه‌سازی ترتیب درج	۱۲ ژوئن ۲۰۲۵	از ۱۲ ژوئن ۲۰۲۵، دیگر نمی‌توانید تنظیمات بودجه را برای ردیف‌هایی که سفارش‌های درج والد روی بهینه‌سازی با استفاده از استراتژی‌های پیشنهاد قیمت خودکار تنظیم شده‌اند، به‌روزرسانی کنید. برای جلوگیری از هرگونه وقفه در سرویس: در API: بررسی کنید که آیا InsertionOrder والد یک آیتم خطی، دارای bidStrategy.maximizeSpendAutoBid یا bidStrategy.performanceGoalAutoBid تنظیم شده است یا خیر. در این صورت، سعی نکنید فیلد بودجه LineItem را با استفاده از advertisers.lineItems.patch به‌روزرسانی کنید. در SDF: بررسی کنید که آیا ستون Insertion Order Optimization ورودی SDF مربوط به ردیف آیتم، روی TRUE تنظیم شده است یا خیر. در این صورت، سعی نکنید ستون‌های Budget Type یا Budget Amount را برای ردیف آیتم SDF به‌روزرسانی کنید.
محدودیت‌های سایت برای فایل‌های داده ساختاریافته	۱۲ ژوئن ۲۰۲۵	از ۱۲ ژوئن ۲۰۲۵، محدودیت موجود برای URLهای هدف‌گذاری‌شده در ورودی‌های SDF که مانع از گنجاندن سایت‌های جدیدتر می‌شد را حذف خواهیم کرد. در عوض، SDF رفتار API و UI را مطابقت می‌دهد و امکان هدف‌گیری URLها را تا زمانی که به درستی قالب‌بندی شده باشند، فراهم می‌کند. این مربوط به ستون‌های Site Targeting - Include و Site Targeting - Exclude در فایل‌های «ترتیب درج» و «مورد سطر» است.
ستون «ضرایب پیشنهاد قیمت» در فایل‌های داده ساختاریافته ردیف کالا	۱ مه ۲۰۲۵	در تاریخ ۱ مه ۲۰۲۵، ورودی‌های موجود در فایل‌های داده ساختاریافته‌ی اقلام خطی که سعی در تنظیم ستون «ضرایب پیشنهاد قیمت» دارند، در هنگام آپلود فایل، قادر به ایجاد یا به‌روزرسانی منبع نخواهند بود.
برای اقلام خط تولید تقاضا در فایل‌های داده ساختاریافته، به منبع موجودی شریک ویدیویی نیاز است.	۲۲ آوریل ۲۰۲۵	از ۲۲ آوریل ۲۰۲۵، شما ملزم خواهید بود که مقدار «Video Partners» را در ستون TrueView Inventory Source Targeting برای ورودی‌های ردیف آیتم‌هایی که مقدار ستون Type آنها «Demand Gen» است، وارد کنید. پس از شروع این الزام، مقدار برای ردیف آیتم‌های موجود دوباره پر می‌شود و هنگام دانلود فایل‌های داده ساختاریافته جدید نیز لحاظ می‌گردد. برای جلوگیری از هرگونه وقفه در سرویس: ادغام خود را به‌روزرسانی کنید تا مقدار «شرکای ویدیویی» در تمام ورودی‌های ردیف Demand Gen لحاظ شود. ادغام خود را برای مدیریت منابع موجودی Demand Gen در سطح گروه تبلیغاتی با استفاده از ستون‌های گروه تبلیغاتی SDF نسخه ۸.۱ با عنوان‌های Demand Gen Inventory Source Strategy و Demand Gen Enabled Inventory Sources به‌روزرسانی کنید.
کمپین‌های اکشن ویدیویی در فایل‌های داده ساختاریافته	۲۲ آوریل ۲۰۲۵	در ۲۲ آوریل ۲۰۲۵، دیگر نمی‌توانید با استفاده از فایل‌های داده ساختاریافته (Structured Data Files)، آیتم‌های خطی (Line Items) برای کمپین‌های اکشن ویدیویی ایجاد کنید، زیرا این فایل‌ها به Demand Gen ارتقا می‌یابند. ورودی‌های آیتم خطی که سعی می‌کنند با مقدار ستون Subtype با "Action" و مقدار ستون Type برابر با "TrueView" آپلود شوند، با شکست مواجه خواهند شد. برای جلوگیری از هرگونه وقفه در سرویس، ادغام خود را به‌روزرسانی کنید تا به جای کمپین‌های اکشن ویدیویی، از Demand Gen استفاده کنید.
مدت زمان عضویت نامحدود برای مخاطبان شخص اول	۷ آوریل ۲۰۲۵	در ۷ آوریل ۲۰۲۵، منابع FirstAndThirdPartyAudience دیگر اجازه مدت زمان عضویت نامحدود مخاطبان را نخواهند داد. درخواست‌های firstAndThirdPartyAudiences.create و firstAndThirdPartyAudiences.patch که مقدار فیلد membershipDurationDays را روی ۱۰۰۰۰ تنظیم می‌کنند، خطای 400 را برمی‌گردانند. مخاطبان فعلی که مقدار فیلد membershipDurationDays آنها ۱۰۰۰۰ است، به ۵۴۰ به‌روزرسانی می‌شوند و مدت زمان عضویت جدید به صورت عطف به ماسبق برای عضویت‌های موجود اعمال می‌شود. این کار باعث می‌شود تمام عضویت‌های قدیمی‌تر از ۵۴۰ روز منقضی شوند. برای جلوگیری از هرگونه وقفه در سرویس: تأیید کنید که ادغام شما مقدار فیلد membershipDurationDays مخاطبان جدید یا موجود را روی ۱۰۰۰۰ تنظیم نمی‌کند. عضویت‌های مخاطبان Customer Match فعلی خود را با استفاده از firstAndThirdPartyAudiences.editCustomerMatchMembers به‌روزرسانی کنید. مرتباً فهرست مخاطبان Customer Match خود را به‌روزرسانی کنید تا مطمئن شوید که اندازه فهرست مخاطبان شما ناخواسته کوچک‌تر نمی‌شود. در نسخه ۴، این تغییر در منابع FirstPartyAndPartnerAudience منعکس شده است.
الگوریتم مناقصه سفارشی و فعالیت‌های نورافکن نامتناسب	۱ آوریل ۲۰۲۵	در ۱ آوریل ۲۰۲۵: درخواست‌های advertisers.lineItems.create که سعی در تنظیم فیلد floodlightActivityConfigs از شیء ConversionCountingConfig و فیلد customBiddingAlgorithmId از اشیاء MaximizeSpendBidStrategy یا PerformanceGoalBidStrategy دارند و از فعالیت‌های منطبق با floodlight استفاده نمی‌کنند، خطای 400 را برمی‌گردانند. درخواست‌های advertisers.lineItems.patch که سعی در به‌روزرسانی فیلد floodlightActivityConfigs از شیء ConversionCountingConfig دارند، در حالی که فیلد customBiddingAlgorithmId از اشیاء MaximizeSpendBidStrategy یا PerformanceGoalBidStrategy تنظیم شده است، خطای 400 را برمی‌گردانند. ورودی‌های موجود در فایل‌های داده ساختاریافته‌ی آیتم‌های خطی که سعی در به‌روزرسانی ستون «شناسه‌های فعالیت نورافکن تبدیل» هنگام تنظیم ستون «شناسه الگوریتم» دارند، هنگام بارگذاری فایل به‌روزرسانی نخواهند شد. درخواست‌های customBiddingAlgorithms.patch ، customBiddingAlgorithms.rules.create برای منابع CustomBiddingAlgorithm که به یک آیتم خط اختصاص داده می‌شوند customBiddingAlgorithms.scripts.create خطا برمی‌گردانند. برای جلوگیری از هرگونه وقفه در سرویس، ادغام خود را به موارد زیر به‌روزرسانی کنید: تأیید کنید که فعالیت‌های مربوط به نورپردازی، قبل یا همزمان با اختصاص الگوریتم مناقصه سفارشی، به یک آیتم خطی اختصاص داده شده‌اند. الگوریتم‌های مناقصه سفارشی موجود، قبل از تلاش برای به‌روزرسانی، از تمام اقلام ردیف تخصیص داده نمی‌شوند.

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

برای مطالعه‌ی موارد منسوخ‌شده‌ی اعلام‌شده که بر نسخه‌های منسوخ‌شده‌ی رابط برنامه‌نویسی کاربردی Display & Video 360 تأثیر می‌گذارند، به موارد منسوخ‌شده‌ی بایگانی‌شده‌ی ما مراجعه کنید.