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

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

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

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

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

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

הטבלה שבהמשך מפרטת את כל הפלטפורמות המרכזיות הקיימות לרשת המדיה & גרסאות 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. שינויים רלוונטיים ברשת המדיה וב- בפוסט בבלוג הוכרזו ההתנהגות של Video 360 API וקובצי נתונים מובנים, כמו גם הפעולות המומלצות.
טריגרים ידניים	17 במאי 2023	קו זמן‬ 17 במאי 2023: פריטים שהוגדרו להם טריגרים ידניים יפסיקו להופיע ברשת המדיה וידאו 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, פרמטרים של filter בבקשת LIST לא יאפשרו יותר להשתמש באופרטורים לוגיים של 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 כברירת מחדל.
שדה publisherReviewStatuses במשאבי קריאייטיב	‫26 ביוני 2024	החל מ-26 ביוני 2024, השדה publisherReviewStatuses יצא משימוש והוא יהיה ריק בזמן אחזור משאבים של Creative.
קבוצת משנה של טירגוט לפי תוכן ב-YouTube פריטים של שותפים	30 בספטמבר 2024	ב-30 בספטמבר 2024, הערכים הבאים של המאפיין סוגי הטירגוט יוצאו משימוש ב-YouTube פריטים של שותפים: 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 TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION: SENSITIVE_CATEGORY_EMBEDDED_VIDEO SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO אפשרויות טירגוט קיימות יוסרו באופן אוטומטי מהטירגוט הקיים של פריטים. כדי למנוע שיבושים בשירות, צריך להסיר את הטירגוט הזה מכל הפלטפורמות הקיימות ב-YouTube וגם פריטים של שותפים לפני תאריך הסגירה.
קהלים של צד ראשון וצד שלישי ב-Oracle	30 בספטמבר 2024	ב-30 בספטמבר 2024, נוציא משימוש את מקורות המשאבים של FirstAndThirdPartyAudience מ-Oracle. אחרי הסגירה, הקהלים האלה יוסרו מכל טירגוט קיים לפי משאבים וקהל משולב. אם פריט מסוים מטרגט רק קהלים שנסגרו או מטרגט לרעה קהלים שנסגרו, העדכון הזה ישהה אוטומטית את הפריט הזה. כדי למנוע שיבושים בשירות, צריך לזהות ולהסיר קהלים של Oracle מהטירגוט לפי קהל קיים של פריט ומקהלים משולבים לפני תאריך הסגירה.
אופטימיזציית טירגוט של פריט לקבוצת משנה של שיטות בידינג	30 בספטמבר 2024	ב-30 בספטמבר 2024, לא תהיה יותר אפשרות להשתמש באופטימיזציית טירגוט במשאבים ב-LineItem שהוגדרו להם קבוצת משנה של שיטות בידינג. בעקבות השינוי הזה, ב-LineItem משאבים שמוגדרים לערך BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM targetingExpansion.enableOptimizedTargeting מוגדר לערך BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA ו-bidStrategy.maximizeSpendAutoBid.performanceGoalType לערך BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA, BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN או BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED או bidStrategy.performanceGoalAutoBid.performanceGoalType BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM יעודכנו כך שtargetingExpansion.enableOptimizedTargeting False.True כדי למנוע שיבושים בשירות, יש לעדכן ולוודא שאופטימיזציית טירגוט לא מופעלת בפריטים שבהם נעשה שימוש בשיטות הבידינג האלה.
טיסה בהקדם האפשרי Pacing להזמנות קמפיין	5 בנובמבר 2024	ב-5 בנובמבר 2024, מערכת PACING_TYPE_ASAP לא תתאים יותר ל-PACING_PERIOD_FLIGHT כשתגדירו את השדה של הזמנת הקמפיין pacing. המאפיין pacingType של כל הזמנות הקמפיין הקיימות עם ההגדרה הזו יעודכן ל-PACING_TYPE_AHEAD. כדי למנוע שיבושים בשירות, יש לעדכן את pacing של הזמנות הקמפיין הקיימות באמצעות PACING_TYPE_ASAP ו-PACING_PERIOD_FLIGHT.