ניהול גרסאות סמנטי
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. כשגרסה עומדת לצאת משימוש, נפרסם הודעות בבלוג למפתחים. לוח הזמנים להוצאה משימוש מעודכן עם תאריכי הסגירה העתידיים.