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

בדף הזה מפורטים תאריכי ההוצאה משימוש והסגירה של 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`.