Enterprises: getServiceAccount

Gibt ein Dienstkonto und Anmeldedaten zurück. Das Dienstkonto kann durch Aufrufen von "setAccount" an das Unternehmen gebunden werden. Das Dienstkonto ist einzigartig für dieses Unternehmen und EMM und wird gelöscht, wenn das Unternehmen ist nicht gebunden. Die Anmeldedaten enthalten Daten zu einem privaten Schlüssel und werden nicht gespeichert serverseitig.

Diese Methode kann nur aufgerufen werden, nachdem Enterprises.Enrollment oder Enterprises.CompleteSignup und vorher Enterprises.SetAccount; oder ein Fehler zurückgegeben.

Nachfolgende Aufrufe nach dem ersten generieren einen neuen, eindeutigen Satz von Anmeldedaten zu entfernen und die zuvor generierten Anmeldedaten zu entwerten.

Sobald das Dienstkonto an das Unternehmen gebunden ist, kann es verwaltet werden. mit der Ressource "serviceAccountKeys".

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 Abfrageparameter
keyType string Der Anmeldedatentyp, der mit dem Dienstkonto zurückgegeben werden soll. Erforderlich.

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

Autorisierung

Für diese Anfrage ist eine Autorisierung mit folgendem Bereich 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