REST Resource: enterprises

Ressource: Enterprise

Die auf ein Unternehmen angewendete Konfiguration.

JSON-Darstellung
{
  "name": string,
  "enabledNotificationTypes": [
    enum (NotificationType)
  ],
  "pubsubTopic": string,
  "primaryColor": integer,
  "logo": {
    object (ExternalData)
  },
  "enterpriseDisplayName": string,
  "termsAndConditions": [
    {
      object (TermsAndConditions)
    }
  ],
  "appAutoApprovalEnabled": boolean,
  "signinDetails": [
    {
      object (SigninDetail)
    }
  ],
  "contactInfo": {
    object (ContactInfo)
  },
  "googleAuthenticationSettings": {
    object (GoogleAuthenticationSettings)
  }
}
Felder
name

string

Der Name des Unternehmens, der beim Erstellen vom Server im Format enterprises/{enterpriseId} generiert wird.

enabledNotificationTypes[]

enum (NotificationType)

Die Arten von Google Pub/Sub-Benachrichtigungen, die für das Unternehmen aktiviert sind.

pubsubTopic

string

Das Thema, in dem Pub/Sub-Benachrichtigungen im Format projects/{project}/topics/{topic} veröffentlicht werden. Dieses Feld ist nur erforderlich, wenn Pub/Sub-Benachrichtigungen aktiviert sind.

primaryColor

integer

Eine Farbe im RGB-Format, die die vorherrschende Farbe angibt, die auf der Benutzeroberfläche der Geräteverwaltungs-App angezeigt werden soll. Die Farbkomponenten werden so gespeichert: (red << 16) | (green << 8) | blue, wobei der Wert jeder Komponente zwischen 0 und 255 liegt.

enterpriseDisplayName

string

Der Name des Unternehmens, der Nutzern angezeigt wird. Dieses Feld hat eine maximale Länge von 100 Zeichen.

termsAndConditions[]

object (TermsAndConditions)

Nutzungsbedingungen, die bei der Bereitstellung eines Geräts für dieses Unternehmen akzeptiert werden müssen. Für jeden Wert in dieser Liste wird eine Seite mit Begriffen generiert.

appAutoApprovalEnabled
(deprecated)

boolean

Eingestellt und nicht verwendet.

signinDetails[]

object (SigninDetail)

Anmeldedaten des Unternehmens.

contactInfo

object (ContactInfo)

Die Unternehmenskontaktdaten eines EMM-verwalteten Unternehmens.

googleAuthenticationSettings

object (GoogleAuthenticationSettings)

Einstellungen für die von Google bereitgestellte Nutzerauthentifizierung.

NotificationType

Benachrichtigungstypen, die der Server für die Geräteverwaltung über Google Pub/Sub senden kann.

Enums
NOTIFICATION_TYPE_UNSPECIFIED Dieser Wert wird ignoriert.
ENROLLMENT Eine Benachrichtigung, die gesendet wird, wenn ein Gerät registriert wird.
COMPLIANCE_REPORT

Verworfen.

STATUS_REPORT Eine Benachrichtigung, die gesendet wird, wenn ein Gerät einen Statusbericht ausgibt.
COMMAND Eine Benachrichtigung, die gesendet wird, wenn ein Gerätebefehl abgeschlossen ist.
USAGE_LOGS Eine Benachrichtigung, die gesendet wird, wenn das Gerät BatchUsageLogEvents sendet.

ExternalData

An einem externen Speicherort gehostete Daten. Die Daten müssen über die Android Device Policy heruntergeladen und mit dem Hash verifiziert werden.

JSON-Darstellung
{
  "url": string,
  "sha256Hash": string
}
Felder
url

string

Die absolute URL zu den Daten, für die entweder das HTTP- oder das HTTPS-Schema verwendet werden muss. Android Device Policy stellt keine Anmeldedaten in der GET-Anfrage bereit, sodass die URL öffentlich zugänglich sein muss. Eine lange, zufällige Komponente in der URL kann verwendet werden, um zu verhindern, dass Angreifer die URL entdecken.

sha256Hash

string

Der base-64-codierte SHA-256-Hash des unter der URL gehosteten Contents. Wenn die Inhalte nicht mit diesem Hash übereinstimmen, werden die Daten von Android Device Policy nicht verwendet.

TermsAndConditions

Eine Seite mit den Nutzungsbedingungen, die während der Bereitstellung akzeptiert wird.

JSON-Darstellung
{
  "header": {
    object (UserFacingMessage)
  },
  "content": {
    object (UserFacingMessage)
  }
}
Felder
header

object (UserFacingMessage)

Eine kurze Kopfzeile, die über dem HTML-Inhalt angezeigt wird.

content

object (UserFacingMessage)

Ein richtig formatierter HTML-String. Es wird auf dem Client mit android.text.HTML#fromHTML geparst.

SigninDetail

Eine Ressource mit Anmeldedaten für ein Unternehmen. Mit enterprises können Sie SigninDetails für ein bestimmtes Unternehmen verwalten.

Wir können für ein Unternehmen eine beliebige Anzahl von SigninDetails haben, die durch eine Kombination der folgenden drei Felder (signinUrl, allowPersonalUsage, tokenTag) eindeutig identifiziert werden können. Zwei SigninDetails können nicht mit demselben erstellt werden (signinUrl, allowPersonalUsage, tokenTag). (tokenTag ist ein optionales Feld).

Patch: Der Vorgang aktualisiert die aktuelle Liste von SigninDetails durch die neue Liste von SigninDetails.

  • Wenn die gespeicherte SigninDetail-Konfiguration übergeben wird, werden dieselben Werte für signinEnrollmentToken und qrCode zurückgegeben.
  • Wenn wir mehrere identische SigninDetail-Konfigurationen übergeben, die nicht gespeichert sind, wird die erste unter diesen SigninDetail-Konfigurationen gespeichert.
  • Ist die Konfiguration bereits vorhanden, können wir sie nicht mehr als einmal in einem bestimmten Patch-API-Aufruf anfordern. Andernfalls wird ein Fehler beim Duplizieren des Schlüssels ausgegeben und der gesamte Vorgang schlägt fehl.
  • Wenn wir eine bestimmte SigninDetail-Konfiguration aus der Anfrage entfernen, wird sie aus dem Speicher entfernt. Anschließend können wir eine weitere signinEnrollmentToken und eine weitere qrCode für dieselbe SigninDetail-Konfiguration anfordern.
JSON-Darstellung
{
  "signinUrl": string,
  "signinEnrollmentToken": string,
  "qrCode": string,
  "allowPersonalUsage": enum (AllowPersonalUsage),
  "defaultStatus": enum (SigninDetailDefaultStatus),
  "tokenTag": string
}
Felder
signinUrl

string

Anmelde-URL zur Authentifizierung, wenn das Gerät mit einem Anmelde-Registrierungstoken bereitgestellt wird. Der Anmeldeendpunkt sollte den Authentifizierungsvorgang mit einer URL im folgenden Format abschließen: https://enterprise.google.com/android/enroll?et= (eine erfolgreiche Anmeldung) oder https://enterprise.google.com/android/enroll/invalid (bei fehlgeschlagener Anmeldung).

signinEnrollmentToken

string

Ein unternehmensweites Registrierungstoken, das zum Auslösen eines benutzerdefinierten Anmeldevorgangs verwendet wird. Dies ist ein schreibgeschütztes Feld, das vom Server generiert wird.

qrCode

string

Ein JSON-String, dessen UTF-8-Darstellung verwendet werden kann, um einen QR-Code zu generieren, um ein Gerät mit diesem Registrierungstoken zu registrieren. Um ein Gerät mit NFC zu registrieren, muss der NFC-Eintrag eine serialisierte java.util.Properties-Darstellung der Attribute im JSON-Format enthalten. Dies ist ein schreibgeschütztes Feld, das vom Server generiert wird.

allowPersonalUsage

enum (AllowPersonalUsage)

Legt fest, ob die private Nutzung auf einem Gerät, das mit diesem Registrierungstoken bereitgestellt wird, erlaubt ist.

Für unternehmenseigene Geräte:

  • Wenn Sie die private Nutzung aktivieren, können Nutzer ein Arbeitsprofil auf dem Gerät einrichten.
  • Zur Deaktivierung der persönlichen Nutzung muss der Nutzer das Gerät als vollständig verwaltetes Gerät bereitstellen.

Für private Geräte:

  • Wenn Sie die private Nutzung aktivieren, können Nutzer ein Arbeitsprofil auf dem Gerät einrichten.
  • Wenn Sie die private Nutzung deaktivieren, kann das Gerät nicht bereitgestellt werden. Die private Nutzung kann auf privaten Geräten nicht deaktiviert werden.
defaultStatus

enum (SigninDetailDefaultStatus)

Optional. Legt fest, ob die Anmelde-URL standardmäßig für das Unternehmen verwendet werden soll. Die SigninDetail, bei der defaultStatus auf SIGNIN_DETAIL_IS_DEFAULT festgelegt ist, wird für die Registrierungsmethode für das Google-Konto verwendet. Nur bei einem der signinDetails eines Unternehmens kann defaultStatus auf SIGNIN_DETAIL_IS_DEFAULT festgelegt werden. Wenn in einer Enterprise mindestens ein signinDetails vorhanden ist und für keiner von ihnen defaultStatus auf SIGNIN_DETAIL_IS_DEFAULT gesetzt ist, wird die erste aus der Liste ausgewählt und defaultStatus auf SIGNIN_DETAIL_IS_DEFAULT gesetzt. Wenn für Enterprise keine signinDetails angegeben ist, schlägt die Geräteregistrierung über das Google-Konto fehl.

tokenTag

string

Eine EMM-spezifische Metadaten zur Unterscheidung zwischen Instanzen von SigninDetail.

SigninDetailDefaultStatus

Legt fest, ob die Anmelde-URL standardmäßig für das Unternehmen verwendet werden soll.

Enums
SIGNIN_DETAIL_DEFAULT_STATUS_UNSPECIFIED Gleichbedeutend mit SIGNIN_DETAIL_IS_NOT_DEFAULT.
SIGNIN_DETAIL_IS_DEFAULT Die Anmelde-URL wird standardmäßig für das Unternehmen verwendet.
SIGNIN_DETAIL_IS_NOT_DEFAULT Die Anmelde-URL wird nicht standardmäßig für das Unternehmen verwendet.

ContactInfo

Kontaktdaten für Managed Google Play-Unternehmen.

JSON-Darstellung
{
  "contactEmail": string,
  "dataProtectionOfficerName": string,
  "dataProtectionOfficerEmail": string,
  "dataProtectionOfficerPhone": string,
  "euRepresentativeName": string,
  "euRepresentativeEmail": string,
  "euRepresentativePhone": string
}
Felder
contactEmail

string

E-Mail-Adresse eines Ansprechpartners, an die wichtige Ankündigungen zu Managed Google Play gesendet werden.

dataProtectionOfficerName

string

Der Name des Datenschutzbeauftragten.

dataProtectionOfficerEmail

string

Die E-Mail-Adresse des Datenschutzbeauftragten. Die E-Mail-Adresse wurde bestätigt, aber nicht bestätigt.

dataProtectionOfficerPhone

string

Die Telefonnummer des Datenschutzbeauftragten. Die Telefonnummer ist bestätigt, aber nicht bestätigt.

euRepresentativeName

string

Der Name des EU-Bevollmächtigten.

euRepresentativeEmail

string

Die E-Mail-Adresse des EU-Bevollmächtigten. Die E-Mail-Adresse wurde bestätigt, aber nicht bestätigt.

euRepresentativePhone

string

Die Telefonnummer des EU-Bevollmächtigten. Die Telefonnummer wurde bestätigt, aber nicht bestätigt.

GoogleAuthenticationSettings

Enthält Einstellungen für die von Google bereitgestellte Nutzerauthentifizierung.

JSON-Darstellung
{
  "googleAuthenticationRequired": enum (GoogleAuthenticationRequired)
}
Felder
googleAuthenticationRequired

enum (GoogleAuthenticationRequired)

Nur Ausgabe. Gibt an, ob Nutzer während der Registrierung von Google authentifiziert werden müssen. Der IT-Administrator kann angeben, ob die Google-Authentifizierung für das Unternehmen auf Geräten für Wissensarbeiter aktiviert ist. Dieser Wert kann nur über die Admin-Konsole festgelegt werden. Die Google-Authentifizierung kann mit signinUrl verwendet werden. Wenn eine Google-Authentifizierung erforderlich ist und eine signinUrl angegeben wird, wird die Google-Authentifizierung vor dem signinUrl gestartet.

GoogleAuthenticationRequired

Einstellung, ob für dieses Unternehmen eine Google-Authentifizierung erforderlich ist.

Enums
GOOGLE_AUTHENTICATION_REQUIRED_UNSPECIFIED Dieser Wert wird nicht verwendet.
NOT_REQUIRED Eine Google-Authentifizierung ist nicht erforderlich.
REQUIRED Der Nutzer muss von Google erfolgreich authentifiziert werden.

Methoden

create

Erstellt ein Unternehmen.

delete

Löscht ein Unternehmen und alle zugehörigen Konten und Daten endgültig.

get

Ein Unternehmen.

list

Listet EMM-verwaltete Unternehmen auf.

patch

Aktualisiert ein Unternehmen.