כשאנחנו משיקים גרסה חדשה, אנחנו קובעים תאריך שבו הגרסה הקודמת תוצא משימוש. אחרי התאריך הזה, הגרסה הקודמת לא תהיה זמינה יותר. ריכזנו כאן כמה קווים מנחים נוספים שכדאי לזכור:
- בכל רגע נתון זמינות שלוש גרסאות ראשיות לכל היותר.
- תוחלת החיים של גרסאות ראשיות היא כ-12 חודשים, ותוחלת החיים של גרסאות משניות היא 10 חודשים.
- תצטרכו לבצע עד שני שדרוגים בשנה, ואין צורך לבצע את השדרוגים בסדר כרונולוגי קפדני. לדוגמה, אפשר לשדרג ישירות מגרסה (N) לגרסה (N+2).
- החפיפה בין התאריך שבו כל ספריות הלקוח יושקו לגרסה העדכנית לבין הגרסה שתוסר היא לפחות 20 שבועות.
ספריות הלקוח שלנו תומכות בכל הגרסאות הזמינות של שירות, כך שאפשר לשדרג בהדרגה על ידי ציון גרסאות שונות של השירותים שבהם אתם משתמשים.
לוח זמנים
בטבלה הבאה מפורטים תאריכי ההוצאה משימוש וההוצאה משימוש סופית של כל גרסה זמינה, ותאריכי ההשקה הצפויים של גרסאות עתידיות. מומלץ לשדרג לגרסה האחרונה בהקדם האפשרי אחרי שהיא תושק.
| גרסת ממשק API | תאריך הפצה | תאריך ההוצאה משימוש | תאריך ההוצאה משימוש | מדריך לביצוע שדרוג |
|---|---|---|---|---|
| v18 | 16 באוקטובר 2024 | פברואר 2025 | 24 בספטמבר 2025 | |
| v17.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:
- פותחים את הדף APIs & Services במסוף Google Cloud.
- לוחצים על Google Ads API בטבלה.
- בכרטיסייה המשנית METRICS (מדדים), הבקשות האחרונות שלכם אמורות להופיע בתרשים. בטבלה Methods תוכלו לראות לאילו שיטות שלחתם בקשות. שם ה-method כולל את גרסת Google Ads API, שירות ושם method, כמו
google.ads.googleads.v18.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 |
v18 |
Min: 34.0.0Max: - |
v17 |
Min: 32.0.0Max: - |
v16 |
Min: 30.0.0Max: - |
C#
Google Ads API |
ספריית לקוח ל- .NET |
v18 |
Min: 21.1.0Max: - |
v17 |
Min: 20.1.0Max: - |
v16 |
Min: 18.1.0Max: - |
PHP
Google Ads API |
ספריית לקוח ל-PHP |
v18 |
Min: 25.0.0Max: - |
v17 |
Min: 23.1.0Max: - |
v16 |
Min: 22.1.0Max: - |
Python
Google Ads API |
ספריית לקוח ל-Python |
v18 |
Min: 25.1.0Max: - |
v17 |
Min: 24.1.0Max: - |
v16 |
Min: 23.1.0Max: - |
Ruby
Google Ads API |
ספריית לקוח ל-Ruby |
v18 |
Min: 31.0.0Max: - |
v17 |
Min: 29.0.0Max: - |
v16 |
Min: 27.0.0Max: - |
Perl
Google Ads API |
ספריית לקוח ל-Perl |
v18 |
Min: 25.0.0Max: - |
v17 |
Min: 23.0.0Max: - |
v16 |
Min: 21.0.0Max: - |
הוצאה משימוש של תכונות
מומלץ לעקוב באופן קבוע אחרי הבלוג למפתחים של Google Ads כדי להיות הראשונים לשמוע על הוצאה משימוש של תכונות עתידיות.
בטבלה הבאה מפורטות ההוצאות משימוש ספציפיות של תכונות שאנחנו מתכננים כרגע ב-Google Ads API. פרטים נוספים על כל הוצאה משימוש זמינים בפוסט בבלוג המקושר.
| תכונה | תיאור | מועד הכניסה לתוקף | הערות נוספות |
|---|---|---|---|
| שינויים צפויים בגודל הדף ב-Google Ads API | כשגרסת v16 תוצא משימוש, לא תוכלו יותר להגדיר את השדה page_size כששולחים בקשות GoogleAdsService.Search. |
פברואר 2025 | כשגרסת v16 תוצא משימוש, בכל הבקשות ל-GoogleAdsService.Search יוגדר גודל דף קבוע של 10,000 שורות. |
| שיטת בידינג עם אופטימיזציית עלות לקליק | Google Ads API לא תומך יותר בהגדרת אופטימיזציית עלות לקליק כשיטת בידינג בקמפיינים לרשת החיפוש ולרשת המדיה. | אוקטובר 2024 |
בקשות להגדרת השדה enhanced_cpc_enabled לערך TRUE בשיטת בידינג יגרמו לשגיאה BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED. קמפיינים קיימים שמוגדרת בהם שיטת הבידינג 'אופטימיזציית עלות לקליק' ימשיכו לפעול עד 15 במרץ 2025. אחרי התאריך הזה, הם יועברו באופן אוטומטי לשיטת הבידינג 'עלות ידנית לקליק' (CPC).
|