Gibt ein Dienstkonto und Anmeldedaten zurück. Das Dienstkonto kann durch Aufrufen von setAccount an das Unternehmen gebunden werden. Das Dienstkonto ist für dieses Unternehmen und EMM einmalig und wird gelöscht, wenn die Verknüpfung mit dem Unternehmen aufgehoben wird. Die Anmeldedaten enthalten private Schlüsseldaten und werden nicht serverseitig gespeichert.
Diese Methode kann nur aufgerufen werden, nachdem „Enterprises.Enrollment“ oder „Enterprises.CompleteSignup“ und vor „Enterprises.SetAccount“ aufgerufen wurde. Andernfalls wird ein Fehler zurückgegeben.
Bei nachfolgenden Aufrufen nach dem ersten werden neue, eindeutige Anmeldedaten generiert und die zuvor generierten Anmeldedaten ungültig.
Nachdem das Dienstkonto an das Unternehmen gebunden ist, kann es mit der Ressource „serviceAccountKeys“ verwaltet werden.
Anfragen
HTTP-Anfrage
GET https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/serviceAccount
Parameter
Parametername | Wert | Beschreibung |
---|---|---|
Pfadparameter | ||
enterpriseId |
string |
Die ID des Unternehmens. |
Optionale Suchparameter | ||
keyType |
string |
Der Typ der Anmeldedaten, die mit dem Dienstkonto zurückgegeben werden sollen. Erforderlich.
Folgende Werte sind zulässig:
|
Autorisierung
Für diese Anfrage ist eine Autorisierung in folgendem Umfang erforderlich:
Umfang |
---|
https://www.googleapis.com/auth/androidenterprise |
Weitere Informationen finden Sie auf der Seite Authentifizierung und Autorisierung.
Anfragetext
Mit dieser Methode keinen Anfragetext bereitstellen.
Antwort
Bei Erfolg gibt diese Methode einen Antworttext mit der folgenden Struktur zurück:
{ "kind": "androidenterprise#serviceAccount", "name": string, "key": serviceaccountkeys Resource }
Name der Eigenschaft | Wert | Beschreibung | Hinweise |
---|---|---|---|
name |
string |
Der Kontoname des Dienstkontos in Form einer E-Mail-Adresse. Vom Server zugewiesen. | |
key |
nested object |
Anmeldedaten, die zur Authentifizierung als dieses Dienstkonto verwendet werden können. | |
kind |
string |