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

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

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

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

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

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

בטבלה הזו מפורטות כל הגרסאות הקיימות של 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 כדי לקבל הודעות על הוצאה משימוש של תכונות חשובות בעתיד.

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

תכונה מועד הכניסה לתוקף הראשוני תיאור
ערכים של שם העסק והלוגו שנדרשים למודעות רספונסיביות ב-YouTube

מועד הכניסה לתוקף הראשוני עודכן

ינואר 2027

בינואר 2027, נכסים של שם העסק ולוגו העסק יהיו נדרשים במודעות רספונסיביות ב-YouTube אם לא הוגדר ערך ברירת מחדל למפרסם.

כתוצאה מכך, אם לא הוקצו ערכי ברירת מחדל למפרסם הראשי, צריך להגדיר את העמודות Business Name ו-Logo Asset IDs בקובצי SDF של מודעות למודעות מסוג "רספונסיבית". אם מוקצה ערך ברירת מחדל והעמודה נשארת ריקה, המודעה תירש את ערכי ברירת המחדל ברמת המפרסם לאחר השמירה.

הוצאה משימוש של החרגת קטגוריות רגישות ‫1 באוקטובר 2026

החל מ-1 באוקטובר 2026, לא תהיה יותר אפשרות להחריג את רוב הקטגוריות הרגישות כשמגדירים טירגוט של פריטים. כדי להתאים את המערכת לשינוי הזה, נבצע את השינויים הבאים ב-Display & Video 360 API ובקובצי נתונים מובְנים:

  • ערכי ה-enum הבאים של SensitiveCategory יוצאו משימוש ולא יתקבלו יותר בשדה excludedSensitiveCategory של האובייקט SensitiveCategoryAssignedTargetingOptionDetails כשמקצים טירגוט מסוג TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION:
    • SENSITIVE_CATEGORY_ADULT
    • SENSITIVE_CATEGORY_ALCOHOL
    • SENSITIVE_CATEGORY_DEROGATORY
    • SENSITIVE_CATEGORY_DOWNLOADS_SHARING
    • SENSITIVE_CATEGORY_DRUGS
    • SENSITIVE_CATEGORY_GAMBLING
    • SENSITIVE_CATEGORY_POLITICS
    • SENSITIVE_CATEGORY_PROFANITY
    • SENSITIVE_CATEGORY_RELIGION
    • SENSITIVE_CATEGORY_SENSITIVE_SOCIAL_ISSUES
    • SENSITIVE_CATEGORY_SHOCKING
    • SENSITIVE_CATEGORY_SUGGESTIVE
    • SENSITIVE_CATEGORY_TOBACCO
    • SENSITIVE_CATEGORY_TRAGEDY
    • SENSITIVE_CATEGORY_TRANSPORTATION_ACCIDENTS
    • SENSITIVE_CATEGORY_VIOLENCE
    • SENSITIVE_CATEGORY_WEAPONS
  • העמודה Brand Safety Sensitivity Setting בקובצי SDF של פריטים לא תאפשר יותר את האפשרות "שימוש בהתאמה אישית".
  • העמודה Brand Safety Custom Settings בקובצי SDF של פריטים לא תהיה נתמכת יותר, ותאוכלס בערך ריק בזמן ההורדה.
הוצאה משימוש של החרגת תוויות התאמת תוכן דיגיטלי לקהל ‫1 באוקטובר 2026

החל מ-1 באוקטובר 2026, לא תהיה יותר אפשרות להחריג תוויות ספציפיות של התאמת תוכן דיגיטלי לקהל באמצעות טירגוט. כדי להתאים את המערכת לשינוי הזה, נבצע את השינויים הבאים ב-Display & Video 360 API ובקובצי נתונים מובְנים:

  • ערכי ה-enum הבאים של ContentRatingTier יוצאו משימוש ולא יתקבלו יותר בשדה excludedContentRatingTier של האובייקט DigitalContentLabelAssignedTargetingOptionDetails כשמקצים טירגוט מסוג TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION:
    • CONTENT_RATING_TIER_FAMILIES
    • CONTENT_RATING_TIER_GENERAL
    • CONTENT_RATING_TIER_MATURE
    • CONTENT_RATING_TIER_PARENTAL_GUIDANCE
    • CONTENT_RATING_TIER_TEENS
    • CONTENT_RATING_TIER_UNSPECIFIED
  • בעמודה Digital Content Labels - Exclude בקובצי SDF של פריטים, אפשר להקצות רק את האפשרות "?". אחרת, העמודה חייבת להיות ריקה. אם תנסו להקצות ערך אחר, תופיע שגיאה בזמן ההעלאה.
‫Nielsen כספק חיצוני למדידת התחזקות המותג ‫13 ביולי 2026

החל מ-13 ביולי 2026, לא תהיה יותר אפשרות להקצות את Nielsen כספק חיצוני למדידת התחזקות המותג. כדי להתאים את המערכת לשינוי הזה, נבצע את השינויים הבאים ב-Display & Video 360 API ובקובצי נתונים מובְנים:

השימוש הקיים ב-Nielsen כספק למדידת התחזקות המותג יוסר.

כדי למנוע שיבושים בשירות, צריך להסיר מהשילוב כל הקצאה של Nielsen כספק למדידת התחזקות המותג.

העברה בירושה של השם והלוגו של העסק כברירת מחדל ‫13 ביולי 2026

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

  • השדות businessName,‏ logo ו-logoImages במשאבים ad_details של קמפיינים ליצירת ביקוש AdGroupAd לא יהיו נדרשים יותר אם יוקצו ערכי ברירת מחדל למפרסם הראשי. אם לא תציינו את הפרטים האלה, המודעה תירש את הגדרות ברירת המחדל ברמת המפרסם.
  • אפשר יהיה להגדיר את העמודות Business Name ו-Logo Asset IDs בקובצי SDF של מודעות למודעות מכל אחד מהסוגים הבאים: "רספונסיבית", "מוצר ליצירת ביקוש", "וידאו ליצירת ביקוש", "תמונה ליצירת ביקוש" ו "קרוסלה ליצירת ביקוש". אם העמודות האלה לא מוגדרות לרשומת מודעה רלוונטית, וערכי ברירת המחדל מוקצים למפרסם הראשי, המודעה תירש את ערכי ברירת המחדל ברמת המפרסם לאחר השמירה.
  • העמודות Business Name ו-Logo Asset IDs בקובצי SDF של מודעות כבר לא נדרשות במודעות ליצירת ביקוש אם המפרסם הראשי הקצה ערכי ברירת מחדל.

אם ערכי ברירת המחדל מוגדרים ברמת המפרסם, לכל המודעות של המפרסם הזה יוקצו ערכים של שם העסק והלוגו. אם אתם רוצים להשאיר את ערכי הנכסים של שם העסק והלוגו לא מוגדרים במודעות רספונסיביות ל-YouTube, אל תגדירו ערכי ברירת מחדל למפרסם.

ניהול הטירגוט של הזמנות וקמפיינים ב-Display & Video 360 API ובקובצי נתונים מובְנים ‫23 בפברואר 2026

ב-23 בפברואר 2026, נסיר מ-Display & Video 360 את האפשרות להגדיר טירגוט ברמת הקמפיין וההזמנה. כדי להתאים לשינוי הזה, יבוצעו שינויים ב-Display & Video 360 API ובקובצי נתונים מובְנים (SDF). ב-Display & Video 360 API, קבוצת משנה של שיטות תצא משימוש ותחזיר שגיאה אם תתבצע קריאה אליהן. ב-SDF, עמודות הטירגוט בקובצי הזמנת הפרסום והקמפיין לא יאוכלסו יותר בהורדה, ויהיה צורך להשאיר אותן ריקות בהעלאה. מומלץ להקצות טירגוט ישירות לפריטים ברגע שיוצרים אותם.

השיטות הבאות של Display & Video 360 API יחזירו שגיאת 404 אם יופעלו:

רשומות 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 במשאב Advertiser של Display & Video 360 API. אם השדה הזה מוגדר כ-DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING, כל הפריטים החדשים של המפרסם יקבלו את אותו ערך, אלא אם צוין אחרת. בנוסף, כל הפריטים הקיימים של המפרסם יעודכנו כך שישתמשו באותו ערך, אם עדיין לא הוגדר ערך. אפשר לעדכן את ההצהרה של פריט בכל שלב אחרי היצירה שלו באמצעות ממשק המשתמש, ה-API או קובצי SDF.

אם אתם לא יכולים להצהיר ברמת המפרסם או שהצהרתם שמודעות שקשורות לפוליטיקה באיחוד האירופי עשויות להופיע בחשבון המפרסם שלכם, אתם צריכים לעדכן את השילוב של Display & Video 360 API ו-SDF לפני 8 בספטמבר 2025 כדי למנוע שיבושים בשירות:

הגדרות של קטגוריית תוכן לפריטים של YouTube ושותפים ‫12 ביוני 2025

ב-12 ביוני 2025, כחלק מעדכון חוויית המשתמש בנושא תאימות למותג, לא תהיה יותר אפשרות לשנות את ההגדרות של קטגוריות התוכן בפריטים בודדים של YouTube ושותפים. במקום זאת, ההגדרות של קטגוריות התוכן ינוהלו רק ברמת המפרסם. כדי להתאים את המערכת לשינוי הזה, נבצע את השינויים הבאים ב-Display & Video 360 API ובקובצי נתונים מובְנים:

  • השדה contentCategory באובייקטים מסוג YoutubeAndPartnersSettings של משאבי LineItem ב-YouTube ובשותפים לא יעודכן יותר. הוא יוסר לחלוטין במועד מאוחר יותר.
  • העמודה TrueView Content Filter בקובצי SDF של פריטים לא תהיה יותר ניתנת לכתיבה.
כדי למנוע שיבושים בשירות:
  • כשבודקים פריטים של YouTube ושותפים ב-API, צריך לאחזר את השדה effectiveContentCategory במקום השדה contentCategory.
  • צריך להפסיק לשנות את העמודה TrueView Content Filter כשמעדכנים רשומות של פריט SDF. כשיוצרים פריטים חדשים, משאירים את העמודה ריקה.
עדכונים בתקציב של פריט באמצעות אופטימיזציה של הזמנת קמפיין ‫12 ביוני 2025

החל מ-12 ביוני 2025, לא תהיה יותר אפשרות לעדכן את הגדרות התקציב של פריטים עם הזמנות ראשיות שמוגדרות לבצע אופטימיזציה באמצעות שיטות בידינג אוטומטיות.

כדי למנוע שיבושים בשירות:
הגבלות על אתרים בקובצי נתונים מובְנים ‫12 ביוני 2025

החל מ-12 ביוני 2025, נסיר הגבלה קיימת על טירגוט URL ברשומות SDF, שהגבילה את ההכללה של אתרים חדשים יותר. במקום זאת, קובצי SDF יתאימו להתנהגות של ה-API ושל ממשק המשתמש, ויאפשרו לטרגט כתובות URL כל עוד הן בפורמט הנכון.

ההגדרה הזו רלוונטית לעמודות Site Targeting - Include ו-Site Targeting - Exclude בקובצי הזמנת קמפיין ופריט.
העמודה "מכפילי הצעות מחיר" בקובצי נתונים מובְנים של פריטים ‫1 במאי 2025

החל מ-1 במאי 2025, רשומות בקובצי נתונים מובְנים של פריטים שמנסות להגדיר את העמודה "מכפילים של הצעות מחיר" לא יצליחו ליצור או לעדכן משאב בהעלאת קובץ.

דרישה להגדיר את מקור המלאי "שותפי וידאו" בפריטים מקמפיינים ליצירת ביקוש בקובצי נתונים מובְנים ‫22 באפריל 2025

החל מ-22 באפריל 2025, תצטרכו לכלול את הערך "שותפי וידאו" בעמודה TrueView Inventory Source Targeting של רשומות פריטים שהערך שלהן בעמודה Type הוא "יצירת ביקוש". כשהאכיפה הזו תתחיל, הערך ימולא באופן רטרואקטיבי בפריטים קיימים וייכלל בהורדה של קובצי נתונים מובְנים חדשים.

כדי למנוע הפרעה בשירות:

  • מעדכנים את השילוב כך שיכלול את הערך "שותפי וידאו" בכל הרשומות של הפריטים בקמפיינים ליצירת ביקוש.
  • מעדכנים את השילוב כדי לנהל את מקורות המלאי בקמפיינים ליצירת ביקוש ברמת קבוצת המודעות באמצעות העמודות Demand Gen Inventory Source Strategy ו-Demand Gen Enabled Inventory Sources בקובץ SDF בגרסה 8.1 של קבוצת המודעות.
קמפיינים של מודעות וידאו עם קריאה לפעולה בקובצי נתונים מובְנים ‫22 באפריל 2025

החל מ-22 באפריל 2025, לא תהיה יותר אפשרות ליצור פריטים בקמפיינים של מודעות וידאו עם קריאה לפעולה באמצעות קובצי נתונים מובְנים, כי הקמפיינים האלה משודרגים לקמפיינים ליצירת ביקוש. ניסיונות להעלות רשומות של פריטים עם ערך Action בעמודה Subtype וערך TrueView בעמודה Type ייכשלו.

כדי למנוע הפרעות בשירות, צריך לעדכן את השילוב כך שישתמש בקמפיינים ליצירת ביקוש במקום בקמפיינים של מודעות וידאו עם קריאה לפעולה.

משך חברות בלתי מוגבל בקהלים מאינטראקציה ישירה (First-Party) ‫7 באפריל 2025

החל מ-7 באפריל 2025, משאבי FirstAndThirdPartyAudience לא יאפשרו יותר משך חברות אינסופי של משתמשים מקהל היעד. בקשות firstAndThirdPartyAudiences.create ו-firstAndThirdPartyAudiences.patch שמגדירות את ערך השדה membershipDurationDays ל-10,000 יחזירו שגיאת 400. קהלים קיימים עם ערך שדה membershipDurationDays של 10,000 יעודכנו ל-540, ומשך החברות החדש ברשימה יחול רטרואקטיבית על חברויות קיימות ברשימה. הפעולה הזו תגרום לכך שכל החברויות ברשימה שנוצרו לפני יותר מ-540 ימים יפוגו.

כדי למנוע הפרעה בשירות:

  • מוודאים שהשילוב לא מגדיר את ערך השדה membershipDurationDays של קהלים חדשים או קיימים ל-10,000.
  • רענון החברויות בקהלים הקיימים שלכם מסוג "התאמה ללקוחות" באמצעות firstAndThirdPartyAudiences.editCustomerMatchMembers.
  • כדאי לרענן באופן קבוע את החברויות בקהלים שלכם מסוג "התאמה ללקוחות" כדי לוודא שגודל הרשימה של הקהלים לא יצטמצם באופן לא מכוון.

בגרסה 4, השינוי הזה בא לידי ביטוי במשאבים של FirstPartyAndPartnerAudience.

חוסר התאמה בין האלגוריתם של הבידינג בהתאמה אישית לבין הפעילויות ב-Floodlight ‫1 באפריל 2025

ב-1 באפריל 2025:

כדי למנוע שיבושים בשירות, צריך לעדכן את השילוב:

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

תכונות שהוצאו משימוש בעבר

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