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