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 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:
  • „googleCredentials“
  • „pkcs12“

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