वर्शनइतिहास एपीआई का रेफ़रंस

इस पेज पर, VersionHistory वेब सेवा एपीआई के बारे में तकनीकी रेफ़रंस जानकारी दी गई है.

सभी एपीआई को एचटीटीपीएस के ज़रिए ऐक्सेस किया जाता है और 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 वेब इंजन.

प्रॉडक्ट आइडेंटिफ़ायर

ब्यौरा मान
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 lacros

चैनल

Chrome के चैनलों के बारे में जानने के लिए, मुझे किस चैनल का इस्तेमाल करना है, यह कैसे तय करें? लेख पढ़ें.

किसी प्लैटफ़ॉर्म के मान्य चैनल पाना

किसी प्लैटफ़ॉर्म के लिए मान्य चैनलों की सूची दिखाता है:

GET /{product}/platforms/{platform}/channels
नाम ब्यौरा
product प्रॉडक्ट आइडेंटिफ़ायर.
platform प्लैटफ़ॉर्म आइडेंटिफ़ायर.

चैनल आइडेंटिफ़ायर

VersionHistory API, चैनल के इन आइडेंटिफ़ायर के साथ काम करता है:

ब्यौरा मान
एक्सटेंडेड स्टेबल extended
स्थिर रुझान stable
बीटा beta
डेवलपर dev
कैनेरी canary
कैनरी (वैरिएंट बिल्ड) 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 जोड़ा जाता है. उदाहरण के लिए, 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.

बढ़ते या घटते क्रम में लगाने के लिए, order_by वैल्यू के बाद स्पेस वर्ण (%20) और फिर asc या desc जोड़ें. उदाहरण:

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 के हिसाब से होगा.