Method: customers.getSubscriptionInfo

รับข้อมูลการสมัครใช้บริการและใบอนุญาตที่รวบรวมไว้สำหรับลูกค้าที่ระบุเป็นทรัพยากร Singleton หมายเหตุ: เนื่องจากระบบจะสร้างข้อมูลเป็น Snapshot สำหรับอุปกรณ์ ChromeOS ตัวเลขที่แน่นอนจึงอาจล่าช้าได้สูงสุด 10 วินาที

คำขอ HTTP

GET https://chromemanagement.googleapis.com/v1/{name=customers/*/subscriptionInfo}

URL ใช้ไวยากรณ์การแปลงรหัส gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
name

string

ต้องระบุ ชื่อทรัพยากรของข้อมูลการสมัครใช้บริการของลูกค้าที่จะดึงข้อมูล รูปแบบ: customers/{customer}/subscriptionInfo

เนื้อหาของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

ทรัพยากร Singleton ที่แสดงข้อมูลการสมัครใช้บริการและใบอนุญาตสำหรับลูกค้าที่ระบุ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON
{
  "name": string,
  "chromeEnterpriseUpgradeAnnual": {
    object (AnnualSubscriptionInfo)
  },
  "kioskSignageUpgradeAnnual": {
    object (AnnualSubscriptionInfo)
  },
  "chromePerpetualUpgrade": {
    object (PerpetualLicenseInfo)
  }
}
ช่อง
name

string

ตัวระบุ ชื่อทรัพยากรของข้อมูลการสมัครใช้บริการของลูกค้า รูปแบบ: customers/{customer}/subscriptionInfo

chromeEnterpriseUpgradeAnnual

object (AnnualSubscriptionInfo)

เอาต์พุตเท่านั้น รายละเอียดสำหรับ Chrome Enterprise Upgrade Annual SKU

kioskSignageUpgradeAnnual

object (AnnualSubscriptionInfo)

เอาต์พุตเท่านั้น รายละเอียดสำหรับ Kiosk &Signage Upgrade Annual SKU

chromePerpetualUpgrade

object (PerpetualLicenseInfo)

เอาต์พุตเท่านั้น รายละเอียดสำหรับ Chrome Ent/Edu Upgrade Perpetual SKU

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/chrome.management.subscriptions.readonly

AnnualSubscriptionInfo

ข้อมูลสำหรับการสมัครใช้บริการ/ใบอนุญาตที่เกิดขึ้นซ้ำรายปี

การแสดง JSON
{
  "counts": {
    object (LicenseCounts)
  },
  "subscriptionEndTime": string
}
ช่อง
counts

object (LicenseCounts)

เอาต์พุตเท่านั้น จำนวนใบอนุญาตสำหรับการสมัครใช้บริการนี้

subscriptionEndTime

string (Timestamp format)

เอาต์พุตเท่านั้น วันที่ที่ระยะเวลาการสมัครใช้บริการปัจจุบันสิ้นสุดลง

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

LicenseCounts

จำนวนทรัพยากรสำหรับใบอนุญาตประเภทหนึ่งๆ

การแสดง JSON
{
  "totalPurchasedCount": string,
  "assignedCount": string,
  "unassignedCount": string
}
ช่อง
totalPurchasedCount

string (int64 format)

เอาต์พุตเท่านั้น จำนวนใบอนุญาตทั้งหมดที่ซื้อ

assignedCount

string (int64 format)

เอาต์พุตเท่านั้น จำนวนใบอนุญาตทั้งหมดที่กำหนดให้กับผู้ใช้หรืออุปกรณ์ในปัจจุบัน

unassignedCount

string (int64 format)

เอาต์พุตเท่านั้น จำนวนใบอนุญาตทั้งหมดที่พร้อมกำหนด

PerpetualLicenseInfo

ข้อมูลสำหรับใบอนุญาตตลอดชีพ

การแสดง JSON
{
  "counts": {
    object (LicenseCounts)
  },
  "retiredCount": string,
  "conditionallyAvailableCount": string
}
ช่อง
counts

object (LicenseCounts)

เอาต์พุตเท่านั้น จำนวนใบอนุญาตสำหรับ Perpetual SKU

retiredCount

string (int64 format)

เอาต์พุตเท่านั้น จำนวนการอัปเกรดตลอดชีพที่ซื้อไว้แต่ไม่พร้อมให้ลงทะเบียนอีกต่อไป การอัปเกรดเหล่านี้เป็นการอัปเกรดตลอดชีพที่ลงทะเบียนไว้ในอุปกรณ์ที่เลิกใช้งานไปแล้ว และไม่สามารถโอนหรือนำกลับมาใช้ในอุปกรณ์อื่นได้ ใบอนุญาตที่เลิกใช้งานแล้วเป็นส่วนย่อยของจำนวนทั้งหมดที่กำหนด

conditionallyAvailableCount

string (int64 format)

เอาต์พุตเท่านั้น จำนวนการอัปเกรดตลอดชีพแบบสแตนด์อโลนที่ลงทะเบียนไว้ก่อนหน้านี้และยกเลิกการลงทะเบียนในภายหลังเนื่องจากเหตุผลด้าน RMA, การรับประกัน หรือการซ่อมแซม และพร้อมให้นำกลับมาใช้อีกครั้งในอุปกรณ์รุ่นเดียวกันเท่านั้น ใบอนุญาตที่พร้อมใช้งานแบบมีเงื่อนไขเป็นส่วนย่อยของจำนวนทั้งหมดที่กำหนด