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

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

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

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

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

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

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

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

פיצ'רים שיצאו משימוש

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

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

תכונה	מועד הכניסה לתוקף הראשוני	תיאור
הרחבת הטירגוט	25 במרץ 2023	החלפה של התכונה הרחבת הטירגוט באופטימיזציית טירגוט שהשקנו בהדרגה מ-25 במרץ 2023 עד תחילת מאי 2023. בפוסט בבלוג נכתב על שינויים רלוונטיים ב-Display & Video 360 API ובהתנהגות של קובצי נתונים מובְנים, וכן על פעולות מומלצות.
טריגרים ידניים	17 במאי 2023	ציר הזמן: 17 במאי 2023: פריטים שנעשה בהם שימוש בטריגרים ידניים יפסיקו להופיע ב-Display & Video 360. אם תפעילו טריגר ידני שמקושר לפריט פעיל אחרי התאריך הזה, הפריט לא יציג מודעות. 1 באוגוסט 2023: השירות advertisers.manualTriggers ב-DV360 API v1 ו-v2, LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER טיפוסים בני מנייה (enum) ב-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, LIST פרמטרים של בקשה filter לא יאפשרו יותר OR להשתמש בהגבלות לוגיות בין שדות שונים. לדוגמה, משאבים שמזוהים באמצעות מחרוזת המסנן lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR insertionOrderId="123" חייבים להיות מאוחזרים במקום זאת באמצעות שתי בקשות LIST עם מחרוזות הסינון הבאות: lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" insertionOrderId="123" במדריך שלנו בנושא סינון בקשות של LIST אפשר לקרוא פרטים נוספים על ההגבלות של אופרטורים לוגיים. לפני 21 ביוני 2023, עליך לבדוק את הפרמטרים של השאילתה filter בכל הקריאות הקיימות של LIST ולוודא שנעשה שימוש תקין באופרטור OR כדי למנוע שיבושים בשירות.
יכולת לסנן בקשות או לסדר אותן לפי השדות 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 כברירת מחדל.