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:
|
|
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:
|
|
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:
|
|
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:
|
|
googleAuthenticationOptions.requiredAccountEmail |
string |
[Optional] Gibt das verwaltete Google-Konto an, das der Nutzer während der Registrierung verwenden muss.AuthenticationRequirement muss aufREQUIRED gesetzt sein. |