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

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

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

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

לוח זמנים

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

גרסת ממשק API	תאריך הפצה	תאריך ההוצאה משימוש	תאריך הוצאה משימוש	מדריך לביצוע שדרוג
v20	‫4 ביוני 2025		יוני 2026 (תאריך משוער)	שדרוג מגרסה 19 לגרסה 20
v19.1	‫16 באפריל 2025		פברואר 2026 (תאריך משוער)
v19	‫26 בפברואר 2025		פברואר 2026 (תאריך משוער)	שדרוג מגרסה 18 לגרסה 19
v18	16 באוקטובר 2024	יוני 2025	אוגוסט 2025	שדרוג מגרסה 17 לגרסה 18

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

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

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

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

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

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

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

Java

Google Ads API	ספריית לקוח ל-Java
v20	Min: 38.0.0 Max: -
v19	Min: 36.0.0 Max: -
v18	Min: 34.0.0 Max: -
v17	Min: 31.0.0 Max: 36.1.0

C#‎

Google Ads API	ספריית לקוח ל-‎ .NET
v20	Min: 23.0.0 Max: -
v19	Min: 22.1.0 Max: -
v18	Min: 21.1.0 Max: -
v17	Min: 20.1.0 Max: 22.2.0

PHP

Google Ads API	ספריית לקוח ל-PHP
v20	Min: 28.0.0 Max: -
v19	Min: 26.1.0 Max: -
v18	Min: 25.0.0 Max: -
v17	Min: 23.1.0 Max: 27.2.0

Python

Google Ads API	ספריית לקוח ל-Python
v20	Min: 27.0.0 Max: -
v19	Min: 25.2.0 Max: -
v18	Min: 25.1.0 Max: -
v17	Min: 24.1.0 Max: 26.1.0

Ruby

Google Ads API	ספריית לקוח ל-Ruby
v20	Min: 34.0.0 Max: -
v19	Min: 32.0.0 Max: -
v18	Min: 31.0.0 Max: -

Perl

Google Ads API	ספריית לקוח ל-Perl
v20	Min: 27.0.0 Max: -
v19	Min: 26.0.0 Max: -
v18	Min: 25.0.1 Max: -

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

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

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

תכונה	תיאור	מועד הכניסה לתוקף	הערות נוספות
הודעות שגיאה חדשות לגבי טוקנים לא תקינים למפתחים	החל מ-28 באפריל 2025, אסימון מפתח לא תקין יחזיר DEVELOPER_TOKEN_INVALID בגרסה v19.1 ואילך, ו- DEVELOPER_TOKEN_NOT_APPROVED בגרסאות שלפני v19.1. טוקנים לא חוקיים למפתחים שהוחזרו בעבר OAUTH_TOKEN_HEADER_INVALID, שעדיין יהיו בשימוש בכותרות לא חוקיות של OAuth.	‫28 באפריל 2025	השינוי הזה לא ישפיע על מי שכבר יש לו קריאות API תקינות.