เอกสารอ้างอิงของ 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 Web Engine 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