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

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

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

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

לוח זמנים

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

גרסת ממשק APIתאריך הפצהתאריך הפסקת התמיכהמדריך לביצוע שדרוג
גרסאות שפורסמו
v22‫15 באוקטובר 2025אוקטובר 2026 (תאריך משוער)שדרוג מגרסה 21 לגרסה 22
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 אוקטובר 2026 נובמבר 2027  
גרסה 26.1* נובמבר 2026 נובמבר 2027  

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

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

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

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

Java

יומן שינויים

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

C#‎

יומן שינויים

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

PHP

יומן שינויים

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

Python

יומן שינויים

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

Ruby

יומן שינויים

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

Perl

יומן שינויים

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

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

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

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