Method: customers.getSubscriptionInfo

Obtiene la información agregada de la suscripción y la licencia de un cliente determinado como un recurso singleton. Nota: Debido a que los datos se capturan para los dispositivos ChromeOS, los números exactos pueden demorar hasta 10 segundos.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
name

string

Obligatorio. El nombre del recurso de la información de la suscripción del cliente que se recuperará. Formato: customers/{customer}/subscriptionInfo

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Recurso singleton que representa la información de la suscripción y la licencia de un cliente determinado.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON
{
  "name": string,
  "chromeEnterpriseUpgradeAnnual": {
    object (AnnualSubscriptionInfo)
  },
  "kioskSignageUpgradeAnnual": {
    object (AnnualSubscriptionInfo)
  },
  "chromePerpetualUpgrade": {
    object (PerpetualLicenseInfo)
  }
}
Campos
name

string

Es el identificador. El nombre del recurso de la información de la suscripción del cliente. Formato: customers/{customer}/subscriptionInfo

chromeEnterpriseUpgradeAnnual

object (AnnualSubscriptionInfo)

Solo salida. Detalles del SKU anual de la actualización de Chrome Enterprise.

kioskSignageUpgradeAnnual

object (AnnualSubscriptionInfo)

Solo salida. Detalles del SKU anual de la actualización de Kiosk &Signage.

chromePerpetualUpgrade

object (PerpetualLicenseInfo)

Solo salida. Detalles del SKU perpetuo de la actualización de Chrome Ent/Edu.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

AnnualSubscriptionInfo

Información sobre las suscripciones o licencias recurrentes anuales.

Representación JSON
{
  "counts": {
    object (LicenseCounts)
  },
  "subscriptionEndTime": string
}
Campos
counts

object (LicenseCounts)

Solo salida. Recuentos de licencias para esta suscripción.

subscriptionEndTime

string (Timestamp format)

Solo salida. La fecha en que finaliza el período de suscripción actual.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

LicenseCounts

Recuentos de recursos para un tipo de licencia específico.

Representación JSON
{
  "totalPurchasedCount": string,
  "assignedCount": string,
  "unassignedCount": string
}
Campos
totalPurchasedCount

string (int64 format)

Solo salida. Cantidad total de licencias compradas.

assignedCount

string (int64 format)

Solo salida. Cantidad total de licencias asignadas actualmente a usuarios o dispositivos.

unassignedCount

string (int64 format)

Solo salida. Cantidad total de licencias disponibles para la asignación.

PerpetualLicenseInfo

Información sobre las licencias perpetuas.

Representación JSON
{
  "counts": {
    object (LicenseCounts)
  },
  "retiredCount": string,
  "conditionallyAvailableCount": string
}
Campos
counts

object (LicenseCounts)

Solo salida. Recuentos de licencias para el SKU perpetuo.

retiredCount

string (int64 format)

Solo salida. Cantidad de actualizaciones perpetuas que se compraron, pero ya no están disponibles para la inscripción. Son actualizaciones perpetuas que se inscribieron en un dispositivo que se retiró y no se pueden transferir ni volver a usar en otro dispositivo. Las licencias retiradas son un subconjunto del total de Asignadas.

conditionallyAvailableCount

string (int64 format)

Solo salida. Cantidad de actualizaciones perpetuas independientes que se inscribieron anteriormente y, luego, se desaprovisionaron por motivos de ADP, garantía o reparación, y solo están disponibles para reutilizarse en un dispositivo del mismo modelo. Las licencias disponibles de forma condicional son un subconjunto del total de Asignadas.