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 Umfang 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. Dieses Feld ist schreibgeschützt und wird vom Server generiert.
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) liegt. Wenn nicht angegeben, beträgt die Standarddauer 1 Stunde. In der JSON REST API wird dies als String dargestellt (z.B. `3600s`).
duration.seconds long Vorzeichenbehaftete Sekunden der Zeitspanne.
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. Wenn angegeben, werden die 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 während der Registrierung verwenden muss. AuthenticationRequirement muss auf REQUIRED gesetzt sein, 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. Dieses Feld ist schreibgeschützt und wird vom Server generiert.
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) liegt. Wenn nicht angegeben, beträgt die Standarddauer 1 Stunde. In der JSON REST API wird dies als String dargestellt (z.B. `3600s`).
duration.seconds long Vorzeichenbehaftete Sekunden der Zeitspanne.
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. Wenn diese Einstellung angegeben ist, werden die für die Unternehmensressource angegebenen GoogleAuthenticationSettings für Geräte ignoriert, die mit diesem Token registriert wurden.

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