Method: customers.getSubscriptionInfo

Obtient les informations agrégées sur les abonnements et les licences d'un client donné en tant que ressource singleton. Remarque : Étant donné que les données sont instantanées pour les appareils ChromeOS, les chiffres exacts peuvent être retardés de 10 secondes au maximum.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

Obligatoire. Nom de ressource des informations sur l'abonnement client à récupérer. Format: customers/{customer}/subscriptionInfo

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Ressource singleton représentant les informations sur l'abonnement et la licence d'un client donné.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON
{
  "name": string,
  "chromeEnterpriseUpgradeAnnual": {
    object (AnnualSubscriptionInfo)
  },
  "kioskSignageUpgradeAnnual": {
    object (AnnualSubscriptionInfo)
  },
  "chromePerpetualUpgrade": {
    object (PerpetualLicenseInfo)
  }
}
Champs
name

string

Identifiant. Nom de ressource des informations sur l'abonnement client. Format : customers/{customer}/subscriptionInfo

chromeEnterpriseUpgradeAnnual

object (AnnualSubscriptionInfo)

Uniquement en sortie. Informations sur le SKU annuel Chrome Enterprise Upgrade.

kioskSignageUpgradeAnnual

object (AnnualSubscriptionInfo)

Uniquement en sortie. Informations sur le SKU annuel Kiosk &Signage Upgrade.

chromePerpetualUpgrade

object (PerpetualLicenseInfo)

Uniquement en sortie. Informations sur le SKU permanent Chrome Ent/Edu Upgrade.

Niveaux d'accès des autorisations

Requiert le niveau d'accès OAuth suivant :

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

AnnualSubscriptionInfo

Informations sur les abonnements/licences récurrents annuels.

Représentation JSON
{
  "counts": {
    object (LicenseCounts)
  },
  "subscriptionEndTime": string
}
Champs
counts

object (LicenseCounts)

Uniquement en sortie. Nombre de licences pour cet abonnement.

subscriptionEndTime

string (Timestamp format)

Uniquement en sortie. Date de fin de la période d'abonnement en cours.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

LicenseCounts

Nombre de ressources pour un type de licence spécifique.

Représentation JSON
{
  "totalPurchasedCount": string,
  "assignedCount": string,
  "unassignedCount": string
}
Champs
totalPurchasedCount

string (int64 format)

Uniquement en sortie. Nombre total de licences achetées.

assignedCount

string (int64 format)

Uniquement en sortie. Nombre total de licences actuellement attribuées à des utilisateurs ou à des appareils.

unassignedCount

string (int64 format)

Uniquement en sortie. Nombre total de licences pouvant être attribuées.

PerpetualLicenseInfo

Informations sur les licences permanentes.

Représentation JSON
{
  "counts": {
    object (LicenseCounts)
  },
  "retiredCount": string,
  "conditionallyAvailableCount": string
}
Champs
counts

object (LicenseCounts)

Uniquement en sortie. Nombre de licences pour le SKU permanent.

retiredCount

string (int64 format)

Uniquement en sortie. Nombre de licences permanentes achetées, mais qui ne sont plus disponibles pour l'enregistrement. Il s'agit de licences permanentes qui ont été enregistrées sur un appareil qui a été supprimé depuis, et qui ne peuvent pas être transférées ni réutilisées sur un autre appareil. Les licences supprimées correspondent à un sous-ensemble du nombre total de licences attribuées.

conditionallyAvailableCount

string (int64 format)

Uniquement en sortie. Nombre de licences permanentes autonomes qui ont déjà été enregistrées et désenregistrées pour des raisons liées à une ARM, à une garantie ou à une réparation, et qui ne peuvent être réutilisées que sur un appareil du même modèle. Les licences disponibles sous conditions correspondent à un sous-ensemble du nombre total de licences attribuées.