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

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

כל הגישה ל-API מתבצעת באמצעות HTTPS, והגישה אליה מתבצעת מ-https://versionhistory.googleapis.com/v1.

גרסה

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

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

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

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

פריט תוכן

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

קבלת כל הגרסאות

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

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

מוצר

מוצר הוא קטע תוכנה כמו Chrome או Fuchsia Web Engine.

מזהי מוצרים

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

פלטפורמה

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

הצגת כל הפלטפורמות

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

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

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

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

תיאור ערך של Gpa education
כל הפלטפורמות 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 מזהה פלטפורמה.

מזהי הערוץ

ה-API של היסטוריית הגרסאות תומך במזהי הערוצים הבאים:

תיאור ערך של Gpa education
יציב מורחב extended
אורווה stable
בטא beta
פיתוח dev
האיים הקנריים canary
גרסה ראשונית (builder) 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.