ניהול גרסאות סמנטי
Google Ads API פועל לפי שיטת ניהול גרסאות סמנטית, שבה יש גרסה ראשית וגרסה משנית. הפורמט של הגרסה הוא MAJOR.MINOR או
vMAJOR_MINOR. לדוגמה, v18_0 היא גרסה ראשית, ו-v18_1 היא גרסה משנית.
נתוני הגרסה של הגרסאות הקודמות
גרסאות ראשיות
בגרסאות ראשיות של גרסאות מוצר יש שינויים משמעותיים שלא תואמים לאחור.
הגרסה תסתיים באפס בפורמט vX_0, כאשר X הוא מספר הגרסה הראשית.
לכל גרסה ראשית יש נקודת קצה נפרדת. זו דוגמה לכתובת ה-URL, שבה X הוא מספר הגרסה הראשית.
https://googleads.googleapis.com/vX
אם אתם משדרגים מגרסה ראשית ישנה יותר, יכול להיות שתצטרכו לבצע שינויים בקוד כשתעברו לנקודת הקצה של הגרסה הראשית החדשה. אם אתם משתמשים בספריות הלקוח שלנו, עליכם לשדרג לגרסה החדשה ביותר. כשנוציא גרסה ראשית, נציע מדריך העברה שצריך לעיין בו כדי לתקן שינויים משמעותיים בקוד.
דוגמאות לשינויים שמשביתים את הקוד:
- הסרה או שינוי שם של שירות, ממשק, שדה, שיטה או ערך של enum.
- שינוי הסוג של שדה.
- שינוי הפורמט של שם המשאב.
- שינוי הפורמט של כתובת ה-URL בהגדרת ה-HTTP.
- שינוי פורמטים של פלט, למשל שינוי מ-
0ל---כערך ברירת מחדל. - שינוי הסיבה לשגיאה שחוזרת מ-A ל-B.
גרסאות משניות
בגרסאות משניות מוכנסים רק שינויים שתואמים לגרסת קודם. לגרסה משנית, הערך של MINOR ב-vMAJOR_MINOR יהיה גדול מאפס.
כשגרסה משנית תושק, נקודת הקצה שכבר נמצאת בשימוש תתעדכן באופן אוטומטי. הקוד לא ייפגע. תוכלו להמשיך להשתמש בספריות הלקוח הקיימות.
גרסאות משניות כוללות תכונות חדשות או עדכונים שלא משפיעים על הקוד הקיים. כדי להשתמש בתכונות החדשות האלה, צריך לשדרג את ספריות הלקוח לגרסה העדכנית ביותר.
שקיעה
מדי פעם נצטרך להפסיק את השימוש בגרסאות ישנות יותר של Google Ads API. כשגרסה מסוימת תהיה קרובה לסגירה, נפרוס הודעות בבלוג למפתחים. לוח הזמנים להוצאה משימוש מתעדכן בתאריכי ההוצאה משימוש העתידיים.