הוצאה משימוש ושקיעה

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

  • אנחנו משתדלים להשאיר לכל היותר ארבע גרסאות ראשיות זמינות בכל זמן נתון.
  • לגרסאות העיקריות יש מחזור חיים של כ-12 חודשים – לגרסאות המשניות: 10 חודשים.
  • תצטרכו לבצע לכל היותר שני שדרוגים בשנה, ולא חייבים לשדרג בסדר רציף – לדוגמה, אפשר לשדרג מגרסה (N) ישירות לגרסה (N+2).
  • החפיפה בין התאריך שבו כל ספריות הלקוח יושקו לגרסה העדכנית ביותר לבין הגרסה שתצא משימוש היא לפחות 20 שבועות.

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

לוח זמנים

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

גרסת ממשק APIתאריך הפצהתאריך השקיעהמדריך לביצוע שדרוג
גרסאות שפורסמו
v21‫6 באוגוסט 2025אוגוסט 2026 (משוער)שדרוג מגרסה 20 לגרסה 21
v22‫15 באוקטובר 2025אוקטובר 2026 (תאריך משוער)שדרוג מגרסה v21 לגרסה v22
v23‫28 בינואר 2026פברואר 2027שדרוג מגרסה v22 לגרסה v23
v23.1 ‫25 בפברואר 2026 פברואר 2027 שדרוג מגרסה v23 לגרסה v23.1
v23.2 ‫25 במרץ 2026 פברואר 2027 שדרוג מגרסה v23.1 לגרסה v23.2
v24 ‫22 באפריל 2026 מאי 2027 שדרוג מגרסה v23.2 לגרסה v24
v24.1 ‫13 במאי 2026 מאי 2027 שדרוג מגרסה v24 לגרסה v24.1
גרסאות עתידיות
v24.2 יוני 2026 מאי 2027  
v25 יולי 2026 אוגוסט 2027  
v25.1 אוגוסט 2026 אוגוסט 2027  
v25.2 ספטמבר 2026 אוגוסט 2027  
v26 אוקטובר 2026 נובמבר 2027  
גרסה 26.1* נובמבר 2026 נובמבר 2027  

‫* v26.1 מוגדרת כגרסה אופציונלית בגלל חפיפה עם תקופת החגים.

הצגת הגרסאות שבהן נעשה שימוש בפרויקט

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

  1. פותחים את APIs & Services במסוף Google Cloud.
  2. לוחצים על Google Ads API בטבלה.
  3. בכרטיסיית המשנה מדדים, אמורות להופיע הבקשות האחרונות שלכם בתרשימים. בטבלה Methods (שיטות) אפשר לראות לאילו שיטות נשלחו בקשות. שם ה-method כולל גרסה של Google Ads API, שירות ושם method, כמו google.ads.googleads.v24.services.GoogleAdsService.Mutate.
  4. (אופציונלי) בוחרים את מסגרת הזמן שרוצים לראות לגבי הבקשות.

ההבדלים בין הוצאה משימוש לבין סגירה

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

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

 כדי להשתמש ב-Google Ads API, צריך לשדרג מהגרסאות שיצאו משימוש באופן מיידי.

מומלץ מאוד לשדרג לגרסה האחרונה באמצעות מדריך השדרוג.
תזמון בממוצע, אנחנו משיקים גרסה חדשה כל 3 עד 4 חודשים, כך שהגרסה שצוינה תצא משימוש אחרי כ-3 עד 4 חודשים. אנחנו שואפים להוציא משימוש גרסה מסוימת שנה אחרי ההשקה שלה.
API נקודות הקצה של ה-API בגרסאות שהוצאו משימוש עדיין פועלות כרגיל.

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

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

גרסאות נתמכות של ספריות לקוח

בטבלה מוצגות ספריות הלקוח שמתאימות לגרסאות שונות של API.

גרסת המינימום של ספריית הלקוח שמופיעה ברשימה מספיקה לגרסה הראשית של Google Ads API (למשל, v24). כדי לראות את הגרסה הנדרשת של ספריית הלקוח למהדורות משניות, אפשר לעיין ביומן השינויים המקושר.

Java

יומן שינויים

ספריית לקוח ל-Java
v24 Min: 43.0.0
Max: -
v23 Min: 42.0.0
Max: -
v22 Min: 41.0.0
Max: -
v21 Min: 39.0.0
Max: -

C#‎

יומן שינויים

ספריית לקוח ל-‎ .NET
v24 Min: 25.3.0
Max: -
v23 Min: 25.1.0
Max: -
v22 Min: 24.1.0
Max: -
v21 Min: 24.0.0
Max: -

PHP

יומן שינויים

ספריית לקוח ל-PHP
v24 Min: 33.3.0
Max: -
v23 Min: 32.2.0
Max: -
v22 Min: 31.0.0
Max: -
v21 Min: 28.0.0
Max: -

Python

יומן שינויים

ספריית לקוח ל-Python
v24 Min: 30.1.0
Max: -
v23 Min: 29.2.0
Max: -
v22 Min: 28.1.0
Max: -
v21 Min: 28.0.0
Max: -

Ruby

יומן שינויים

ספריית לקוח ל-Ruby
v24 Min: 40.0.0
Max: -
v23 Min: 38.0.0
Max: -
v22 Min: 36.0.0
Max: -
v21 Min: 35.0.0
Max: -

Perl

יומן שינויים

ספריית לקוח ל-Perl
v24 Min: 32.0.0
Max: -
v23 Min: 31.0.0
Max: -
v22 Min: 29.0.0
Max: -
v21 Min: 28.0.0
Max: -

הוצאה משימוש ושינויים בתכונות

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

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

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

תקופת השמירה של נתוני דיווח מפורטים (יומיים, שעתיים, שבועיים) תצומצם ל-37 חודשים. נתונים ברמה גבוהה (חודשיים, רבעוניים, שנתיים) יישארו זמינים למשך 11 שנים. שמירת נתונים למשך 11 שנים מתבצעת בהתאם לגבולות של תקופות קלנדריות מלאות (התחלת התקופה המלאה הבאה). לדוגמה:

  • אם התאריך לפני 11 שנים הוא 22.3.2022, הנתונים שיוחזרו יהיו מ-1.4.2022 ועד עכשיו.
  • אם התאריך של 11 שנים לפני היום הוא 2022-03-01, הנתונים שיוחזרו יהיו עדיין מ-2022-04-01 ועד היום.
‫1 ביוני 2026 פרטים נוספים זמינים בפוסט בבלוג.
שינויים בתמיכה בהמרות אופליין

החל מ-15 ביוני 2026, מפתחים שמשתמשים בטוקנים שלא נשלחו דרכם בקשות לייבוא נתוני המרות אופליין לאחרונה, יצטרכו להשתמש ב-Data Manager API כדי לייבא נתוני המרות אופליין.

‫15 ביוני 2026 פרטים נוספים זמינים בפוסט בבלוג.
שינויים בתמיכה בנושא התאמה ללקוחות

החל מ-1 באפריל 2026, קודי מפתח למפתחים שלא שלחו בקשות עדכניות של התאמה ללקוחות יצטרכו להשתמש ב-Data Manager API כדי להפעיל תהליכי עבודה של התאמה ללקוחות.

  • אם קוד המפתח שלכם למפתחים שלח בקשה מסוג OfflineUserDataJobService או UserDataService לקהלים מסוג "התאמה ללקוחות" בין 1 באוקטובר 2025 ל-31 במרץ 2026, תוכלו להמשיך להשתמש בקוד המפתח למפתחים עם Google Ads API לתהליכי עבודה של התאמה ללקוחות. עם זאת, מומלץ לשדרג את תהליכי העבודה של התאמה ללקוחות ל-Data Manager API כדי ליהנות מחוויית פיתוח משופרת ומגישה לתכונות נוספות.
  • אחרת, החל מ-1 באפריל 2026, כל בקשה של OfflineUserDataJobService או UserDataService לקהלים מסוג 'התאמה ללקוחות' תיכשל עם השגיאה CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE. משתמשים ב-Data Manager API במקום ב-Google Ads API בתהליכי העבודה של התאמה ללקוחות.
‫1 באפריל 2026 פרטים נוספים זמינים בפוסט בבלוג.
שינויים בתמיכה בכתובת IP ובמאפיין סשן ‫Google Ads API לא מקבל יותר משתמשים חדשים בנתוני מאפייני סשן או כתובת IP כחלק מייבוא המרות. משתמשים קיימים צריכים לעבור ל-Data Manager API. ‫2 בפברואר 2026 פרטים נוספים זמינים בפוסט בבלוג.
הוצאה משימוש של מודעות לשיחות בלבד אי אפשר ליצור מודעות חדשות לשיחות בלבד. הצגת מודעות קיימות לשיחות בלבד תופסק בפברואר 2027, והתמיכה ב-API תוסר. מפרסמים צריכים להשתמש במודעות רספונסיביות לרשת החיפוש עם נכסי התקשרות במקום זאת. ינואר 2026 פרטים נוספים זמינים בפוסט בבלוג.