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

इस पेज पर, 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 या Fuchcia Web Engine जैसे सॉफ़्टवेयर का हिस्सा होता है.

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

ब्यौरा वैल्यू
Chrome chrome
Fuchcia वेब इंजन 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 प्लैटफ़ॉर्म आइडेंटिफ़ायर.

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

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

ब्यौरा वैल्यू
एक्सटेंडेड स्टेबल 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. अगर किसी वर्शन को पूरी तरह से नहीं लिखा गया है, तो Versionइतिहास उन फ़ील्ड के लिए 0 को जोड़ देता है जो मौजूद नहीं हैं. उदाहरण के लिए, version>80, version>80.0.0.0 हो जाता है.
  • ऐसी रिलीज़ के लिए endtime=none फ़िल्टर जो अभी लाइव हैं और जिनके खत्म होने का समय अभी तक तय नहीं किया गया है.
  • starttime या endtime के हिसाब से फ़िल्टर करने पर, वैल्यू आरएफ़सी 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 वैल्यू के बाद asc या desc स्पेस वर्ण (%20) जोड़ें. उदाहरण:

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 होता है.