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 auf zwei verschiedene Arten mit dieser API instanziiert werden:

  • Bei Kunden mit von Google verwalteten Domains müssen Enterprises.enroll und Enterprises.setAccount (in Verbindung mit Artefakten aus der Admin-Konsole und der Google API Console) verwendet und über einen mehr oder weniger manuellen Prozess an den EMM gesendet werden.
  • Für Kunden mit Managed Google Play-Konten wird die Bindung ohne manuelle Schritte erstellt, indem Enterprises.generateSignupUrl und Enterprises.completeSignup in Verbindung mit der Anmeldeoberfläche von Managed Google Play (von Google bereitgestellter Mechanismus) verwendet werden.
 Als EMM 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
    }
  ],
  "googleAuthenticationSettings": {
    "googleAuthenticationRequired": string,
    "dedicatedDevicesAllowed": string,
    "createdAt": {
      "seconds": long,
      "nanos": integer
    },
    "updatedAt": {
      "seconds": long,
      "nanos": integer
    }
  },
  "enterpriseType": string,
  "managedGoogleDomainType": string
}
Property-Name Wert Beschreibung Hinweise
administrator[] list Administratoren des Unternehmens Dies wird nur für Unternehmen unterstützt, die über den vom EMM-Anbieter initiierten Prozess erstellt wurden.

administrator[].email string Die E-Mail-Adresse des Administrators.
enterpriseType string Der Typ des Unternehmens.

Zulässige Werte sind:
  • „enterpriseTypeUnspecified“
  • „managedGoogleDomain“
  • „managedGooglePlayAccountsEnterprise“
googleAuthenticationSettings nested object Einstellungen für die von Google bereitgestellte Nutzerauthentifizierung.
googleAuthenticationSettings.createdAt nested object Zeitstempel für die Erstellung oder Änderung der Einstellungen.
googleAuthenticationSettings.createdAt.nanos integer Nicht negative Sekundenbruchteile Nanosekunden-Auflösung. Negative Sekundenwerte mit Bruchteilen müssen weiterhin nicht negative Nano-Werte haben, die zeitlich vorwärts gezählt werden. Der Wert muss einschließlich zwischen 0 und 999.999.999 liegen.
googleAuthenticationSettings.createdAt.seconds long Stellt Sekunden der UTC-Zeit seit Unix-Epoche 1970-01-01T00:00:00Z dar. Der Wert muss einschließlich zwischen 0001-01-01T00:00:00Z und 9999-12-31T23:59:59Z liegen.
googleAuthenticationSettings.dedicatedDevicesAllowed string Gibt an, ob zweckbestimmte Geräte zulässig sind.

Zulässige Werte sind:
  • „allowed“
  • „dedicatedDevicesAllowedUnspecified“
  • „disallowed“
googleAuthenticationSettings.googleAuthenticationRequired string Gibt an, ob eine Google-Authentifizierung erforderlich ist.

Zulässige Werte sind:
  • „googleAuthenticationRequiredUnspecified“
  • „notRequired“
  • „required“
googleAuthenticationSettings.updatedAt nested object Zeitstempel der letzten Änderung der Einstellungen.
googleAuthenticationSettings.updatedAt.nanos integer Nicht negative Sekundenbruchteile Nanosekunden-Auflösung. Negative Sekundenwerte mit Bruchteilen müssen weiterhin nicht negative Nano-Werte haben, die zeitlich vorwärts gezählt werden. Der Wert muss einschließlich zwischen 0 und 999.999.999 liegen.
googleAuthenticationSettings.updatedAt.seconds long Stellt Sekunden der UTC-Zeit seit Unix-Epoche 1970-01-01T00:00:00Z dar. Der Wert muss einschließlich zwischen 0001-01-01T00:00:00Z und 9999-12-31T23:59:59Z liegen.
id string Die eindeutige ID für das Unternehmen.

id string Die eindeutige ID für das Unternehmen.

kind string
managedGoogleDomainType string Der Typ der verwalteten Google-Domain

Zulässige Werte:
  • „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ätigt Benachrichtigungen, die von Unternehmen empfangen wurden.PullNotificationSet verhindert, dass bei nachfolgenden Aufrufen dieselben Benachrichtigungen zurückgegeben werden.
completeSignup
Schließt den Registrierungsprozess ab, indem das Completion-Token und das Enterprise-Token angegeben werden. Dieser Aufruf darf für ein bestimmtes Enterprise-Token nicht mehrmals erfolgen.
createWebToken
Gibt ein eindeutiges Token für den Zugriff auf eine einbettbare Benutzeroberfläche zurück. Um eine Web-UI zu generieren, übergeben Sie das generierte Token an die JavaScript-API für den Managed Play Store. Jedes Token darf nur zum Starten einer UI-Sitzung verwendet werden. Weitere Informationen finden Sie in der JavaScript API-Dokumentation.
registrieren
Registriert ein Unternehmen beim aufrufenden EMM.
generateEnterpriseUpgradeUrl
Generiert eine Upgrade-URL für Unternehmen, um eine vorhandene Kontogruppe für Managed Google Play auf eine verwaltete Google-Domain umzustellen. Weitere Informationen finden Sie in diesem Leitfaden.
generateSignupUrl
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 diesen EMM eindeutig und wird gelöscht, wenn die Bindung des Unternehmens aufgehoben wird. Die Anmeldedaten enthalten Daten zum privaten Schlüssel und werden nicht serverseitig gespeichert.

Diese Methode kann nur nach dem Aufrufen von „Enterprises.Enroll“ oder „Enterprises.CompleteSignup“ und vor „Enterprises.SetAccount“ aufgerufen werden. Andernfalls wird ein Fehler zurückgegeben.

Bei nachfolgenden Aufrufen nach dem ersten 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 das Store-Layout nicht festgelegt wurde, wird „basic“ als Store-Layout-Typ zurückgegeben und es gibt keine Startseite.
list
Sucht nach einem Unternehmen anhand des Domainnamens. 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 erfährt, der im Aufruf von „Enterprises.generateSignupUrl“ angegeben ist.
pullNotificationSet
Ruft eine Benachrichtigungsgruppe für die Unternehmen ab, die mit dem für die Anfrage authentifizierten Dienstkonto verknüpft sind, und gibt sie zurück. Die Benachrichtigungsgruppe ist möglicherweise leer, wenn keine Benachrichtigungen ausstehen.
Ein zurückgegebenes Benachrichtigungsset muss innerhalb von 20 Sekunden durch Aufrufen von „Enterprises.AcknowledgeNotificationSet“ bestätigt werden, sofern das Benachrichtigungsset nicht leer ist.
Benachrichtigungen, die nicht innerhalb von 20 Sekunden bestätigt werden, werden schließlich wieder in die Antwort auf eine andere PullNotificationSet-Anfrage aufgenommen. Benachrichtigungen, die nie bestätigt werden, werden gemäß der Google Cloud Platform Pub/Sub-Systemrichtlinie endgültig 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
Sendet eine Testbenachrichtigung, 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 Shop-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 ihrer Produkt-ID sortiert. Wenn Sie ein benutzerdefiniertes Store-Layout erstellen (indem Sie storeLayoutType = „custom“ festlegen und eine Startseite einrichten), wird das grundlegende Store-Layout deaktiviert.
Abmelden
Meldet ein Unternehmen vom anrufenden EMM ab.