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