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

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

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

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

לוח זמנים

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

גרסת ממשק API	תאריך הפצה	תאריך ההוצאה משימוש	שינויים בתוכנה שעלולים לגרום לכשלים ושדרוג	תכונות ועדכונים	טבלת ההבדלים בין הפרוטוקולים
גרסאות הפצה
v23	‫28 בינואר 2026	פברואר 2027	שינויי תוכנה שעלולים לגרום לכשל בגרסה 23 (מדריך לשדרוג)	תכונות ועדכונים בגרסה 23	ההבדלים בין הפרוטוקולים של גרסה 22 וגרסה 23
v23.1	‫25 בפברואר 2026	פברואר 2027	אין (גרסה משנית)	תכונות ועדכונים בגרסה 23.1	ההבדלים בין הפרוטוקולים של גרסה 22 וגרסה 23
v23.2	‫25 במרץ 2026	פברואר 2027	אין (גרסה משנית)	תכונות ועדכונים בגרסה 23.2	ההבדלים בין הפרוטוקולים של גרסה 22 וגרסה 23
v23.3	‫24 ביוני 2026	פברואר 2027	אין (גרסה משנית)	תכונות ועדכונים בגרסה 23.3	ההבדלים בין הפרוטוקולים של גרסה 22 וגרסה 23
v24	‫22 באפריל 2026	מאי 2027	שינויי תוכנה שעלולים לגרום לכשלים בגרסה 24 (מדריך לשדרוג)	תכונות ועדכונים בגרסה 24	ההבדלים בין הפרוטוקולים של גרסה 23 וגרסה 24
v24.1	‫13 במאי 2026	מאי 2027	אין (גרסה משנית)	תכונות ועדכונים בגרסה 24.1	ההבדלים בין הפרוטוקולים של גרסה 23 וגרסה 24
v24.2	‫24 ביוני 2026	יוני 2027	אין (גרסה משנית)	תכונות ועדכונים בגרסה 24.2	ההבדלים בין הפרוטוקולים של גרסה 23 וגרסה 24
v25	‫22 ביולי 2026	אוגוסט 2027	שינויי תוכנה שעלולים לגרום לכשלים בגרסה 25 (מדריך לשדרוג)	תכונות ועדכונים בגרסה 25	ההבדלים בין הפרוטוקולים של גרסה 24 וגרסה 25
v25.1	‫19 באוגוסט 2026	אוגוסט 2027	אין (גרסה משנית)	תכונות ועדכונים בגרסה 25.1	ההבדלים בין הפרוטוקולים של גרסה 24 וגרסה 25
v25.2	‫23 בספטמבר 2026	אוגוסט 2027	אין (גרסה משנית)	תכונות ועדכונים בגרסה 25.2	ההבדלים בין הפרוטוקולים של גרסה 24 וגרסה 25
‫v26 (הגרסה האחרונה)	‫14 באוקטובר 2026	נובמבר 2027	שינויי תוכנה שעלולים לגרום לכשל בגרסה 26 (מדריך לשדרוג)	תכונות ועדכונים בגרסה 26	ההבדלים בין פרוטוקול v25 ל-v26
גרסאות עתידיות
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). כדי לראות את הגרסה הנדרשת של ספריית הלקוח לגרסאות משניות, עיינו ביומן השינויים המקושר.

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

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

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