Method: customers.getSubscriptionInfo

Mendapatkan informasi langganan dan lisensi gabungan untuk pelanggan tertentu sebagai resource singleton. Catatan: Karena data diambil snapshot-nya untuk perangkat ChromeOS, angka pastinya dapat tertunda hingga 10 detik.

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
name

string

Wajib. Nama resource info langganan pelanggan yang akan diambil. Format: customers/{customer}/subscriptionInfo

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Resource singleton yang merepresentasikan informasi langganan dan lisensi untuk pelanggan tertentu.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON
{
  "name": string,
  "chromeEnterpriseUpgradeAnnual": {
    object (AnnualSubscriptionInfo)
  },
  "kioskSignageUpgradeAnnual": {
    object (AnnualSubscriptionInfo)
  },
  "chromePerpetualUpgrade": {
    object (PerpetualLicenseInfo)
  }
}
Kolom
name

string

ID. Nama resource info langganan pelanggan. Format: customers/{customer}/subscriptionInfo

chromeEnterpriseUpgradeAnnual

object (AnnualSubscriptionInfo)

Hanya output. Detail untuk SKU Tahunan Chrome Enterprise Upgrade.

kioskSignageUpgradeAnnual

object (AnnualSubscriptionInfo)

Hanya output. Detail untuk SKU Tahunan Kiosk & Signage Upgrade.

chromePerpetualUpgrade

object (PerpetualLicenseInfo)

Hanya output. Detail untuk SKU Permanen Chrome Enterprise/Education Upgrade.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

AnnualSubscriptionInfo

Informasi untuk langganan/lisensi yang berulang setiap tahun.

Representasi JSON
{
  "counts": {
    object (LicenseCounts)
  },
  "subscriptionEndTime": string
}
Kolom
counts

object (LicenseCounts)

Hanya output. Jumlah lisensi untuk langganan ini.

subscriptionEndTime

string (Timestamp format)

Hanya output. Tanggal berakhirnya periode langganan saat ini.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

LicenseCounts

Jumlah resource untuk jenis lisensi tertentu.

Representasi JSON
{
  "totalPurchasedCount": string,
  "assignedCount": string,
  "unassignedCount": string
}
Kolom
totalPurchasedCount

string (int64 format)

Hanya output. Jumlah total lisensi yang dibeli.

assignedCount

string (int64 format)

Hanya output. Jumlah total lisensi yang saat ini ditetapkan kepada pengguna atau perangkat.

unassignedCount

string (int64 format)

Hanya output. Jumlah total lisensi yang tersedia untuk penetapan.

PerpetualLicenseInfo

Informasi untuk lisensi abadi.

Representasi JSON
{
  "counts": {
    object (LicenseCounts)
  },
  "retiredCount": string,
  "conditionallyAvailableCount": string
}
Kolom
counts

object (LicenseCounts)

Hanya output. Jumlah lisensi untuk SKU abadi.

retiredCount

string (int64 format)

Hanya output. Jumlah upgrade permanen yang telah dibeli tetapi tidak lagi tersedia untuk pendaftaran. Ini adalah upgrade permanen yang terdaftar di perangkat yang telah dihentikan penggunaannya. Upgrade ini tidak dapat ditransfer atau digunakan kembali di perangkat lain. Lisensi yang tidak digunakan lagi adalah bagian dari total Lisensi yang ditetapkan.

conditionallyAvailableCount

string (int64 format)

Hanya output. Jumlah upgrade permanen mandiri yang sebelumnya didaftarkan dan kemudian dibatalkan pendaftarannya karena alasan RMA, garansi, atau perbaikan, dan hanya tersedia untuk digunakan kembali pada perangkat dengan model yang sama. Lisensi yang tersedia secara bersyarat adalah bagian dari total lisensi yang Ditetapkan.