הפניה לממשק ה-API של VersionHistory

בדף הזה תמצאו מידע טכני על ממשק ה-API של שירות האינטרנט VersionHistory.

כל הכניסות דרך ממשקי API מתבצעות ב-HTTPS, וניתן לגשת אליהן דרך https://versionhistory.googleapis.com/v1.

גרסה

גרסה היא מופע מסוים של Chrome שהמשתמשים מפעילים.

קבלת פרטי הגרסה של פלטפורמה וערוץ ספציפיים

בתיבת הדו-שיח הזו מפורטים כל גרסאות Chrome לפלטפורמה ולערוץ שצוינו.

GET /{product}/platforms/{platform}/channels/{channel}/versions
שם התיאור
product מזהה מוצר.
platform מזהה פלטפורמה.
channel מזהה ערוץ.

פריט תוכן

פרסום הוא מרווח הזמן שבו משתמשים הפעילו גרסה מסוימת של Chrome. נקודות הקצה של הגרסה מספקות גם מידע לגבי שיעור המשתמשים שהפעילו את הגרסה הזו של Chrome במהלך אותו פרק זמן.

לצפייה בכל הגרסאות

בתיבת הדו-שיח הזו מפורטים כל הגרסאות לפלטפורמה, לערוץ ולגרסה שצוינו.

GET /{product}/platforms/{platform}/channels/{channel}/versions/{version}/releases
שם התיאור
product מזהה מוצר.
platform מזהה פלטפורמה.
channel מזהה ערוץ.
version מזהה גרסה.

מוצר

מוצר הוא רכיב תוכנה כמו Chrome או Fuchsia Web Engine.

מזהי מוצרים

התיאור ערך
Chrome chrome
מנוע אינטרנט של Fuchsia fuchsiawebengine

הפלטפורמה

פלטפורמה היא אחת מפלטפורמות המחשוב שבהן מוצר פועל, כמו Windows, Android וכו'.

צפייה בכל הפלטפורמות

GET /{product}/platforms
שם התיאור
product מזהה מוצר.

קבלת כל השילובים של פלטפורמות וערוצים

GET /{product}/platforms/all/channels
שם התיאור
product מזהה מוצר.

מזהי פלטפורמה

התיאור ערך
כל הפלטפורמות all
Windows win
Windows (64 סיביות) win64
Mac mac
Mac (ARM64) mac_arm64
Linux linux
Android android
WebView webview
iOS ios
לקרוס lacros

ערוץ

למידע נוסף על ערוצי Chrome, ראו איך בוחרים באיזה ערוץ להשתמש?.

קבלת הערוצים החוקיים של הפלטפורמה

מציין את הערוצים החוקיים לפלטפורמה נתונה:

GET /{product}/platforms/{platform}/channels
שם התיאור
product מזהה מוצר.
platform מזהה פלטפורמה.

מזהי ערוצים

VersionHistory API תומך במזהי הערוצים הבאים:

התיאור ערך
יציבות מורחבת extended
אורווה stable
בטא beta
פיתוח dev
האיים הקנריים canary
Canary (גרסת build) canary_asan

סינון התוצאות

צריך להוסיף פרמטר שאילתה filter כדי לסנן את התוצאות. רק נקודות הקצה בגרסה והגרסה תומכות בסינון. דוגמה:

GET /chrome/platforms/win/channels/stable/versions/all/releases?filter=fraction=1

הערך של filter צריך להיות רשימת ביטויים שמופרדים בפסיקים. כל ביטוי צריך להיות בפורמט field operator value.

פריט ערכים חוקיים
שדה version, name, platform, starttime*, endtime*, fraction*
מפעיל <, <=, =, >, >=
  • סינון הערוצים מתבצע לפי המרחק מהדף היציב. במילים אחרות, stable < beta < dev < canary < canary_asan. לדוגמה, הפונקציה channel<=dev מחזירה נתונים של stable, beta ו-dev.
  • סינון הגרסאות מתבצע באופן מספרי, לדוגמה 1.0.0.8 < 1.0.0.10. אם גרסה לא נכתבה במלואה, השדות החסרים בהיסטוריית הגרסאות מצרפת את 0. לדוגמה, version>80 הופך ל-version>80.0.0.0.
  • מסננים של endtime=none לגרסאות פעילות שכבר פעילות ועדיין לא הוגדרה להן שעת סיום.
  • כשמסננים לפי starttime או endtime, הערך צריך להיות בפורמט של מחרוזת תאריך RFC 3339.
  • הערכים name ו-platform מסוננים לפי השוואת מחרוזות.
  • בגרסאות ש-Chrome עדיין מציג, לא יאוכלס השדה serving.endtime. במהלך ההזמנה או הסינון, המערכת תתייחס ל-serving.endtime בתור 1970-01-01T00:00:00Z אם השדה לא מאוכלס.
  • fraction משמש לציון מספר המשתמשים שהיו מעורבים בהשקה. לדוגמה, המשמעות של fraction=1 היא 100% מהמשתמשים.

תוצאות ההזמנות

צריך להוסיף פרמטר שאילתה order_by כדי לסדר את התוצאות. רק נקודות הקצה בגרסה והגרסה תומכות בהזמנה. דוגמה:

GET /chrome/platforms/win/channels/stable/versions/all/releases?order_by=starttime

ב-order_by אפשר להשתמש ברשימה מופרדת בפסיקים של הערכים הבאים: version, name, platform, channel, starttime, endtime, fraction.

כדי לציין סידור עולה או יורד, צריך להוסיף תו רווח (%20) ואחריו asc או desc אחרי הערך order_by. דוגמה:

GET /chrome/platforms/win/channels/stable/versions/all/releases?order_by=starttime%20asc
  • סידור הערוצים מתבצע לפי הסדר הבא: stable, beta, dev, canary, canary_asan.
  • מיון לפי name עלול לגרום להתנהגות בלתי צפויה כי זהו מיון מחרוזת נאיב. לדוגמה, הערך 1.0.0.8 יהיה לפני 1.0.0.10 בסדר יורד.
  • אם לא צוין order_by, סדר ברירת המחדל הוא platform, channel, version ואז serving.starttime.