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