הפניה לממשק ה-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 Web Engine 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 lacros

ערוץ

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

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

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

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

מזהים של ערוצים

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

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

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

מוסיפים פרמטר של שאילתה מסוג filter כדי לסנן את התוצאות. רק נקודות הקצה version ו-release תומכות בסינון. דוגמה:

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 לשדות החסרים ב-VersionHistory. לדוגמה, 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 כדי למיין את התוצאות. רק נקודות הקצה version ו-release תומכות בסדר. דוגמה:

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.