הודעה על הוצאה משימוש

בדף הזה מפורטים תאריכי ההוצאה משימוש וההפסקה של גרסאות API ותכונות ספציפיות ב-Display & Video 360 API.

הודעות על הוצאה משימוש ותאריכי סגירה של ה-API יפורסמו גם בבלוג למפתחים של Google Ads.

הוצאה משימוש של גרסאות

גרסאות ה-API של Display & Video 360 יוצאות לשוק, מוצאות משימוש ומוצאות מכלל שימוש באופן קבוע. השלבים האלה מוגדרים כך:

• גרסה: הגרסה לא נמצאת יותר בשלב אלפא או בטא, והיא נחשבת ליציבה. יכול להיות שעדיין נשיק תכונות חדשות לגרסה.
• הוצאה משימוש: הגרסה יוצאת משימוש ומוכרז תאריך סיום התמיכה (ביטול). המשתמשים צריכים לעבור לגרסה חדשה יותר לפני תאריך הוצאת הגרסה משימוש. לא נשיק יותר תוספות של תכונות לגרסה הזו.
• הוצאה משימוש: הגרסה לא נתמכת יותר. בקשות שנשלחות לגרסה הזו מחזירות שגיאה.

בטבלה הזו מפורטות כל הגרסאות הקיימות של ליבת Display & Video 360 API, תאריכי ההשקה שלהן, ותאריכי ההוצאה משימוש וההפסקה שלהן, אם הם פורסמו.

גרסת API	תאריך פרסום	תאריך הפסקת התמיכה	תאריך ההוצאה משימוש	מדריך להעברת נתונים (מיגרציה)
v4	‫27 במרץ 2025
v3	‫31 באוקטובר 2023	‫2 באפריל 2025	‫7 באוקטובר 2025	העברה מגרסה 3 לגרסה 4
v2	‫6 בדצמבר 2022	‫15 בפברואר 2024	‫3 בספטמבר 2024	מעבר מגרסה 2 לגרסה 3
v1	9 במרץ 2020	‫13 במרץ 2023	‫14 בספטמבר 2023	מעבר מגרסה 1 לגרסה 2

הוצאה משימוש של תכונות

כדאי לעקוב אחרי הבלוג למפתחים של Google Ads כדי לקבל הודעות על הוצאה משימוש של תכונות חשובות בעתיד.

בטבלה הזו מפורטות כל ההוצאות משימוש של תכונות שמשפיעות על גרסאות פעילות, כולל מועד כניסה לתוקף ותיאור של ההוצאה משימוש, עם המלצות לפעולות וקישורים למסמכים רלוונטיים:

תכונה	מועד הכניסה הראשוני לתוקף	תיאור
ניהול טירגוט של הזמנות וקמפיינים ב-Display & Video 360 API ובקבצים של נתונים מובנים	‫23 בפברואר 2026	ב-23 בפברואר 2026, נסיים את התמיכה בטירגוט של הזמנות וקמפיינים ב-Display & Video 360. יבוצעו שינויים ב-Display & Video 360 API ובקבצים של נתונים מובְנים (SDF) כדי להתאים לשינוי הזה. ב-Display & Video 360 API, חלק מהשיטות יצאו משימוש ויחזירו שגיאה אם יתבצע ניסיון להפעיל אותן. ב-SDF, עמודות הטירגוט בקבצים Insertion Order ו-Campaign לא יאוכלסו יותר בהורדה, ונדרש שהן יהיו ריקות בהעלאה. מומלץ למשתמשים להקצות טירגוט ישירות לפריטי קמפיין בזמן יצירת פריטי הקמפיין. השיטות הבאות ב-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
הצהרה לגבי הצגת מודעות שקשורות לפוליטיקה באיחוד האירופי בפריטי מידע	‫8 בספטמבר 2025	החל מ-8 בספטמבר 2025, כשתיצרו פריט חדש באמצעות Display & Video 360 API או קובצי SDF, תצטרכו להצהיר אם הפריט ישמש להצגת מודעות שקשורות לפוליטיקה באיחוד האירופי. אפשר להצהיר על כך בדרכים הבאות: שימוש בשדה containsEuPoliticalAds במשאב LineItem של Display & Video 360 API. אפשר גם להצהיר על כך באמצעות שדות חדשים בבקשות advertisers.lineItems.duplicate ו-advertisers.lineItems.generateDefault. שימוש בעמודה Contains EU Political Ads בסוג הקובץ Line Item (פריט) ב-SDF גרסה 9. אם חשבון המפרסם ההורה שלכם לא יכלול פריטי הזמנה שיציגו מודעות שקשורות לפוליטיקה באיחוד האירופי, תוכלו להצהיר על כך ברמת המפרסם באמצעות השדה containsEuPoliticalAds במשאב Advertiser של Display & Video 360 API. אם השדה הזה מוגדר לערך DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING, כל הפריטים החדשים להזמנת פרסום שמשויכים למפרסם יקבלו את אותו הערך אם לא צוין ערך אחר, וכל הפריטים הקיימים להזמנת פרסום שמשויכים למפרסם יעודכנו כך שישתמשו באותו הערך אם עדיין לא הוגדר ערך. אפשר לעדכן את ההצהרה של פריט קו בכל שלב אחרי היצירה שלו באמצעות ממשק המשתמש, ה-API או SDF. אם אתם לא יכולים להצהיר ברמת המפרסם או שהצהרתם שאפשר להציג מודעות שקשורות לפוליטיקה באיחוד האירופי בחשבון המפרסם שלכם, אתם צריכים לעדכן את השילוב של Display & Video 360 API ו-SDF לפני 8 בספטמבר 2025 כדי למנוע שיבושים בשירות: מגדירים את השדה containsEuPoliticalAds במשאב LineItem חדש כששולחים בקשת advertisers.lineItems.create. מגדירים את השדה containsEuPoliticalAds בגוף הבקשה של כל בקשות advertisers.lineItems.duplicate ו-advertisers.lineItems.generateDefault. מעבירים לשימוש בקבצים של נתונים מובְנים בגרסה 9 ומגדירים את העמודה Contains EU Political Ads לערך Yes או No בכל פריט חדש להעלאה. הוראות מפורטות זמינות במדריך להעברת נתונים לגרסה 9. לפני שמעדכנים את הטירגוט הגיאוגרפי של פריט קיים באמצעות Display & Video 360 API או SDF, צריך לעדכן את הפריט כדי לספק הצהרה.
הגדרות של קטגוריות תוכן לפריטי YouTube ושותפים	‫12 ביוני 2025	ב-12 ביוני 2025, לא יהיה יותר אפשר לשנות את ההגדרות של קטגוריות תוכן לפריטים ספציפיים של YouTube והשותפים. זאת במסגרת עדכון של חוויית השימוש בתאימות למותג. במקום זאת, ההגדרות של קטגוריות התוכן ינוהלו רק ברמת המפרסם. כדי להתאים את עצמנו לשינוי הזה, נבצע את השינויים הבאים ב-API של Display & Video 360 ובקבצים של נתונים מובנים: השדה contentCategory באובייקטים YoutubeAndPartnersSettings של משאבי YouTube והשותפים LineItem לא יעודכן יותר. בעתיד נסיר אותו לחלוטין. העמודה TrueView Content Filter בגיליונות SDF של פריט לא תהיה יותר ניתנת לכתיבה. כדי למנוע שיבושים בשירות: כשבודקים פריטים של YouTube והשותפים ב-API, צריך לאחזר את השדה effectiveContentCategory במקום השדה contentCategory. כשמעדכנים רשומות של פריט SDF, מפסיקים לשנות את העמודה TrueView Content Filter. כשיוצרים פריטים חדשים, משאירים את העמודה ריקה.
עדכונים בתקציב של פריטים עם אופטימיזציה של הזמנות קמפיין	‫12 ביוני 2025	החל מ-12 ביוני 2025, לא תהיה יותר אפשרות לעדכן את הגדרות התקציב של פריטי קמפיין עם הזמנות להצגת מודעות ברמת ההורה שהוגדרו לאופטימיזציה באמצעות שיטות בידינג אוטומטיות. כדי למנוע הפרעות בשירות: ב-API: בודקים אם להורה InsertionOrder של פריט מסוים בשורה מוגדר הערך bidStrategy.maximizeSpendAutoBid או bidStrategy.performanceGoalAutoBid. אם כן, אל תנסו לעדכן את שדה התקציב של LineItem באמצעות advertisers.lineItems.patch. ב-SDF: בודקים אם הערך בעמודה Insertion Order Optimization של הזמנת קמפיין של פריט מסוים מוגדר כ-TRUE. אם כן, אל תנסו לעדכן את העמודות Budget Type או Budget Amount של רשומת ה-SDF של פריט הקו.
הגבלות באתרים לגבי קבצים של נתונים מובנים	‫12 ביוני 2025	החל מ-12 ביוני 2025, נסיר הגבלה קיימת על כתובות URL שמטורגטות ברשומות SDF, שהגבילה את האפשרות לכלול אתרים חדשים יותר. במקום זאת, SDF יתאים להתנהגות של ה-API וממשק המשתמש ויאפשר טירגוט של כתובות URL כל עוד הפורמט שלהן נכון. המידע הזה רלוונטי לעמודות Site Targeting - Include ו-Site Targeting - Exclude בקבצים Insertion Order ו-Line Item.
העמודה 'הצעות מחיר מוכפלות' בקבצים של נתונים מובנים של פריטי מידע	‫1 במאי 2025	החל מ-1 במאי 2025, ניסיונות להגדיר את העמודה 'הצעות מחיר מוכפלות' ברשומות בפריט קו בקובצי נתונים מובנים ייכשלו, ולא יתבצעו יצירה או עדכון של משאב בהעלאת קובץ.
חובה לציין מקור מלאי שטחי פרסום של שותפי וידאו בפריטים מקמפיינים ליצירת ביקוש בקובצי נתונים מובנים	‫22 באפריל 2025	החל מ-22 באפריל 2025, תהיה חובה לכלול את הערך Video Partners (שותפי וידאו) בעמודה TrueView Inventory Source Targeting של רשומות פריט עם ערך של Demand Gen (יצירת ביקוש) בעמודה Type. אחרי שהאכיפה תתחיל, המערכת תמלא את הערך באופן אוטומטי עבור פריטים קיימים ותכלול אותו בהורדה של קובצי נתונים מובְנים חדשים. כדי למנוע שיבושים בשירות: צריך לעדכן את השילוב כך שיכלול את הערך Video Partners (שותפי וידאו) בכל הרשומות של הפריטים מקמפיינים ליצירת ביקוש. כדי לנהל את מקורות מלאי שטחי הפרסום בקמפיינים ליצירת ביקוש ברמת קבוצת המודעות, צריך לעדכן את השילוב באמצעות העמודות Demand Gen Inventory Source Strategy ו-Demand Gen Enabled Inventory Sources של קבוצת מודעות ב-SDF בגרסה 8.1.
קמפיינים של מודעות וידאו עם קריאה לפעולה בקובצי נתונים מובנים	‫22 באפריל 2025	החל מ-22 באפריל 2025, לא תהיה יותר אפשרות ליצור פריטים מקמפיינים של מודעות וידאו עם קריאה לפעולה באמצעות קובצי נתונים מובנים, כי הם ישודרגו לקמפיינים ליצירת ביקוש. ניסיונות להעלות רשומות של פריטים מקמפיינים עם ערך של 'פעולה' בעמודה Subtype וערך של TrueView בעמודה Type ייכשלו. כדי למנוע שיבושים בשירות, צריך לעדכן את השילוב כך שישתמש בקמפיינים ליצירת ביקוש במקום בקמפיינים של מודעות וידאו עם קריאה לפעולה.
משך חברות בלתי מוגבל בקהלים מאינטראקציה ישירה	‫7 באפריל 2025	החל מ-7 באפריל 2025, לא תהיה יותר אפשרות להגדיר משך חברות בלתי מוגבל בקהלים במשאבי FirstAndThirdPartyAudience. בקשות firstAndThirdPartyAudiences.create ו-firstAndThirdPartyAudiences.patch להגדרת הערך 10,000 בשדה membershipDurationDays יחזירו שגיאה 400. קהלים קיימים עם ערך השדה membershipDurationDays של 10,000 יעודכנו ל-540, ומשך החברות החדש יוחל רטרואקטיבית על חברויות קיימות. כל החברים בקהל שנוספו לפני יותר מ-540 ימים יוסרו. כדי למנוע שיבושים בשירות: מוודאים שהשדה membershipDurationDays של קהלים חדשים או קיימים לא מוגדר לערך 10,000 בשילוב. רענון של החברים בקהלים הקיימים של התאמה ללקוחות באמצעות firstAndThirdPartyAudiences.editCustomerMatchMembers. מומלץ לעדכן בקביעות את החברות בקהלים עם התאמה ללקוחות, כדי לוודא שגודל הרשימה של הקהלים לא יקטן בטעות. בגרסה 4, השינוי הזה משתקף במשאבי FirstPartyAndPartnerAudience.
אלגוריתם של בידינג בהתאמה אישית ופעילויות ב-Floodlight שלא תואמים	‫1 באפריל 2025	ב-1 באפריל 2025: בקשות advertisers.lineItems.create שמנסות להגדיר את השדה floodlightActivityConfigs של האובייקט ConversionCountingConfig ואת השדה customBiddingAlgorithmId של האובייקטים MaximizeSpendBidStrategy או PerformanceGoalBidStrategy שלא משתמשים בפעילויות תואמות של Floodlight יחזירו שגיאה 400. בקשות advertisers.lineItems.patch שמנסות לעדכן את השדה floodlightActivityConfigs של האובייקט ConversionCountingConfig בזמן שהשדה customBiddingAlgorithmId של האובייקטים MaximizeSpendBidStrategy או PerformanceGoalBidStrategy מוגדר, יחזירו שגיאה 400. ניסיונות לעדכן את העמודה 'מזהי פעילות המרה ב-Floodlight' בקובצי נתונים מובנים של פריט הזמנה כשהעמודה 'מזהה אלגוריתם' מוגדרת ייכשלו כשמעלים את הקובץ. בקשות customBiddingAlgorithms.patch, ‏ customBiddingAlgorithms.rules.create ו-customBiddingAlgorithms.scripts.create למשאבי CustomBiddingAlgorithm שמוקצים לפריט קו, יחזירו שגיאה. כדי למנוע שיבושים בשירות, צריך לעדכן את השילוב ל: מוודאים שפעילויות ה-Floodlight הרלוונטיות משויכות לפריט לפני או בזמן השיוך של אלגוריתם בידינג בהתאמה אישית. לפני שמנסים לעדכן אלגוריתמים קיימים של בידינג בהתאמה אישית, הם מבוטלים מכל פריטי הקמפיין.

הוצאה משימוש של תכונות קודמות

כדי לקרוא על הפסקות תמיכה שהוכרזו והשפיעו על גרסאות של Display & Video 360 API שהוצאו משימוש, אפשר לעיין בארכיון הפסקות התמיכה.