Enterprises

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 und Enterprises.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 und Enterprises.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.
Als EMM 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
    }
  ]
}
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.