ב-Search Ads 360 Reporting API נעשה שימוש בניהול גרסאות סמנטיות.
יש גרסאות משניות וראשיות בפורמט vMAJOR_MINOR. לדוגמה: v0_0 היא הגרסה הראשית הראשונה, ו-v0_1 הגרסה המשנית הראשונה. הסיומת של מספר הגרסה מציינת את סוג הגרסה: בגרסאות הראשיות היא תמיד אפס, ובגרסאות המשניות היא תמיד גדולה מאפס.
גרסאות ראשיות
גרסאות עיקריות כוללות שינויים שעלולים לגרום לכשלים, כלומר שינויים שלא תואמים לאחור.
לכל גרסה ראשית יש נקודת קצה נפרדת, לדוגמה:
https://searchads360.googleapis.com/v0 https://searchads360.googleapis.com/v1
כשמשדרגים מגרסה ראשית אחת לגרסה ראשית, יכול להיות שתצטרכו לשנות את הקוד לפני המעבר לנקודת הקצה החדשה של הגרסה הראשית.
אם אתם משתמשים בספריית לקוח, תצטרכו לשדרג לגרסה החדשה ביותר. הגרסאות הראשיות החדשות מספקות מדריך להעברת הנתונים (מיגרציה) כדי לעזור לכם לתקן בעיות בקוד שעלול לגרום לכשלים.
דוגמאות לשינויי תוכנה שעלולים לגרום לכשלים:
- הסרה או שינוי שם של שירות, ממשק, שדה, שיטה או ערך טיפוסים בני מנייה (enum).
- שינוי סוג השדה.
- שינוי פורמט של שם של משאב.
- שינוי הפורמט של כתובת ה-URL בהגדרת ה-HTTP.
- שינוי פורמט הפלט, למשל שינוי של הערך
0ל---כערך ברירת המחדל. - שינוי סיבת השגיאה שהוחזרה מ-A ל-B.
גרסאות משניות
גרסאות משניות כוללות רק שינויים תואמים לאחור.
כשמשחררים גרסה משנית, נקודת הקצה שכבר נמצאת בשימוש מתעדכנת באופן אוטומטי. פעולות כאלה לא גורמות לשיבושים בקוד. תוכלו להמשיך להשתמש בספריית הלקוח הקיימת.
גרסאות משניות כוללות תכונות או עדכונים חדשים שלא משפיעים על הקוד הקיים. אם תרצו להשתמש בתכונות החדשות, תצטרכו לשדרג את ספריית הלקוח לגרסה האחרונה.
שקיעה
כשאנחנו מתכננים לסגור גרסה ישנה יותר של Search Ads 360 Reporting API, אנחנו מפרסמים הודעה בקבוצת Google searchads-api-announcements.