Method: customers.getSubscriptionInfo

Pobiera zbiorcze informacje o subskrypcji i licencjach danego klienta jako zasób singleton. Uwaga: ponieważ dane są zapisywane w postaci migawek na urządzeniach z ChromeOS, dokładne liczby mogą być opóźnione o maksymalnie 10 sekund.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
name

string

Wymagane. Nazwa zasobu informacji o subskrypcji klienta, które mają zostać pobrane. Format: customers/{customer}/subscriptionInfo

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Zasób singleton reprezentujący informacje o subskrypcji i licencjach danego klienta.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

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

string

Identyfikator. Nazwa zasobu informacji o subskrypcji klienta. Format: customers/{customer}/subscriptionInfo

chromeEnterpriseUpgradeAnnual

object (AnnualSubscriptionInfo)

Tylko dane wyjściowe. Szczegóły rocznej licencji na Chrome Enterprise.

kioskSignageUpgradeAnnual

object (AnnualSubscriptionInfo)

Tylko dane wyjściowe. Szczegóły rocznej licencji na kioski i znaki.

chromePerpetualUpgrade

object (PerpetualLicenseInfo)

Tylko dane wyjściowe. Szczegóły bezterminowej licencji na Chrome Enterprise/Education.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

AnnualSubscriptionInfo

Informacje o subskrypcjach i licencjach odnawianych co roku.

Zapis JSON
{
  "counts": {
    object (LicenseCounts)
  },
  "subscriptionEndTime": string
}
Pola
counts

object (LicenseCounts)

Tylko dane wyjściowe. Liczba licencji w ramach tej subskrypcji.

subscriptionEndTime

string (Timestamp format)

Tylko dane wyjściowe. Data zakończenia bieżącego okresu subskrypcji.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

LicenseCounts

Liczba zasobów dla określonego typu licencji.

Zapis JSON
{
  "totalPurchasedCount": string,
  "assignedCount": string,
  "unassignedCount": string
}
Pola
totalPurchasedCount

string (int64 format)

Tylko dane wyjściowe. Łączna liczba kupionych licencji.

assignedCount

string (int64 format)

Tylko dane wyjściowe. Łączna liczba licencji przypisanych obecnie do użytkowników lub urządzeń.

unassignedCount

string (int64 format)

Tylko dane wyjściowe. Łączna liczba licencji dostępnych do przypisania.

PerpetualLicenseInfo

Informacje o licencjach bezterminowych.

Zapis JSON
{
  "counts": {
    object (LicenseCounts)
  },
  "retiredCount": string,
  "conditionallyAvailableCount": string
}
Pola
counts

object (LicenseCounts)

Tylko dane wyjściowe. Liczba licencji w ramach bezterminowej licencji.

retiredCount

string (int64 format)

Tylko dane wyjściowe. Liczba bezterminowych licencji, które zostały zakupione, ale nie są już dostępne do zarejestrowania. Są to bezterminowe licencje zarejestrowane na urządzeniu, które zostało już wycofane, i nie można ich przenieść ani ponownie użyć na innym urządzeniu. Wycofane licencje stanowią podzbiór licencji z łącznej liczby przypisanych licencji.

conditionallyAvailableCount

string (int64 format)

Tylko dane wyjściowe. Liczba samodzielnych licencji bezterminowych, które zostały wcześniej zarejestrowane i wyrejestrowane z powodu RMA, gwarancji lub naprawy i są dostępne tylko do ponownego użycia na urządzeniu tego samego modelu. Licencje dostępne warunkowo stanowią podzbiór licencji z łącznej liczby przypisanych licencji.