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