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

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

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

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

לוח זמנים

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

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

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

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

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

C#‎

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

PHP

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

Python

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

Ruby

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

Perl

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

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

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

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

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