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 Enterprises-Ressource stellt die Bindung zwischen einem EMM und einer bestimmten Organisation dar. Diese Bindung kann mithilfe dieser API auf eine von zwei Arten instanziiert werden:

Bei von Google verwalteten Domains umfasst der Prozess die Verwendung von Enterprises.enroll und Enterprises.setAccount (in Verbindung mit Artefakten, die Sie aus der Admin-Konsole und der Google API Console erhalten haben) und die mehr oder weniger manuell an EMM gesendet werden.
Für Kunden von Managed Google Play-Konten umfasst der Prozess die Verwendung von Enterprises.generateSignupUrl und Enterprises.completeSignup in Verbindung mit der von Google bereitgestellten UI für Managed Google Play, um die Bindung ohne manuelle Schritte zu erstellen.

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

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

Property-Name	Wert	Beschreibung
`administrator[]`	`list`	Administratoren des Unternehmens. Diese Option wird nur für Unternehmen unterstützt, die über einen EMM-Prozess erstellt wurden.
`administrator[].email`	`string`	E-Mail-Adresse des Administrators.
`id`	`string`	Die eindeutige ID des Unternehmens.
`kind`	`string`
`name`	`string`	Der Name des Unternehmens, z. B. „Beispiel GmbH“.
`primaryDomain`	`string`	Die primäre Domain des Unternehmens, z. B. beispiel.de.

Methoden

acknowledgeNotificationSet: Betätigt Benachrichtigungen, die von Enterprises.PullNotificationSet empfangen wurden, um zu verhindern, dass nachfolgende Aufrufe dieselben Benachrichtigungen zurückgeben.
completeSignup: Schließt den Registrierungsvorgang ab, indem das Abschlusstoken und das Enterprise-Token angegeben werden. Diese Anfrage darf für ein bestimmtes Enterprise-Token nicht mehrmals aufgerufen werden.
createWebToken: Gibt ein eindeutiges Token für den Zugriff auf eine einbettbare UI zurück. Um eine Web-UI zu erstellen, musst du das generierte Token an die Managed Google Play JavaScript API übergeben. Jedes Token kann nur zum Starten einer einzelnen UI-Sitzung verwendet werden. Weitere Informationen findest du in der JavaScript API-Dokumentation.
Anmelden: Damit wird ein Unternehmen beim anrufenden EMM angemeldet.
generateSignupUrl: Eine Registrierungs-URL wird generiert.
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 EMM eindeutig und wird gelöscht, wenn das Unternehmen nicht gebunden ist. Die Anmeldedaten enthalten Daten zu einem 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. In anderen Fällen wird ein Fehler zurückgegeben.

Bei nachfolgenden Aufrufen wird ein neuer eindeutiger Satz von Anmeldedaten generiert und die zuvor generierten Anmeldedaten werden ungültig.

Sobald das Dienstkonto an das Unternehmen gebunden ist, kann es mit der Ressource „serviceAccountKeys“ verwaltet werden.
getStoreLayout: Gibt das Store-Layout für das Unternehmen zurück. Wenn kein Store-Layout festgelegt wurde, wird „basic“ als Layouttyp und keine Startseite zurückgegeben.
list: Sucht ein Unternehmen anhand des Domainnamens. Diese Option wird nur für Unternehmen unterstützt, die über den von Google initiierten Erstellungsablauf erstellt wurden. Bei Unternehmen, die über den EMM-initiierten Vorgang erstellt wurden, muss die ID nicht abgefragt werden, da der EMM-Anbieter die Unternehmens-ID im Callback erlernt, der im Aufruf "Enterprises.generateSignupUrl" angegeben ist.
pullNotificationSet: Ruft einen Benachrichtigungssatz für die Unternehmen ab, die mit dem für die Anfrage authentifizierten Dienstkonto verknüpft sind, und gibt diese zurück. Die Benachrichtigungsgruppe kann leer sein, wenn keine Benachrichtigungen ausstehen.
Ein zurückgegebener Benachrichtigungssatz muss innerhalb von 20 Sekunden durch Aufrufen von Enterprises.Acknowledge NotificationSet bestätigt werden, es sei denn, der Benachrichtigungssatz ist leer.
Benachrichtigungen, die nicht innerhalb von 20 Sekunden bestätigt werden, werden letztendlich wieder in die Antwort auf eine andere PullNotificationSet-Anfrage aufgenommen. Benachrichtigungen, die nie bestätigt werden, werden schließlich gemäß der Pub/Sub-Systemrichtlinie der Google Cloud Platform gelöscht.
Es können mehrere Anfragen gleichzeitig ausgeführt werden, um Benachrichtigungen abzurufen. In diesem Fall werden die ausstehenden Benachrichtigungen (falls vorhanden) unter jedem Aufrufer aufgeteilt, sofern welche noch ausstehen.
Wenn keine Benachrichtigungen vorhanden sind, wird eine leere Benachrichtigungsliste zurückgegeben. Für nachfolgende Anfragen können weitere Benachrichtigungen zurückgegeben werden, sobald sie verfügbar sind.
sendTestPushNotification: Sendet eine Testbenachrichtigung, um die EMM-Integration mit dem Google Cloud Pub/Sub-Dienst für dieses Unternehmen zu validieren.
setAccount: Legt das Konto, das zur Authentifizierung bei der API verwendet wird, als Enterprise fest.
setStoreLayout: Hiermit wird das Store-Layout für das Unternehmen festgelegt. Standardmäßig ist „storeLayoutType“ auf „basic“ festgelegt und das einfache Store-Layout ist aktiviert. Das Grundlayout enthält nur Apps, die vom Administrator genehmigt wurden und mit dem Aufruf setAvailableProductSet der verfügbaren Produktgruppe für einen Nutzer hinzugefügt wurden. Die Apps auf der Seite werden in der Reihenfolge ihres Produkt-ID-Werts sortiert. Wenn Sie ein benutzerdefiniertes Store-Layout erstellen, indem Sie „storeLayoutType“ auf „custom“ setzen und eine Startseite festlegen, wird das grundlegende Store-Layout deaktiviert.
Abmelden: Die Registrierung eines Unternehmens vom anrufenden EMM wird aufgehoben.