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