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, które autoryzuje urządzenie do rejestracji. To pole jest tylko do odczytu i jest generowane 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 tego ustawienia, domyślny czas trwania to 1 godzina. 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.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są również 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".
policyName

string

Nazwa zasady początkowo zastosowana do zarejestrowanego urządzenia w formie enterprises/{enterpriseId}/policies/{policyId}. Jeśli nie zostanie określony, zostanie zastosowany policyName użytkownika urządzenia. 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ła część nazwy zasady zostanie wywnioskowana.
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 zostało przypisane po zarejestrowaniu. Gdy urządzenie zostanie zarejestrowane za pomocą tokena, te dane będą widoczne w polu enrollmentTokenData zasobu Device. Dane mogą mieć maksymalnie 1024 znaki. W przeciwnym razie żądanie utworzenia nie zostanie zrealizowane.
qrCode

string

Ciąg znaków JSON, którego reprezentacja w UTF-8 może służyć do wygenerowania kodu QR umożliwiającego rejestrację urządzenia przy użyciu tego tokena rejestracji. Aby zarejestrować urządzenie za pomocą NFC, rekord NFC musi zawierać zserializowaną reprezentację java.util.Properties właściwości w formacie 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 z tym tokenem rejestracji jest dozwolone korzystanie osobiste.

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 w pełni zarządzane.

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

  • Włączenie korzystania z urządzenia do celów osobistych pozwala użytkownikowi skonfigurować profil służbowy na urządzeniu.
  • 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 dla danego przedsiębiorstwa.