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, אנחנו לפרסם הודעה בקבוצה searchads-api-announcements ב-Google.