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

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

  • לכל היותר, שלוש גרסאות עיקריות זמינות בכל רגע נתון.
  • לגרסאות ראשיות יש משך חיים של כ-12 חודשים – גרסאות קטנות: 10 חודשים.
  • צריך לבצע שני שדרוגים בשנה לכל היותר, ואין צורך לשדרג בסדר רציף רציף. לדוגמה, אפשר לשדרג ישירות מגרסה (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 שדרוג מ-v15 ל-v16
v14.1 9 באוגוסט 2023 18 באוקטובר 2023 5 ביוני 2024
v14 7 ביוני 2023 18 באוקטובר 2023 5 ביוני 2024 שדרוג מ-v14 ל-v15

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

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

  1. פותחים את APIs & Services במסוף 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 וכו'. עם זאת, תכונות חדשות לא מתווספות לגרסאות שהוצאו משימוש.

נקודות הקצה ל-API של גרסאות הסגירה יפסיקו לפעול אחרי תאריכי הסגירה. אם תנסו לגשת לנקודות הקצה של ה-API של הגרסאות שנסגרו, תופיע הודעת שגיאה מ-Google Ads 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: 27.0.0

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. אחרי היום הזה הצגת המודעות בקמפיינים תופסק עד ששיטת הבידינג שלהם תעודכן.