Method: customers.getSubscriptionInfo

Recupera le informazioni aggregate su abbonamenti e licenze per un determinato cliente come risorsa singleton. Nota: poiché i dati vengono acquisiti tramite snapshot per i dispositivi ChromeOS, i numeri esatti possono essere ritardati fino a 10 secondi.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

Obbligatorio. Il nome della risorsa delle informazioni sull'abbonamento del cliente da recuperare. Formato: customers/{customer}/subscriptionInfo

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Risorsa singleton che rappresenta le informazioni sull'abbonamento e sulla licenza per un determinato cliente.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

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

string

Identificatore. Il nome della risorsa delle informazioni sull'abbonamento del cliente. Formato: customers/{customer}/subscriptionInfo

chromeEnterpriseUpgradeAnnual

object (AnnualSubscriptionInfo)

Solo output. Dettagli per lo SKU annuale di Chrome Enterprise Upgrade.

kioskSignageUpgradeAnnual

object (AnnualSubscriptionInfo)

Solo output. Dettagli per lo SKU annuale di Kiosk &Signage Upgrade.

chromePerpetualUpgrade

object (PerpetualLicenseInfo)

Solo output. Dettagli per lo SKU perpetuo di Chrome Enterprise/Education Upgrade.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

AnnualSubscriptionInfo

Informazioni per abbonamenti/licenze con rinnovo annuale.

Rappresentazione JSON
{
  "counts": {
    object (LicenseCounts)
  },
  "subscriptionEndTime": string
}
Campi
counts

object (LicenseCounts)

Solo output. Conteggio delle licenze per questo abbonamento.

subscriptionEndTime

string (Timestamp format)

Solo output. La data di fine del periodo di abbonamento corrente.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

LicenseCounts

Conteggio delle risorse per un tipo di licenza specifico.

Rappresentazione JSON
{
  "totalPurchasedCount": string,
  "assignedCount": string,
  "unassignedCount": string
}
Campi
totalPurchasedCount

string (int64 format)

Solo output. Numero totale di licenze acquistate.

assignedCount

string (int64 format)

Solo output. Numero totale di licenze attualmente assegnate a utenti o dispositivi.

unassignedCount

string (int64 format)

Solo output. Numero totale di licenze disponibili per l'assegnazione.

PerpetualLicenseInfo

Informazioni per le licenze perpetue.

Rappresentazione JSON
{
  "counts": {
    object (LicenseCounts)
  },
  "retiredCount": string,
  "conditionallyAvailableCount": string
}
Campi
counts

object (LicenseCounts)

Solo output. Conteggio delle licenze per lo SKU perpetuo.

retiredCount

string (int64 format)

Solo output. Numero di upgrade perpetui acquistati, ma non più disponibili per la registrazione. Si tratta di upgrade perpetui che sono stati registrati su un dispositivo nel frattempo ritirato e che non possono essere trasferiti o riutilizzati su un altro dispositivo. Le licenze ritirate sono un sottoinsieme del totale Assegnati.

conditionallyAvailableCount

string (int64 format)

Solo output. Numero di upgrade perpetui autonomi la cui precedente registrazione è stata annullata in un secondo momento per motivi di RMA, garanzia o riparazione; possono essere riutilizzati solo su un dispositivo dello stesso modello. Le licenze disponibili con condizioni sono un sottoinsieme del totale Assegnati.