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