ב-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.