Enrollmenttokens: create

Tworzy token rejestracji dla firmy. Ta metoda jest częścią usługi EnrollmentTokensService.

Żądanie

Żądanie HTTP

POST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/enrollmentTokens

Parametry

Nazwa parametru Wartość Opis
Parametry ścieżki
enterpriseId string Identyfikator przedsiębiorstwa.

Autoryzacja

To żądanie wymaga autoryzacji w tym zakresie:

Zakres
https://www.googleapis.com/auth/androidenterprise

Więcej informacji znajdziesz na stronie Uwierzytelnianie i autoryzacja.

Treść żądania

Dane w treści żądania muszą mieć poniższy format:

{
  "kind": "androidenterprise#enrollmentToken",
  "token": string,
  "enrollmentTokenType": string,
  "duration": {
    "seconds": long,
    "nanos": integer
  },
  "googleAuthenticationOptions": {
    "authenticationRequirement": string,
    "requiredAccountEmail": string
  }
}
Nazwa usługi Wartość Opis Uwagi
kind string
token string Wartość tokena przekazywana do urządzenia, która autoryzuje rejestrację urządzenia. Jest to pole tylko do odczytu generowane przez serwer.
enrollmentTokenType string [Wymagany] Typ tokena rejestracji.

Akceptowane wartości:
  • „enrollmentTokenTypeUnspecified”
  • „userDevice”
  • „userlessDevice”
duration nested object [Opcjonalnie] Czas ważności tokena rejestracji, od 1 minuty do Durations.MAX_VALUE, czyli około 10 000 lat. Jeśli nie określisz tu żadnej wartości, zostanie użyte ustawienie domyślne (1 godzina).
duration.seconds long Podpisane sekundy w przedziale czasu.
googleAuthenticationOptions nested object [Opcjonalnie] Zawiera opcje związane z uwierzytelnianiem w Google podczas rejestracji.
googleAuthenticationOptions.authenticationRequirement string [Opcjonalnie] Określa, czy użytkownik powinien uwierzytelnić się w Google podczas rejestracji. Jeśli podano, zastępuje GoogleAuthenticationSettings w przypadku zasobu przedsiębiorstwa, gdy urządzenia są rejestrowane przy użyciu tego tokena.

Akceptowane wartości:
  • „authenticationRequirementUnspecified”
  • „optional”
  • „required”
googleAuthenticationOptions.requiredAccountEmail string [Opcjonalnie] Określa zarządzane konto Google, którego użytkownik musi używać podczas rejestracji. Jeśli to pole jest ustawione, pole AuthenticationRequirement musi mieć wartość REQUIRED.

Odpowiedź

Jeśli operacja się uda, metoda zwróci odpowiedź w poniższym formacie:

{
  "kind": "androidenterprise#enrollmentToken",
  "token": string,
  "enrollmentTokenType": string,
  "duration": {
    "seconds": long,
    "nanos": integer
  },
  "googleAuthenticationOptions": {
    "authenticationRequirement": string,
    "requiredAccountEmail": string
  }
}
Nazwa usługi Wartość Opis Uwagi
kind string
token string Wartość tokena przekazywana do urządzenia, która autoryzuje rejestrację urządzenia. Jest to pole tylko do odczytu generowane przez serwer.
enrollmentTokenType string [Wymagany] Typ tokena rejestracji.

Akceptowane wartości:
  • „enrollmentTokenTypeUnspecified”
  • „userDevice”
  • „userlessDevice”
duration nested object [Opcjonalnie] Czas ważności tokena rejestracji, od 1 minuty do Durations.MAX_VALUE, czyli około 10 000 lat. Jeśli nie określisz tu żadnej wartości, zostanie użyte ustawienie domyślne (1 godzina).
duration.seconds long Podpisane sekundy w przedziale czasu.
googleAuthenticationOptions nested object [Opcjonalnie] Zawiera opcje związane z uwierzytelnianiem w Google podczas rejestracji.
googleAuthenticationOptions.authenticationRequirement string [Opcjonalnie] Określa, czy użytkownik powinien uwierzytelnić się w Google podczas rejestracji. To ustawienie, jeśli jest określone, GoogleAuthenticationSettings określone dla zasobu przedsiębiorstwa jest ignorowane w przypadku urządzeń zarejestrowanych przy użyciu tego tokena.

Akceptowane wartości:
  • „authenticationRequirementUnspecified”
  • „optional”
  • „required”
googleAuthenticationOptions.requiredAccountEmail string [Opcjonalnie] Określa zarządzane konto Google, którego użytkownik musi używać podczas rejestracji.AuthenticationRequirement musi mieć wartośćREQUIRED if this field is set.