Wichtig:Wir akzeptieren keine neuen Registrierungen für die Play EMM API mehr. Weitere Informationen

Diese Seite wurde von der Cloud Translation API übersetzt.

Enterprises

Am Ende dieser Seite finden Sie eine Liste der Methoden für diese Ressource.

Ressourcendarstellungen

Eine Unternehmensressource stellt die Bindung zwischen einem EMM und einer bestimmten Organisation dar. Diese Bindung kann mit dieser API auf zwei verschiedene Arten instanziiert werden:

Für Kunden mit von Google verwalteten Domains werden Enterprises.enroll und Enterprises.setAccount in Verbindung mit Artefakten aus der Admin-Konsole und der Google API Console verwendet und in einem mehr oder weniger manuellen Verfahren an die EMM-Lösung gesendet.
Kunden mit Managed Google Play-Konten verwenden Enterprises.generateSignupUrl und Enterprises.completeSignup in Verbindung mit der Anmeldeoberfläche von Managed Google Play (von Google bereitgestellter Mechanismus), um die Verknüpfung ohne manuelle Schritte zu erstellen.

Als EMM-Anbieter können Sie einen oder beide Ansätze in Ihrer EMM-Konsole unterstützen. Weitere Informationen finden Sie unter Unternehmen erstellen.

{
  "kind": "androidenterprise#enterprise",
  "id": string,
  "primaryDomain": string,
  "name": string,
  "administrator": [
    {
      "email": string
    }
  ],
  "enterpriseType": string,
  "managedGoogleDomainType": string
}

Property-Name	Wert	Beschreibung
`administrator[]`	`list`	Administratoren des Unternehmens Dies wird nur für Unternehmen unterstützt, die über den vom EMM initiierten Ablauf erstellt wurden.
`administrator[].email`	`string`	Die E-Mail-Adresse des Administrators.
`enterpriseType`	`string`	Der Typ des Unternehmens. Zulässige Werte sind: „`enterpriseTypeUnspecified`“ „`managedGoogleDomain`“ „`managedGooglePlayAccountsEnterprise`“
`id`	`string`	Die eindeutige ID für das Unternehmen.
`kind`	`string`
`managedGoogleDomainType`	`string`	Der Typ der verwalteten Google-Domain Zulässige Werte sind: „`managedGoogleDomainTypeUnspecified`“ „`typeDomain`“ „`typeTeam`“
`name`	`string`	Der Name des Unternehmens, z. B. „Beispiel GmbH“.
`primaryDomain`	`string`	Die primäre Domain des Unternehmens, z. B. „beispiel.de“.

Methoden

acknowledgeNotificationSet: Bestätigung von Benachrichtigungen, die von „Enterprises.PullNotificationSet“ empfangen wurden, um zu verhindern, dass bei nachfolgenden Aufrufen dieselben Benachrichtigungen zurückgegeben werden.
completeSignup: Führt die Registrierung durch, indem das Abschlusstoken und das Enterprise-Token angegeben werden. Diese Anfrage darf nicht mehrmals für ein bestimmtes Unternehmenstoken aufgerufen werden.
createWebToken: Gibt ein eindeutiges Token für den Zugriff auf eine einbettbare Benutzeroberfläche zurück. Wenn Sie eine Web-UI generieren möchten, geben Sie das generierte Token an die Managed Google Play JavaScript API weiter. Jedes Token kann nur zum Starten einer UI-Sitzung verwendet werden. Weitere Informationen finden Sie in der JavaScript API-Dokumentation.
enroll: Registriert ein Unternehmen beim anrufenden EMM.
generateSignupUrl: Er generiert eine Registrierungs-URL.
get: Ruft den Namen und die Domain eines Unternehmens ab.
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.
getStoreLayout: Gibt das Ladenlayout für das Unternehmen zurück. Wenn das Geschäftslayout nicht festgelegt wurde, wird „einfach“ als Geschäftslayouttyp und keine Startseite zurückgegeben.
list: Sucht ein Unternehmen nach Domainnamen. Dies wird nur für Unternehmen unterstützt, die über den von Google initiierten Erstellungsvorgang erstellt wurden. Für Unternehmen, die über den vom EMM initiierten Ablauf erstellt wurden, ist keine Suche nach der ID erforderlich, da der EMM die Unternehmens-ID im Callback erhält, der im Aufruf „Enterprises.generateSignupUrl“ angegeben ist.
pullNotificationSet: Liest und gibt einen Benachrichtigungssatz für die Unternehmen zurück, die mit dem Dienstkonto verknüpft sind, das für die Anfrage authentifiziert wurde. Die Benachrichtigungsgruppe ist möglicherweise leer, wenn keine Benachrichtigungen ausstehen.
Eine zurückgegebene Benachrichtigungsgruppe muss innerhalb von 20 Sekunden durch Aufrufen von „Enterprises.AcknowledgeNotificationSet“ bestätigt werden, es sei denn, die Benachrichtigungsgruppe ist leer.
Benachrichtigungen, die nicht innerhalb von 20 Sekunden bestätigt werden, werden in der Antwort auf eine weitere PullNotificationSet-Anfrage wieder aufgenommen. Benachrichtigungen, die nie bestätigt werden, werden gemäß der Google Cloud Platform Pub/Sub-Systemrichtlinie gelöscht.
Es können mehrere Anfragen gleichzeitig ausgeführt werden, um Benachrichtigungen abzurufen. In diesem Fall werden die ausstehenden Benachrichtigungen (falls vorhanden) auf die einzelnen Aufrufer aufgeteilt.
Wenn keine Benachrichtigungen vorhanden sind, wird eine leere Benachrichtigungsliste zurückgegeben. Bei nachfolgenden Anfragen werden möglicherweise weitere Benachrichtigungen zurückgegeben, sobald sie verfügbar sind.
sendTestPushNotification: Eine Testbenachrichtigung wird gesendet, um die EMM-Integration mit dem Google Cloud Pub/Sub-Dienst für dieses Unternehmen zu validieren.
setAccount: Legt das Konto fest, das für die Authentifizierung bei der API als Unternehmen verwendet wird.
setStoreLayout: Legt das Store-Layout für das Unternehmen fest. Standardmäßig ist „storeLayoutType“ auf „basic“ festgelegt und das einfache Store-Layout ist aktiviert. Das grundlegende Layout enthält nur Apps, die vom Administrator genehmigt und dem verfügbaren Produktsatz für einen Nutzer hinzugefügt wurden (mit dem Aufruf setAvailableProductSet). Die Apps auf der Seite werden nach dem Wert der Produkt-ID sortiert. Wenn Sie ein benutzerdefiniertes Store-Layout erstellen (indem Sie „storeLayoutType“ auf „custom“ festlegen und eine Startseite festlegen), wird das grundlegende Store-Layout deaktiviert.
unenroll: Ein Unternehmen wird von dem anrufenden EMM abgemeldet.