Method: customers.getSubscriptionInfo

Ruft die aggregierten Abo- und Lizenzinformationen für einen bestimmten Kunden als einzelne Ressource ab. Hinweis: Da die Daten für ChromeOS-Geräte als Snapshot erfasst werden, kann es bis zu 10 Sekunden dauern, bis die genauen Zahlen angezeigt werden.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Erforderlich. Der Ressourcenname der abzurufenden Informationen zum Kundenabo. Format: customers/{customer}/subscriptionInfo

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Einzelne Ressource, die die Abo- und Lizenzinformationen für einen bestimmten Kunden darstellt.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung
{
  "name": string,
  "chromeEnterpriseUpgradeAnnual": {
    object (AnnualSubscriptionInfo)
  },
  "kioskSignageUpgradeAnnual": {
    object (AnnualSubscriptionInfo)
  },
  "chromePerpetualUpgrade": {
    object (PerpetualLicenseInfo)
  }
}
Felder
name

string

ID. Der Ressourcenname der Informationen zum Kundenabo. Format: customers/{customer}/subscriptionInfo

chromeEnterpriseUpgradeAnnual

object (AnnualSubscriptionInfo)

Nur Ausgabe. Details zur Chrome Enterprise-Upgrade-Jahres-SKU.

kioskSignageUpgradeAnnual

object (AnnualSubscriptionInfo)

Nur Ausgabe. Details zur Kiosk &Signage Upgrade-Jahres-SKU.

chromePerpetualUpgrade

object (PerpetualLicenseInfo)

Nur Ausgabe. Details zur Chrome Enterprise/Education-Upgrade-SKU (unbefristet).

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

AnnualSubscriptionInfo

Informationen zu jährlich wiederkehrenden Abos/Lizenzen.

JSON-Darstellung
{
  "counts": {
    object (LicenseCounts)
  },
  "subscriptionEndTime": string
}
Felder
counts

object (LicenseCounts)

Nur Ausgabe. Anzahl der Lizenzen für dieses Abo.

subscriptionEndTime

string (Timestamp format)

Nur Ausgabe. Das Datum, an dem der aktuelle Abozeitraum endet.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

LicenseCounts

Anzahl der Ressourcen für einen bestimmten Lizenztyp.

JSON-Darstellung
{
  "totalPurchasedCount": string,
  "assignedCount": string,
  "unassignedCount": string
}
Felder
totalPurchasedCount

string (int64 format)

Nur Ausgabe. Gesamtzahl der erworbenen Lizenzen.

assignedCount

string (int64 format)

Nur Ausgabe. Gesamtzahl der Lizenzen, die derzeit Nutzern oder Geräten zugewiesen sind.

unassignedCount

string (int64 format)

Nur Ausgabe. Gesamtzahl der Lizenzen, die zugewiesen werden können.

PerpetualLicenseInfo

Informationen zu unbefristeten Lizenzen.

JSON-Darstellung
{
  "counts": {
    object (LicenseCounts)
  },
  "retiredCount": string,
  "conditionallyAvailableCount": string
}
Felder
counts

object (LicenseCounts)

Nur Ausgabe. Anzahl der Lizenzen für die unbefristete SKU.

retiredCount

string (int64 format)

Nur Ausgabe. Anzahl der unbefristeten Upgrades, die gekauft wurden, aber nicht mehr für eine Registrierung verfügbar sind. Das sind unbefristete Upgrades, die für Geräte registriert wurden, die inzwischen nicht mehr verwendet werden. Die Upgrades können nicht auf andere Geräte übertragen oder wiederverwendet werden. Zurückgezogene Lizenzen sind in der Gesamtzahl unter Zugewiesen enthalten.

conditionallyAvailableCount

string (int64 format)

Nur Ausgabe. Anzahl der eigenständigen unbefristeten Upgrades, die zuvor registriert und später aus RMA-, Garantie- oder Reparaturgründen wieder abgemeldet wurden. Sie können nur auf einem Gerät desselben Modells wiederverwendet werden. Bedingt verfügbare Lizenzen sind eine Teilmenge der Summe unter Zugewiesen.