หน้านี้มีข้อมูลอ้างอิงทางเทคนิคเกี่ยวกับ 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 | 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 |
ตัวระบุแพลตฟอร์ม |
ตัวระบุช่อง
VersionHistory API รองรับตัวระบุช่องต่อไปนี้
คำอธิบาย | ค่า |
---|---|
เวอร์ชันเสถียรเพิ่มเติม | extended |
คงที่ | stable |
เบต้า | beta |
กำลังพัฒนา | dev |
คะแนรี | canary |
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
เพิ่มเว้นวรรค (%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