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

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

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

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

לוח זמנים

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

גרסת ממשק APIתאריך הפצהתאריך הפסקת התמיכהמדריך לביצוע שדרוג
גרסאות הפצה
v23‫28 בינואר 2026פברואר 2027שדרוג מגרסה 22 לגרסה 23
v23.1 ‫25 בפברואר 2026 פברואר 2027 שדרוג מגרסה 23 לגרסה 23.1
v23.2 ‫25 במרץ 2026 פברואר 2027 שדרוג מגרסה 23.1 לגרסה 23.2
v24 ‫22 באפריל 2026 מאי 2027 שדרוג מגרסה 23.2 לגרסה 24
v24.1 ‫13 במאי 2026 מאי 2027 שדרוג מגרסה 24 לגרסה 24.1
v24.2 ‫24 ביוני 2026 יוני 2027 שדרוג מגרסה 24.1 לגרסה 24.2
v25 ‫22 ביולי 2026 אוגוסט 2027 שדרוג מגרסה 24.2 לגרסה 25
v25.1 ‫19 באוגוסט 2026 אוגוסט 2027 שדרוג מגרסה 25 לגרסה 25.1
v25.2 ‫23 בספטמבר 2026 אוגוסט 2027 שדרוג מגרסה 25.1 לגרסה 25.2
v26 ‫14 באוקטובר 2026 נובמבר 2027 שדרוג מגרסה 25.2 לגרסה 26
גרסאות עתידיות
v26.1 אוקטובר 2026 נובמבר 2027  
v26.2 נובמבר 2026 נובמבר 2027  
גרסה 26.3* דצמבר 2026 נובמבר 2027  
v27 ינואר 2027 פברואר 2028  
v27.1 פברואר 2027 פברואר 2028  
v27.2 פברואר 2027 פברואר 2028  
v27.3 מרץ 2027 פברואר 2028  
v27.4 מרץ 2027 פברואר 2028  
v28 אפריל 2027 מאי 2028  
v28.1 אפריל 2027 מאי 2028  
v28.2 מאי 2027 מאי 2028  
v28.3 מאי 2027 מאי 2028  
v28.4 יוני 2027 מאי 2028  
v28.5 יוני 2027 מאי 2028  
v29 יולי 2027 אוגוסט 2028  
v29.1 יולי 2027 אוגוסט 2028  
v29.2 אוגוסט 2027 אוגוסט 2028  
v29.3 אוגוסט 2027 אוגוסט 2028  
v29.4 ספטמבר 2027 אוגוסט 2028  
v29.5 ספטמבר 2027 אוגוסט 2028  
v30 אוקטובר 2027 נובמבר 2028  
v30.1 אוקטובר 2027 נובמבר 2028  
v30.2 נובמבר 2027 נובמבר 2028  
גרסה 30.3 ומעלה* דצמבר 2027 נובמבר 2028  

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

איך בודקים באילו גרסאות משתמשים בפרויקט

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

  1. פותחים את APIs & Services במסוף Google Cloud.
  2. בטבלה, לוחצים על Google Ads API.
  3. בכרטיסיית המשנה METRICS, אמורות להופיע הבקשות האחרונות שלכם בתרשים. בטבלה Methods אפשר לראות לאילו שיטות נשלחו בקשות. שם ה-method כולל את גרסת Google Ads API, שירות ושם method, למשל google.ads.googleads.v26.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 (למשל גרסה 26). כדי לראות את הגרסה הנדרשת של ספריית הלקוח לגרסאות משניות, עיינו ביומן השינויים המקושר.

Java

יומן שינויים

ספריית לקוח ל-Java
v26 Min: 48.0.0
Max: -
v25 Min: 44.0.0
Max: -
v24 Min: 43.0.0
Max: -
v23 Min: 42.0.0
Max: -

C#‎

יומן שינויים

ספריית לקוח ל-‎ .NET
v26 Min: 27.5.0
Max: -
v25 Min: 26.1.0
Max: -
v24 Min: 25.3.0
Max: -
v23 Min: 25.1.0
Max: -

PHP

יומן שינויים

ספריית לקוח ל-PHP
v26 Min: 35.2.0
Max: -
v25 Min: 33.6.0
Max: -
v24 Min: 33.3.0
Max: -
v23 Min: 32.2.0
Max: -

Python

יומן שינויים

ספריית לקוח ל-Python
v26 Min: 34.0.0
Max: -
v25 Min: 31.2.0
Max: -
v24 Min: 30.1.0
Max: -
v23 Min: 29.2.0
Max: -

Ruby

יומן שינויים

ספריית לקוח ל-Ruby
v26 Min: 46.0.0
Max: -
v25 Min: 43.0.0
Max: -
v24 Min: 40.0.0
Max: -
v23 Min: 38.0.0
Max: -

Perl

יומן שינויים

ספריית לקוח ל-Perl
v26 Min: 36.0.0
Max: -
v25 Min: 33.0.0
Max: -
v24 Min: 32.0.0
Max: -
v23 Min: 31.0.0
Max: -

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

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

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