Enterprises: getServiceAccount

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 diese EMM eindeutig und wird gelöscht, wenn die Bindung des Unternehmens aufgehoben wird. Die Anmeldedaten enthalten Daten für den privaten Schlüssel und werden nicht serverseitig gespeichert.

Diese Methode kann nur nach dem Aufruf von „Enterprises.Enroll“ oder „Enterprises.CompleteSignup“ und vor „Enterprises.SetAccount“ aufgerufen werden. 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 über die Ressource „serviceAccountKeys“ verwaltet werden.

.

Anfrage

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 Die Art der Anmeldedaten, die mit dem Dienstkonto zurückgegeben werden sollen. Erforderlich.

Zulässige Werte sind:
  • „googleCredentials“
  • „pkcs12“

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

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