Method: customers.getSubscriptionInfo

Recebe as informações agregadas de assinatura e licença de um cliente específico como um recurso singleton. Observação: como os dados são capturados para dispositivos ChromeOS, os números exatos podem ter um atraso de até 10 segundos.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
name

string

Obrigatório. O nome do recurso das informações de assinatura do cliente a serem recuperadas. Formato: customers/{customer}/subscriptionInfo

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Recurso singleton que representa as informações de assinatura e licença de um cliente específico.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON
{
  "name": string,
  "chromeEnterpriseUpgradeAnnual": {
    object (AnnualSubscriptionInfo)
  },
  "kioskSignageUpgradeAnnual": {
    object (AnnualSubscriptionInfo)
  },
  "chromePerpetualUpgrade": {
    object (PerpetualLicenseInfo)
  }
}
Campos
name

string

Identificador. O nome do recurso das informações de assinatura do cliente. Formato: customers/{customer}/subscriptionInfo

chromeEnterpriseUpgradeAnnual

object (AnnualSubscriptionInfo)

Apenas saída. Detalhes da SKU anual do Upgrade do Chrome Enterprise.

kioskSignageUpgradeAnnual

object (AnnualSubscriptionInfo)

Apenas saída. Detalhes da SKU anual do Upgrade de quiosque e sinalização.

chromePerpetualUpgrade

object (PerpetualLicenseInfo)

Apenas saída. Detalhes da SKU permanente do Upgrade do Chrome Ent/Edu.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

AnnualSubscriptionInfo

Informações sobre assinaturas/licenças recorrentes anuais.

Representação JSON
{
  "counts": {
    object (LicenseCounts)
  },
  "subscriptionEndTime": string
}
Campos
counts

object (LicenseCounts)

Apenas saída. Contagens de licenças para essa assinatura.

subscriptionEndTime

string (Timestamp format)

Apenas saída. A data em que o período de assinatura atual termina.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

LicenseCounts

Contagens de recursos para um tipo de licença específico.

Representação JSON
{
  "totalPurchasedCount": string,
  "assignedCount": string,
  "unassignedCount": string
}
Campos
totalPurchasedCount

string (int64 format)

Apenas saída. Número total de licenças compradas.

assignedCount

string (int64 format)

Apenas saída. Número total de licenças atribuídas a usuários ou dispositivos.

unassignedCount

string (int64 format)

Apenas saída. Número total de licenças disponíveis para atribuição.

PerpetualLicenseInfo

Informações sobre licenças permanentes.

Representação JSON
{
  "counts": {
    object (LicenseCounts)
  },
  "retiredCount": string,
  "conditionallyAvailableCount": string
}
Campos
counts

object (LicenseCounts)

Apenas saída. Contagens de licenças para a SKU permanente.

retiredCount

string (int64 format)

Apenas saída. Número de upgrades permanentes que foram comprados, mas não estão mais disponíveis para registro. Esses são os upgrades permanentes registrados em dispositivos que foram desativados. Eles não podem ser transferidos ou reutilizados em outros dispositivos. As licenças desativadas são um subconjunto do total de Atribuídas.

conditionallyAvailableCount

string (int64 format)

Apenas saída. Número de upgrades permanentes independentes que foram registrados e depois desativados por motivos de devolução, garantia ou reparo e só podem ser reutilizados em dispositivos do mesmo modelo. As licenças disponíveis sob certas condições são um subconjunto do total de Atribuídas.