เอกสารอ้างอิงของ VersionHistory API

หน้านี้มีข้อมูลอ้างอิงทางเทคนิคเกี่ยวกับ 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