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

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

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

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

לוח זמנים

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

גרסת ממשק APIתאריך הפצהתאריך הוצאה משימושמדריך לביצוע שדרוג
גרסאות שפורסמו
v19‫26 בפברואר 2025 פברואר 2026 (תאריך משוער)שדרוג מגרסה 18 לגרסה 19
v19.1‫16 באפריל 2025 פברואר 2026 (תאריך משוער)שדרוג מגרסה 18 לגרסה 19
v19.2‫6 באוגוסט 2025 פברואר 2026 (תאריך משוער)שדרוג מגרסה 18 לגרסה 19
v20‫4 ביוני 2025יוני 2026 (תאריך משוער)שדרוג מגרסה 19 לגרסה 20
v20.1‫6 באוגוסט 2025יוני 2026 (תאריך משוער)שדרוג מגרסה 19 לגרסה 20
v21‫6 באוגוסט 2025אוגוסט 2026 (תאריך משוער)שדרוג מגרסה 20 לגרסה 21
v22‫15 באוקטובר 2025אוקטובר 2026 (תאריך משוער)שדרוג מגרסה v21 לגרסה v22
גרסאות עתידיות
v23 ינואר 2026 פברואר 2027  
v23.1 פברואר 2026 פברואר 2027  
v23.2 ‫25 במרץ 2026 פברואר 2027  
v24 אפריל 2026 מאי 2027  
v24.1 מאי 2026 מאי 2027  
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 Console:

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

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

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

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

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

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

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

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

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

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

Java

ספריית לקוח ל-Java
v22 Min: 41.1.0
Max: -
v21 Min: 39.0.0
Max: -
v20 Min: 38.0.0
Max: -
v19 Min: 36.0.0
Max: -

C#‎

ספריית לקוח ל-‎ .NET
v22 Min: 24.1.0
Max: -
v21 Min: 24.0.0
Max: -
v20 Min: 23.0.0
Max: -
v19 Min: 22.1.0
Max: -

PHP

ספריית לקוח ל-PHP
v22 Min: 31.0.0
Max: -
v21 Min: 28.0.0
Max: -
v20 Min: 26.1.0
Max: -
v19 Min: 25.0.0
Max: 30.0.0

Python

ספריית לקוח ל-Python
v22 Min: 28.1.0
Max: -
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -
v19 Min: 25.2.0
Max: -

Ruby

ספריית לקוח ל-Ruby
v22 Min: 36.0.0
Max: -
v21 Min: 35.0.0
Max: -
v20 Min: 34.0.0
Max: -
v19 Min: 32.0.0
Max: -

Perl

ספריית לקוח ל-Perl
v22 Min: 29.0.0
Max: -
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -
v19 Min: 26.0.0
Max: -

הוצאה משימוש של תכונות

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

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

תכונה תיאור מועד הכניסה לתוקף הערות נוספות
סביבת ההמרה משפיעה על הביצועים של הקמפיין לקידום אפליקציה החל מ-30 בספטמבר 2025, נתחיל להשיק בהדרגה שינוי במודלים של בידינג, שיאפשר להם להשתמש בנתוני סביבת ההמרה שנכללים בהמרות מיובאות כדי לשפר את ביצועי הקמפיין. ‫3 באוקטובר 2025 פרטים נוספים זמינים בפוסט בבלוג.
ההמרות יכולות לכלול גם ערכי gclid וגם ערכי gbraid. החל מ-3 באוקטובר 2025, אם השדות gclid ו-gbraid מוגדרים, המרות מיובאות לא יחזירו יותר שגיאה מסוג VALUE_MUST_BE_UNSET. ‫3 באוקטובר 2025 פרטים נוספים זמינים בפוסט בבלוג.