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

इस पेज में, Versionइतिहास वेब सर्विस एपीआई के बारे में तकनीकी रेफ़रंस जानकारी मौजूद है.

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

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

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

कंपनी का ब्यौरा वैल्यू
एक्सटेंडेड स्टेबल extended
स्थिर दिखाना stable
बीटा वर्शन beta
डेव dev
कैनेरी canary
कैनरी (वैरिएंट बिल्ड) 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. अगर किसी वर्शन को पूरी तरह से नहीं लिखा गया है, तो VersionHistory, उन फ़ील्ड के लिए 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.

बढ़ते या घटते क्रम में बताने के लिए, 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 होता है.