Enrollmenttokens: create

Erstellt ein Registrierungstoken für das Unternehmen. Diese Methode ist Teil von EnrollmentTokensService.

Anfrage

HTTP-Anfrage

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

Parameter

Parametername Wert Beschreibung
Pfadparameter
enterpriseId string Die ID des Unternehmens.

Autorisierung

Für diese Anfrage ist eine Autorisierung mit dem folgenden Bereich erforderlich:

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

Weitere Informationen finden Sie auf der Seite Authentifizierung und Autorisierung.

Anfragetext

Geben Sie im Anfragetext Daten mit der folgenden Struktur ein:

{
  "kind": "androidenterprise#enrollmentToken",
  "token": string,
  "enrollmentTokenType": string,
  "duration": {
    "seconds": long,
    "nanos": integer
  },
  "googleAuthenticationOptions": {
    "authenticationRequirement": string,
    "requiredAccountEmail": string
  }
}
Name der Eigenschaft Wert Beschreibung Hinweise
kind string
token string Der Tokenwert, der an das Gerät übergeben wird und das Gerät zur Registrierung autorisiert. Dies ist ein schreibgeschütztes Feld, das vom Server generiert wird.
enrollmentTokenType string [Erforderlich] Der Typ des Registrierungstokens.

Zulässige Werte sind:
  • „enrollmentTokenTypeUnspecified“
  • „userDevice“
  • „userlessDevice“
duration nested object [Optional] Die Gültigkeitsdauer des Registrierungstokens, die zwischen 1 Minute und Durations.MAX_VALUE (ca. 10.000 Jahre) liegen kann. Wenn keine Angabe erfolgt, beträgt die Standarddauer 1 Stunde.
duration.seconds long Signierte Sekunden des Zeitraums.
googleAuthenticationOptions nested object [Optional] Bietet Optionen für die Google-Authentifizierung während der Registrierung.
googleAuthenticationOptions.authenticationRequirement string [Optional] Gibt an, ob sich der Nutzer während der Registrierung bei Google authentifizieren soll. Falls angegeben, wird der GoogleAuthenticationSettings für die Unternehmensressource überschrieben, wenn Geräte mit diesem Token registriert werden.

Zulässige Werte sind:
  • „authenticationRequirementUnspecified“
  • „optional“
  • „required“
googleAuthenticationOptions.requiredAccountEmail string [Optional] Gibt das verwaltete Google-Konto an, das der Nutzer bei der Registrierung verwenden muss. AuthenticationRequirement muss auf REQUIRED festgelegt werden, wenn dieses Feld festgelegt ist.

Antwort

Bei Erfolg gibt diese Methode einen Antworttext mit der folgenden Struktur zurück:

{
  "kind": "androidenterprise#enrollmentToken",
  "token": string,
  "enrollmentTokenType": string,
  "duration": {
    "seconds": long,
    "nanos": integer
  },
  "googleAuthenticationOptions": {
    "authenticationRequirement": string,
    "requiredAccountEmail": string
  }
}
Name der Eigenschaft Wert Beschreibung Hinweise
kind string
token string Der Tokenwert, der an das Gerät übergeben wird und das Gerät zur Registrierung autorisiert. Dies ist ein schreibgeschütztes Feld, das vom Server generiert wird.
enrollmentTokenType string [Erforderlich] Der Typ des Registrierungstokens.

Zulässige Werte sind:
  • „enrollmentTokenTypeUnspecified“
  • „userDevice“
  • „userlessDevice“
duration nested object [Optional] Die Gültigkeitsdauer des Registrierungstokens, die zwischen 1 Minute und Durations.MAX_VALUE (ca. 10.000 Jahre) liegen kann. Wenn keine Angabe erfolgt, beträgt die Standarddauer 1 Stunde.
duration.seconds long Signierte Sekunden des Zeitraums.
googleAuthenticationOptions nested object [Optional] Bietet Optionen für die Google-Authentifizierung während der Registrierung.
googleAuthenticationOptions.authenticationRequirement string [Optional] Gibt an, ob sich der Nutzer während der Registrierung bei Google authentifizieren soll. Diese Einstellung wird ignoriert, wenn sie für die Unternehmensressource angegeben ist, die für Geräte mit diesem Token registriert ist.GoogleAuthenticationSettings

Zulässige Werte sind:
  • „authenticationRequirementUnspecified“
  • „optional“
  • „required“
googleAuthenticationOptions.requiredAccountEmail string [Optional] Gibt das verwaltete Google-Konto an, das der Nutzer bei der Registrierung verwenden muss.AuthenticationRequirement muss aufREQUIRED if this field is set. festgelegt sein.