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

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

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

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

לוח זמנים

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Java

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

C#‎

ספריית לקוח ל- .NET
v17 Min: 20.1.0
Max: –
v16 Min: 18.1.0
Max: –
v15 Min: 17.1.0
Max: 20.1.0

PHP

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

Python

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

Ruby

ספריית לקוח ל-Ruby
v17 Min: 29.0.0
Max: –
v16 Min: 27.0.0
Max: –
v15 Min: 25.0.0
Max: –

Perl

ספריית לקוח ל-Perl
v17 Min: 23.0.0
Max: –
v16 Min: 21.0.0
Max: –
v15 Min: 19.0.0
Max: –

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

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

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

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