כשיוצאים גרסה חדשה, לגרסה שהוצאה משימוש מקבלים תאריך סגירה. לאחר מכן הגרסה הזו כבר לא זמינה. ריכזנו כאן כמה הנחיות נוספות שכדאי לזכור:
- לכל היותר, שלוש גרסאות עיקריות זמינות בכל רגע נתון.
- לגרסאות ראשיות יש משך חיים של כ-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 כדי לראות רשימה של השיטות והשירותים שנקראו לאחרונה בפרויקט:
- פותחים את APIs & Services במסוף Google Cloud.
- לוחצים על Google Ads API בטבלה.
- בכרטיסיית המשנה MetricS, אתם אמורים לראות את הבקשות האחרונות שלכם בכל תרשים. בטבלה Methods תוכלו לראות לאילו שיטות שלחתם בקשות. שם ה-method כולל גרסה של Google Ads API, שירות ושם של שיטה, כמו
google.ads.googleads.v17.services.GoogleAdsService.Mutate
. - (אופציונלי) בוחרים את מסגרת הזמן שרוצים להציג לבקשות.
ההבדלים בין הוצאה משימוש לבין סגירה
מונח | הוצאה משימוש | שקיעה |
---|---|---|
הגדרה | הגרסה שהוצאה משימוש היא לא הגרסה האחרונה. לאחר פרסום גרסה חדשה, כל הגרסאות הקודמות יסומנו בהוצאה משימוש. | לא ניתן יותר להשתמש בגרסת הסגירה. בקשות שיישלחו לגרסה הזו ייכשלו בתאריך ההשבתה או אחריו. |
השלכות | עדיין אפשר להשתמש בגרסאות שהוצאו משימוש עד שנוציא משימוש את הגרסאות שהוצאו משימוש,
אבל תתבצע הדגשה של ההפניות של הגרסאות שהוצאו משימוש כדי להראות שהן כבר לא הגרסה העדכנית ביותר.
מומלץ לשדרג לגרסה העדכנית ביותר בהקדם האפשרי כדי ליהנות מהתכונות החדשות. |
כדי להשתמש ב-Google Ads API צריך לשדרג באופן מיידי
מהגרסאות שנסגרו.
מומלץ מאוד לשדרג לגרסה האחרונה באמצעות מדריך השדרוג. |
תזמון | בממוצע, אנחנו משיקים גרסה חדשה מדי 3 עד 4 חודשים, כך שהגרסה הנתונה תוצא משימוש אחרי כ-3 עד 4 חודשים. | אנחנו שואפים לסגור את הגרסה שנה אחת אחרי השקתה. |
API | נקודות הקצה ל-API של הגרסאות שהוצאו משימוש עדיין פועלות כרגיל.
אפשר לגשת לנקודות הקצה ל-API באמצעות ספריות הלקוח, REST וכו'. עם זאת, תכונות חדשות לא מתווספות לגרסאות שהוצאו משימוש. |
נקודות הקצה ל-API של גרסאות הסגירה יפסיקו לפעול אחרי תאריכי הסגירה. אם תנסו לגשת לנקודות הקצה של ה-API של הגרסאות שנסגרו, תופיע הודעת שגיאה מ-Google Ads API. |
ספריות לקוח | כדי לספק ספריות לקוח קומפקטיות, נפסיק לכלול גרסאות API שהוצאו משימוש בגרסה חדשה של ספריית לקוח, אחרי תאריך ההוצאה משימוש. כך אפשר לחסוך מקום כשמשלבים את ספריות הלקוח בפרויקטים שלך. | ספריות לקוח לא תומכות יותר בגרסאות API שנסגרו אחרי תאריכי הסגירה של ספריית הלקוח. |
תמיכה | אנחנו מספקים תמיכה קבועה לגרסאות שהוצאו משימוש. | אין יותר תמיכה בגרסאות שנסגרו אחרי תאריך הסגירה. |
גרסאות נתמכות של ספריות לקוח
בטבלה אפשר לראות אילו ספריות לקוח פועלות עם אילו גרסאות של ממשקי API פועלות.
Java
Google Ads API |
ספריית לקוח ל-Java |
v16 |
Min: 30.0.0 Max: - |
v15 |
Min: 28.0.0 Max: - |
v14 |
Min: 26.0.0 Max: 30.0.0
|
C#
Google Ads API |
ספריית לקוח ל- .NET |
v16 |
Min: 18.1.0 Max: - |
v15 |
Min: 17.1.0 Max: - |
v14 |
Min: 16.1.0 Max: 19.0.1 |
PHP
Google Ads API |
ספריית לקוח ל-PHP |
v16 |
Min: 22.1.0 Max: - |
v15 |
Min: 21.1.0 Max: - |
Python
Google Ads API |
ספריית לקוח ל-Python |
v16 |
Min: 23.1.0 Max: - |
v15 |
Min: 22.1.0 Max: - |
Ruby
Google Ads API |
ספריית לקוח ל-Ruby |
v16 |
Min: 27.0.0 Max: - |
v15 |
Min: 25.0.0 Max: - |
v14 |
Min: 23.0.0 Max: 27.0.0
|
Perl
Google Ads API |
ספריית לקוח ל-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. אחרי היום הזה
הצגת המודעות בקמפיינים תופסק עד ששיטת הבידינג שלהם תעודכן.
|