הוצאה משימוש וסגירה

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

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

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

לוח זמנים

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

גרסת ממשק API	תאריך הפצה	תאריך ההוצאה משימוש	תאריך השקיעה	מדריך לביצוע שדרוג
v18	16 באוקטובר 2024	פברואר 2025	24 בספטמבר 2025
גרסה 17.1	7 באוגוסט 2024	ספטמבר/אוקטובר 2024	4 ביוני 2025	שדרוג מגרסה 17 לגרסה 18
v17	‫5 ביוני 2024	ספטמבר/אוקטובר 2024	4 ביוני 2025	שדרוג מגרסה 17 לגרסה 18
v16.1	24 באפריל 2024	5 ביוני 2024	5 בפברואר 2025	שדרוג מגרסה 16 לגרסה 17
v16	21 בפברואר 2024	‫5 ביוני 2024	5 בפברואר 2025	שדרוג מגרסה 16 לגרסה 17

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

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

1. פותחים את APIs &Services במסוף Google Cloud.
2. לוחצים על Google Ads API בטבלה.
3. בכרטיסיית המשנה METRICS, אתם אמורים לראות את הבקשות האחרונות שלכם בכל תרשים. בטבלה Methods תוכלו לראות לאילו שיטות שלחתם בקשות. שם ה-method כולל גרסה של Google Ads API, שירות ושם של שיטה, כמו google.ads.googleads.v18.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
v18	Min: 34.0.0 Max: -
v17	Min: 32.0.0 Max: -
v16	Min: 30.0.0 Max: -

C#‎

Google Ads API	ספריית לקוח ל-‎.NET
v18	Min: 21.1.0 Max: -
v17	Min: 20.1.0 Max: -
v16	Min: 18.1.0 Max: -

PHP

Google Ads API	ספריית לקוח ל-PHP
v18	Min: 25.0.0 Max: -
v17	Min: 23.1.0 Max: -
v16	Min: 22.1.0 Max: -

Python

Google Ads API	ספריית לקוח ל-Python
v18	Min: 25.1.0 Max: -
v17	Min: 24.1.0 Max: -
v16	Min: 23.1.0 Max: -

Ruby

Google Ads API	ספריית לקוח ל-Ruby
v18	Min: 31.0.0 Max: -
v17	Min: 29.0.0 Max: -
v16	Min: 27.0.0 Max: -

Perl

Google Ads API	ספריית לקוח ל-Perl
v18	Min: 25.0.0 Max: -
v17	Min: 23.0.0 Max: -
v16	Min: 21.0.0 Max: -

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

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

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

תכונה	תיאור	מועד הכניסה לתוקף	הערות נוספות
שינויים צפויים בגודל הדף ב-Google Ads API	כשגרסת v16 תוצא משימוש, לא תוכלו יותר להגדיר את השדה page_size כששולחים בקשות GoogleAdsService.Search.	ינואר 2025	כשגרסת v16 תוצא משימוש, בכל הבקשות ל-GoogleAdsService.Search יוגדר גודל דף קבוע של 10,000 שורות.
שיטת הבידינג 'אופטימיזציית עלות לקליק (eCPC)'	ב-Google Ads API אין יותר תמיכה בהגדרה של אופטימיזציית עלות לקליק כשיטת בידינג בקמפיינים לרשת החיפוש ולרשת המדיה.	אוקטובר 2024	בקשות להגדרת השדה enhanced_cpc_enabled לערך TRUE בשיטת בידינג יגרמו לשגיאה BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED. קמפיינים קיימים שמוגדרת בהם שיטת הבידינג 'אופטימיזציית עלות לקליק' ימשיכו לפעול עד 15 במרץ 2025. אחרי התאריך הזה, הם יועברו באופן אוטומטי לשיטת הבידינג 'עלות ידנית לקליק' (CPC).