REST Resource: enterprises.enrollmentTokens

Zasób: EnrollmentToken

Token rejestracji.

Zapis JSON 
{
  "name": string,
  "value": string,
  "duration": string,
  "expirationTimestamp": string,
  "policyName": string,
  "additionalData": string,
  "qrCode": string,
  "oneTimeOnly": boolean,
  "user": {
    object (User)
  },
  "allowPersonalUsage": enum (AllowPersonalUsage)
}
Pola
name

string

Nazwa tokena rejestracji, który jest generowany przez serwer podczas tworzenia w formie enterprises/{enterpriseId}/enrollmentTokens/{enrollmentTokenId}.
value

string

Wartość tokena przekazywana na urządzenie i upoważniająca je do rejestracji. To jest pole tylko do odczytu wygenerowane przez serwer.
duration

string (Duration format)

Okres ważności tokena rejestracji, od 1 minuty do Durations.MAX_VALUE (około 10 tysięcy lat). Jeśli nie określisz tu żadnej wartości, czas trwania będzie domyślnie ustawiony na 1 godzinę. Jeśli żądany czas trwania powoduje, że wynik expirationTimestamp przekracza Timestamps.MAX_VALUE, wartość expirationTimestamp jest przymusowo ustawiana na Timestamps.MAX_VALUE.

Czas w sekundach z maksymalnie 9 miejscami po przecinku, zakończony literą „s”. Przykład: "3.5s".
expirationTimestamp

string (Timestamp format)

Czas ważności tokena. To pole jest tylko do odczytu i jest generowane przez serwer.

Sygnatura czasowa w formacie RFC3339 UTC „Zulu” z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
policyName

string

Nazwa zasady, która została początkowo zastosowana do zarejestrowanego urządzenia, ma postać enterprises/{enterpriseId}/policies/{policyId}. Jeśli nie jest określony, policyName użytkownika urządzenia jest stosowany. Jeśli nie określisz też wartości userName, domyślnie zostanie zastosowana wartość enterprises/{enterpriseId}/policies/default. Podczas aktualizowania tego pola możesz podać tylko policyId, o ile policyId nie zawiera żadnych ukośników. Pozostałe nazwy zasady zostaną ustalone.
additionalData

string

Opcjonalne, dowolne dane powiązane z tokenem rejestracji. Może to być na przykład identyfikator jednostki organizacyjnej, do której urządzenie jest przypisane po rejestracji. Gdy urządzenie zarejestruje się przy użyciu tokena, te dane będą widoczne w polu enrollmentTokenData zasobu Device. Dane mogą zawierać maksymalnie 1024 znaki. W przeciwnym razie żądanie utworzenia zakończy się niepowodzeniem.
qrCode

string

Ciąg znaków JSON, którego reprezentacja w formacie UTF-8 może służyć do generowania kodu QR umożliwiającego rejestrację urządzenia przy użyciu tego tokena rejestracji. Aby można było zarejestrować urządzenie za pomocą NFC, rekord NFC musi zawierać zserializowaną reprezentację właściwości java.util.Properties w pliku JSON.
oneTimeOnly

boolean

Określa, czy token rejestracji jest przeznaczony tylko do jednorazowego użytku. Jeśli flaga ma wartość Prawda, tylko jedno urządzenie może jej używać do rejestracji.
user
(deprecated)

object (User)

To pole zostało wycofane i jego wartość jest ignorowana.
allowPersonalUsage

enum (AllowPersonalUsage)

Określa, czy na urządzeniu obsługującym ten token rejestracji dozwolone jest korzystanie z osobistych danych.

W przypadku urządzeń należących do firmy:

  • Włączenie korzystania z urządzenia do celów osobistych pozwala użytkownikowi skonfigurować profil służbowy na urządzeniu.
  • Aby wyłączyć korzystanie z urządzenia do celów osobistych, użytkownik musi skonfigurować je jako urządzenie w pełni zarządzane.

W przypadku urządzeń należących do Ciebie:

  • Włączenie opcji użytku osobistego umożliwia użytkownikowi skonfigurowanie na urządzeniu profilu służbowego.
  • Wyłączenie korzystania z urządzenia uniemożliwi jego przygotowanie do obsługi administracyjnej. Na urządzeniu osobistym nie można wyłączyć funkcji do użytku osobistego.

Metody

create

 Tworzy token rejestracji dla danej firmy.

delete

 Usuwa token rejestracji.

get

 Pobiera aktywny, niewygasły token rejestracji.

list

 Lista aktywnych, niewygasłych tokenów rejestracji w danym przedsiębiorstwie.