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