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