REST Resource: enterprises.enrollmentTokens

Ressource: EnrollmentToken

Ein Registrierungstoken.

JSON-Darstellung 
{
  "name": string,
  "value": string,
  "duration": string,
  "expirationTimestamp": string,
  "policyName": string,
  "additionalData": string,
  "qrCode": string,
  "oneTimeOnly": boolean,
  "user": {
    object (User)
  },
  "allowPersonalUsage": enum (AllowPersonalUsage)
}
Felder
name

string

Der Name des Registrierungstokens, der beim Erstellen vom Server im Format enterprises/{enterpriseId}/enrollmentTokens/{enrollmentTokenId} generiert wird.
value

string

Der Tokenwert, der an das Gerät übergeben wird und mit dem das Gerät für die Registrierung autorisiert wird. Dies ist ein schreibgeschütztes Feld, das vom Server generiert wird.
duration

string (Duration format)

Die Gültigkeitsdauer des Registrierungstokens zwischen 1 Minute und Durations.MAX_VALUE, also etwa 10.000 Jahren. Wenn keine Angabe erfolgt, beträgt die Standarddauer 1 Stunde. Hinweis: Wenn die angeforderte Dauer dazu führt, dass die resultierende expirationTimestamp den Wert Timestamps.MAX_VALUE überschreitet, wird expirationTimestamp zu Timestamps.MAX_VALUE erzwungen.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".
expirationTimestamp

string (Timestamp format)

Die Ablaufzeit des Tokens. Dies ist ein schreibgeschütztes Feld, das vom Server generiert wird.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
policyName

string

Der Name der Richtlinie, die ursprünglich auf das registrierte Gerät angewendet wurde, im Format enterprises/{enterpriseId}/policies/{policyId}. Wenn nicht angegeben, wird die policyName für den Gerätenutzer angewendet. Wenn auch userName nicht angegeben ist, wird standardmäßig enterprises/{enterpriseId}/policies/default angewendet. Wenn Sie dieses Feld aktualisieren, können Sie nur die policyId angeben, solange das policyId keine Schrägstriche enthält. Der Rest des Richtliniennamens wird abgeleitet.
additionalData

string

Optionale, beliebige Daten, die dem Registrierungstoken zugeordnet sind. Hier kann beispielsweise die ID einer Organisationseinheit enthalten sein, der das Gerät nach der Registrierung zugewiesen wird. Nachdem ein Gerät mit dem Token registriert wurde, werden diese Daten im Feld enrollmentTokenData der Ressource Device verfügbar gemacht. Die Daten dürfen maximal 1.024 Zeichen lang sein. Andernfalls schlägt die Erstellungsanfrage fehl.
qrCode

string

Ein JSON-String, dessen UTF-8-Darstellung verwendet werden kann, um einen QR-Code zu generieren, um ein Gerät mit diesem Registrierungstoken zu registrieren. Um ein Gerät mit NFC zu registrieren, muss der NFC-Eintrag eine serialisierte java.util.Properties-Darstellung der Attribute im JSON-Format enthalten.
oneTimeOnly

boolean

Gibt an, ob das Registrierungstoken nur einmal verwendet werden kann. Wenn das Flag auf „true“ gesetzt ist, kann es nur von einem Gerät zur Registrierung verwendet werden.
user
(deprecated)

object (User)

Dieses Feld ist veraltet und der Wert wird ignoriert.
allowPersonalUsage

enum (AllowPersonalUsage)

Legt fest, ob die private Nutzung auf einem Gerät, das mit diesem Registrierungstoken bereitgestellt wird, erlaubt ist.

Für unternehmenseigene Geräte:

  • Wenn Sie die private Nutzung aktivieren, können Nutzer ein Arbeitsprofil auf dem Gerät einrichten.
  • Zur Deaktivierung der persönlichen Nutzung muss der Nutzer das Gerät als vollständig verwaltetes Gerät bereitstellen.

Für private Geräte:

  • Wenn Sie die private Nutzung aktivieren, können Nutzer ein Arbeitsprofil auf dem Gerät einrichten.
  • Wenn Sie die private Nutzung deaktivieren, kann das Gerät nicht bereitgestellt werden. Die private Nutzung kann auf privaten Geräten nicht deaktiviert werden.

Methoden

create

 Erstellt ein Registrierungstoken für ein bestimmtes Unternehmen.

delete

 Löscht ein Registrierungstoken.

get

 Ruft ein aktives, nicht abgelaufenes Registrierungstoken ab.

list

 Listet aktive, noch nicht abgelaufene Registrierungstokens für ein bestimmtes Unternehmen auf.