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

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

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

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

לוח זמנים

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

גרסת ממשק API תאריך פרסום תאריך ההוצאה משימוש תאריך השקיעה המדריך לשדרוג
v18 ספטמבר/אוקטובר 2024 ינואר/פברואר 2025 ספטמבר 2025
v17.1 יולי/אוגוסט 2024 ספטמבר/אוקטובר 2024 מאי 2025
v17 מאי/יוני 2024 ספטמבר/אוקטובר 2024 מאי 2025
v16.1 24 באפריל 2024 מאי/יוני 2024 ינואר 2025
v16 21 בפברואר 2024 מאי/יוני 2024 ינואר 2025
v15 18 באוקטובר 2023 21 בפברואר 2024 25 בספטמבר 2024 שדרוג מגרסה 15 לגרסה 16
v14.1 9 באוגוסט 2023 18 באוקטובר 2023 5 ביוני 2024
v14 7 ביוני 2023 18 באוקטובר 2023 5 ביוני 2024 שדרוג מגרסה 14 לגרסה 15

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

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

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

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

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

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

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

מומלץ מאוד לשדרג לגרסה האחרונה באמצעות המדריך לשדרוג.

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

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

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

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

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

Java

ספריית לקוח ל-Java
v16 Min: 30.0.0
Max: –
v15 Min: 28.0.0
Max: –
v14 Min: 26.0.0
Max: 30.0.0

C#

ספריית לקוח ב- .NET
v16 Min: 18.1.0
Max: –
v15 Min: 17.1.0
Max: –
v14 Min: 16.1.0
Max: 19.0.1

PHP

ספריית לקוח עבור PHP
v16 Min: 22.1.0
Max: –
v15 Min: 21.1.0
Max: –

Python

ספריית לקוח ל-Python
v16 Min: 23.1.0
Max: –
v15 Min: 22.1.0
Max: –

Ruby

ספריית לקוח של Ruby
v16 Min: 27.0.0
Max: –
v15 Min: 25.0.0
Max: –
v14 Min: 23.0.0
Max: –

Perl

ספריית לקוח של Perl
v16 Min: 21.0.0
Max: –
v15 Min: 19.0.0
Max: –
v14 Min: 17.0.0
Max: 21.0.0

פיצ'רים שיצאו משימוש

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

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

תכונה תיאור מועד הכניסה לתוקף הערות נוספות
שיטת הבידינג 'עמלות' Google Ads API לא תומך יותר ביצירת קמפיינים לקידום מלונות עם שיטת בידינג COMMISSION . 30 באפריל 2024 בקשות ליצירת קמפיינים חדשים לקידום מלונות או החלה של שיטת הבידינג COMMISSION על קמפיינים קיימים יובילו לשגיאה BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED. קמפיינים קיימים עם שיטת הבידינג COMMISSION ימשיכו לפעול עד 31 באוקטובר 2024. אחרי היום הזה, הצגת המודעות בקמפיינים תופסק עד ששיטת הבידינג שלהם תעודכן.