Am Ende dieser Seite finden Sie eine Liste der Methoden für diese Ressource.
Ressourcendarstellungen
Eine Enterprise-Ressource stellt die Bindung zwischen einem EMM und einer bestimmten Organisation dar. Diese Bindung kann mithilfe dieser API auf zwei verschiedene Arten instanziiert werden:
- Für Kunden, die eine von Google verwaltete Domain verwenden, werden
Enterprises.enroll
undEnterprises.setAccount
(in Verbindung mit Artefakten, die über die Admin-Konsole und die Google API Console abgerufen wurden) verwendet und durch einen eher oder weniger manuellen Prozess an das EMM gesendet. - Kunden mit Managed Google Play-Konten müssen
Enterprises.generateSignupUrl
undEnterprises.completeSignup
in Verbindung mit der Benutzeroberfläche für die Registrierung von Managed Google Play (von Google bereitgestellter Mechanismus) verwenden, um die Bindung ohne manuelle Schritte zu erstellen.
{ "kind": "androidenterprise#enterprise", "id": string, "primaryDomain": string, "name": string, "administrator": [ { "email": string } ] }
Property-Name | Wert | Beschreibung | Hinweise |
---|---|---|---|
administrator[] |
list |
Administratoren des Unternehmens. Dies wird nur für Unternehmen unterstützt, die über den von EMM initiierten Ablauf erstellt wurden. |
|
administrator[].email |
string |
Die E-Mail-Adresse des Administrators | |
id |
string |
Die eindeutige ID für das Unternehmen. |
|
kind |
string |
||
name |
string |
Der Name des Unternehmens, zum Beispiel „Beispiel GmbH“. | |
primaryDomain |
string |
Die primäre Domain des Unternehmens, z. B. beispiel.de. |
Methoden
- acknowledgeNotificationSet
- Die Aktion bestätigt Benachrichtigungen, die eingegangen sind von Enterprises.PullNotificationSet, um zu verhindern, dass nachfolgende Aufrufe zurückgegeben werden. dieselben Benachrichtigungen.
- completeSignup
- Schließt den Registrierungsvorgang ab, indem er das Abschlusstoken angibt und Enterprise-Token Diese Anfrage darf für ein bestimmtes Unternehmen nicht mehrmals aufgerufen werden Token.
- createWebToken
- Gibt ein eindeutiges Token für den Zugriff auf eine UI zurück, die eingebettet werden kann. Um eine Web-UI, übergeben Sie das generierte Token an das Managed Google Play-JavaScript der API erstellen. Jedes Token kann nur zum Starten einer UI-Sitzung verwendet werden. Weitere Informationen finden Sie in der <ph type="x-smartling-placeholder"></ph> JavaScript API-Dokumentation.
- anmelden
- Registriert ein Unternehmen beim anrufenden EMM.
- generateSignupUrl
- Generiert eine Registrierungs-URL
- get
- Name und Domain eines Unternehmens abrufen
- 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". - getStoreLayout
- Gibt das Store-Layout für das Unternehmen zurück. Wenn die Geschäftsstruktur nicht festgelegt wurde, wird „basic“ zurückgegeben. als Geschäfts-Layouttyp und keine Startseite.
- list
- Sucht ein Unternehmen anhand des Domainnamens. Dies wird nur für Unternehmen unterstützt, die über die von Google initiierte Erstellungsprozess durchlaufen. Die Suche der ID ist für Unternehmen, die über erstellt wurden, nicht erforderlich. ausgeführt werden, da der EMM-Anbieter die Unternehmens-ID in der im Aufruf „Enterprises.generateSignupUrl“ angegeben.
- pullNotificationSet
- Ruft eine Benachrichtigung ab und gibt sie zurück, die für die mit
Das Dienstkonto, das für die Anfrage authentifiziert ist. Die eingestellte Benachrichtigung kann
leer sein, wenn keine Benachrichtigungen ausstehen.
Ein zurückgegebener Benachrichtigungssatz muss innerhalb von 20 Sekunden bestätigt werden indem Sie Enterprises.AcknowledgeNotificationSet aufrufen, es sei denn, Benachrichtigungsgruppe ist leer.
Benachrichtigungen, die nicht innerhalb von 20 Sekunden bestätigt werden, möglicherweise wieder in die Antwort auf ein anderes PullNotificationSet aufgenommen werden. und Anfragen, die nie bestätigt werden, werden letztlich gelöscht. gemäß der Pub/Sub-Systemrichtlinie der Google Cloud Platform.
Es können mehrere Anfragen gleichzeitig ausgeführt werden, Benachrichtigungen. In diesem Fall werden ausstehende Benachrichtigungen (falls vorhanden) zwischen den einzelnen Anrufern aufgeteilt, falls noch ausstehen.
Wenn keine Benachrichtigungen vorhanden sind, wird eine leere Benachrichtigungsliste zurückgegeben. Bei nachfolgenden Anfragen erhalten Sie möglicherweise weitere Benachrichtigungen, verfügbar. - sendTestPushNotification
- Sendet eine Testbenachrichtigung, um die EMM-Integration mit den Google Cloud Pub/Sub-Dienst für dieses Unternehmen.
- setAccount
- Legt das Konto fest, das zur Authentifizierung bei der API verwendet wird, als das Unternehmen.
- setStoreLayout
- Legt das Store-Layout für das Unternehmen fest. Standardmäßig ist „storeLayoutType“ ist auf „Basic“ festgelegt und das grundlegende Layout des Geschäfts aktiviert ist. Die grundlegende enthält nur Apps, die vom Administrator genehmigt wurden und zur verfügbaren Produktgruppe für einen Nutzer (mithilfe der <ph type="x-smartling-placeholder"></ph> setAvailableProductSet). Die Apps auf der Seite sind in der folgenden Reihenfolge sortiert: ihre Produkt-ID. Wenn Sie ein benutzerdefiniertes Store-Layout erstellen (durch storeLayoutType = "custom" und das Festlegen einer Startseite) enthält, Layout ist deaktiviert.
- Abmelden
- Hiermit wird ein Unternehmen vom anrufenden EMM-Anbieter abgemeldet.