- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- เนื้อหาของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- AnnualSubscriptionInfo
- LicenseCounts
- PerpetualLicenseInfo
- ลองใช้งาน
รับข้อมูลการสมัครใช้บริการและใบอนุญาตที่รวบรวมไว้สำหรับลูกค้าที่ระบุเป็นทรัพยากร Singleton หมายเหตุ: เนื่องจากระบบจะสร้างข้อมูลเป็น Snapshot สำหรับอุปกรณ์ ChromeOS ตัวเลขที่แน่นอนจึงอาจล่าช้าได้สูงสุด 10 วินาที
คำขอ HTTP
GET https://chromemanagement.googleapis.com/v1/{name=customers/*/subscriptionInfo}
URL ใช้ไวยากรณ์การแปลงรหัส gRPC
พารามิเตอร์เส้นทาง
| พารามิเตอร์ | |
|---|---|
name |
ต้องระบุ ชื่อทรัพยากรของข้อมูลการสมัครใช้บริการของลูกค้าที่จะดึงข้อมูล รูปแบบ: customers/{customer}/subscriptionInfo |
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
ทรัพยากร Singleton ที่แสดงข้อมูลการสมัครใช้บริการและใบอนุญาตสำหรับลูกค้าที่ระบุ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
| การแสดง JSON |
|---|
{ "name": string, "chromeEnterpriseUpgradeAnnual": { object ( |
| ช่อง | |
|---|---|
name |
ตัวระบุ ชื่อทรัพยากรของข้อมูลการสมัครใช้บริการของลูกค้า รูปแบบ: customers/{customer}/subscriptionInfo |
chromeEnterpriseUpgradeAnnual |
เอาต์พุตเท่านั้น รายละเอียดสำหรับ Chrome Enterprise Upgrade Annual SKU |
kioskSignageUpgradeAnnual |
เอาต์พุตเท่านั้น รายละเอียดสำหรับ Kiosk &Signage Upgrade Annual SKU |
chromePerpetualUpgrade |
เอาต์พุตเท่านั้น รายละเอียดสำหรับ Chrome Ent/Edu Upgrade Perpetual SKU |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/chrome.management.subscriptions.readonly
AnnualSubscriptionInfo
ข้อมูลสำหรับการสมัครใช้บริการ/ใบอนุญาตที่เกิดขึ้นซ้ำรายปี
| การแสดง JSON |
|---|
{
"counts": {
object ( |
| ช่อง | |
|---|---|
counts |
เอาต์พุตเท่านั้น จำนวนใบอนุญาตสำหรับการสมัครใช้บริการนี้ |
subscriptionEndTime |
เอาต์พุตเท่านั้น วันที่ที่ระยะเวลาการสมัครใช้บริการปัจจุบันสิ้นสุดลง ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น |
LicenseCounts
จำนวนทรัพยากรสำหรับใบอนุญาตประเภทหนึ่งๆ
| การแสดง JSON |
|---|
{ "totalPurchasedCount": string, "assignedCount": string, "unassignedCount": string } |
| ช่อง | |
|---|---|
totalPurchasedCount |
เอาต์พุตเท่านั้น จำนวนใบอนุญาตทั้งหมดที่ซื้อ |
assignedCount |
เอาต์พุตเท่านั้น จำนวนใบอนุญาตทั้งหมดที่กำหนดให้กับผู้ใช้หรืออุปกรณ์ในปัจจุบัน |
unassignedCount |
เอาต์พุตเท่านั้น จำนวนใบอนุญาตทั้งหมดที่พร้อมกำหนด |
PerpetualLicenseInfo
ข้อมูลสำหรับใบอนุญาตตลอดชีพ
| การแสดง JSON |
|---|
{
"counts": {
object ( |
| ช่อง | |
|---|---|
counts |
เอาต์พุตเท่านั้น จำนวนใบอนุญาตสำหรับ Perpetual SKU |
retiredCount |
เอาต์พุตเท่านั้น จำนวนการอัปเกรดตลอดชีพที่ซื้อไว้แต่ไม่พร้อมให้ลงทะเบียนอีกต่อไป การอัปเกรดเหล่านี้เป็นการอัปเกรดตลอดชีพที่ลงทะเบียนไว้ในอุปกรณ์ที่เลิกใช้งานไปแล้ว และไม่สามารถโอนหรือนำกลับมาใช้ในอุปกรณ์อื่นได้ ใบอนุญาตที่เลิกใช้งานแล้วเป็นส่วนย่อยของจำนวนทั้งหมดที่กำหนด |
conditionallyAvailableCount |
เอาต์พุตเท่านั้น จำนวนการอัปเกรดตลอดชีพแบบสแตนด์อโลนที่ลงทะเบียนไว้ก่อนหน้านี้และยกเลิกการลงทะเบียนในภายหลังเนื่องจากเหตุผลด้าน RMA, การรับประกัน หรือการซ่อมแซม และพร้อมให้นำกลับมาใช้อีกครั้งในอุปกรณ์รุ่นเดียวกันเท่านั้น ใบอนุญาตที่พร้อมใช้งานแบบมีเงื่อนไขเป็นส่วนย่อยของจำนวนทั้งหมดที่กำหนด |