בדף הזה תמצאו מידע טכני על ממשק ה-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
.