Grouplicenses

Listę metod dla tego zasobu znajdziesz na końcu tej strony.

Reprezentacje zasobów

Obiekty licencji grupowych umożliwiają śledzenie licencji (nazywanych uprawnieniami) zarówno na bezpłatne, jak i płatne aplikacje. W przypadku bezpłatnej aplikacji licencja grupowa jest tworzona, gdy administrator firmy po raz pierwszy zatwierdzi usługę w Google Play lub gdy pierwsze uprawnienie do korzystania z usługi zostanie utworzone dla użytkownika za pomocą interfejsu API. W przypadku płatnej aplikacji obiekt licencji grupowej jest tworzony tylko wtedy, gdy administrator firmy kupuje usługę w Google Play po raz pierwszy.

Używaj interfejsu API, aby wysyłać zapytania dotyczące licencji grupowych. Zasób Grouplicenses zawiera łączną liczbę kupionych licencji (tylko płatne aplikacje) oraz łączną liczbę licencji obecnie używanych. To znaczy, że jest to łączna liczba elementów typu Entitlements dostępnych dla danego produktu.

Na każdą usługę tworzony jest tylko 1 obiekt licencji grupowej. Obiekty licencji grup nie są nigdy usuwane. Jeśli produkt nie jest zatwierdzony, jego licencja grupowa pozostaje niezmieniona. Dzięki temu administratorzy firmy mogą śledzić pozostałe uprawnienia związane z usługą.

{
  "kind": "androidenterprise#groupLicense",
  "productId": string,
  "numPurchased": integer,
  "numProvisioned": integer,
  "acquisitionKind": string,
  "approval": string,
  "permissions": string
}
nazwa usługi, Wartość Opis Notatki
acquisitionKind string Sposób pozyskania tej licencji grupowej. "bulkPurchase" oznacza, że ten zasób Grouplicenses został utworzony, ponieważ firma kupiła licencje na tę usługę. W przeciwnym razie wartość wynosi "free" (w przypadku usług bezpłatnych).

Akceptowane wartości to:
  • "bulkPurchase"
  • "free"
approval string Określa, czy usługa, której dotyczy ta licencja grupowa, jest obecnie zatwierdzona przez firmę. Produkty są zatwierdzane przy pierwszym tworzeniu licencji grupowej, ale administrator firmy może cofnąć tę zgodę w Google Play. Niezatwierdzone produkty nie będą widoczne dla użytkowników w kolekcjach, a zwykle nie należy tworzyć dla nich nowych uprawnień.

Akceptowane wartości to:
  • "approved"
  • "unapproved"
kind string
numProvisioned integer Łączna liczba udostępnionych licencji na tę usługę. Zwracany przez operacje odczytu, ale ignorowany w operacjach zapisu.
numPurchased integer Liczba kupionych licencji (najprawdopodobniej w ramach zakupu kilku licencji). Jeśli pominiesz to pole, nie ma limitu liczby licencji, które można udostępnić (na przykład jeśli rodzaj pozyskania to "free").
permissions string Stan zatwierdzenia uprawnień usługi. To pole jest ustawiane tylko wtedy, gdy produkt jest zatwierdzony. Możliwe stany:
  • „currentApproved”, bieżący zestaw uprawnień został zatwierdzony, ale dodatkowe uprawnienia będą wymagały od administratora ponownego zatwierdzenia usługi (jeśli usługa została zatwierdzona bez określenia zatwierdzonego ustawienia uprawnień, jest to działanie domyślne).
  • „needsReapproval”, usługa ma niezatwierdzone uprawnienia. Do czasu ponownego zatwierdzenia usługi nie można przypisać żadnych dodatkowych licencji na usługę.
  • „allCurrentAndFutureApproved”, bieżące uprawnienia zostały zatwierdzone, a wszelkie przyszłe zmiany uprawnień będą automatycznie zatwierdzane bez sprawdzenia przez administratora.


Akceptowane wartości:
  • "allCurrentAndFutureApproved"
  • "currentApproved"
  • "needsReapproval"
productId string Identyfikator usługi objętej licencją. Na przykład: "app:com.google.android.gm".

Metody

pobierz
Pobiera szczegóły licencji grupowej na usługę firmy.
list
Pobiera identyfikatory wszystkich usług, na które firma ma licencję grupową.