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