- Ressource: Enterprise
- NotificationType
- ExternalData
- TermsAndConditions
- SigninDetail
- SigninDetailDefaultStatus
- ContactInfo
- GoogleAuthenticationSettings
- GoogleAuthenticationRequired
- Methoden
Ressource: Enterprise
Die Konfiguration, die auf ein Unternehmen angewendet wird.
JSON-Darstellung |
---|
{ "name": string, "enabledNotificationTypes": [ enum ( |
Felder | |
---|---|
name |
Der Name des Unternehmens, der beim Erstellen vom Server im Format |
enabled |
Die Arten von Google Pub/Sub-Benachrichtigungen, die für das Unternehmen aktiviert sind. |
pubsub |
Das Thema, in dem Pub/Sub-Benachrichtigungen im Format |
primary |
Eine Farbe im RGB-Format, die die vorherrschende Farbe angibt, die in der Benutzeroberfläche der Geräteverwaltungs-App angezeigt werden soll. Die Farbkomponenten werden so gespeichert: |
logo |
Ein Bild, das während der Gerätebereitstellung als Logo angezeigt wird. Folgende Typen werden unterstützt: image/bmp, image/gif, image/x-ico, image/jpeg, image/png, image/webp, image/vnd.wap.wbmp, image/x-adobe-dng. |
enterprise |
Der Name des Unternehmens, der Nutzern angezeigt wird. Dieses Feld hat eine maximale Länge von 100 Zeichen. |
terms |
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 |
Veraltet und nicht verwendet. |
signin |
Anmeldedaten des Unternehmens. |
contact |
Die Unternehmenskontaktdaten eines EMM-verwalteten Unternehmens. |
google |
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 sendet. |
COMMAND |
Eine Benachrichtigung, die gesendet wird, wenn ein Gerätebefehl abgeschlossen ist. |
USAGE_LOGS |
Eine Benachrichtigung, die gesendet wird, wenn das Gerät sendet. |
ExternalData
Daten, die an einem externen Speicherort gehostet werden. Die Daten müssen von Android Device Policy heruntergeladen und anhand des Hashwerts überprüft werden.
JSON-Darstellung |
---|
{ "url": string, "sha256Hash": string } |
Felder | |
---|---|
url |
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. Durch das Einfügen einer langen, zufälligen Komponente in die URL können Angreifer daran gehindert werden, die URL zu ermitteln. |
sha256 |
Der Base64-codierte SHA-256-Hash des Inhalts, der unter der URL gehostet wird. Wenn die Inhalte nicht mit diesem Hash übereinstimmen, werden die Daten von Android Device Policy nicht verwendet. |
TermsAndConditions
Eine Seite mit Nutzungsbedingungen, die während der Bereitstellung akzeptiert werden muss.
JSON-Darstellung |
---|
{ "header": { object ( |
Felder | |
---|---|
header |
Eine kurze Kopfzeile, die über dem HTML-Inhalt angezeigt wird. |
content |
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
können Sie enterprises
SigninDetail
s für ein bestimmtes Unternehmen verwalten.
Wir können für ein Unternehmen eine beliebige Anzahl von SigninDetail
s haben, die durch eine Kombination der folgenden drei Felder (signinUrl
, allowPersonalUsage
, tokenTag
) eindeutig identifiziert werden können. Zwei SigninDetail
s können nicht mit demselben erstellt werden (signinUrl
, allowPersonalUsage
, tokenTag
). (tokenTag
ist ein optionales Feld).
: Der Vorgang aktualisiert die aktuelle Liste von Patch
SigninDetails
durch die neue Liste von SigninDetails
.
- Wenn die gespeicherte
SigninDetail
-Konfiguration übergeben wird, werden dieselbensigninEnrollmentToken
undqrCode
zurückgegeben. - Wenn mehrere identische
SigninDetail
-Konfigurationen übergeben werden, die nicht gespeichert sind, wird die erste dieserSigninDetail
-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 auch aus dem Speicher entfernt. Anschließend können wir eine weiteresigninEnrollmentToken
und eine weitereqrCode
für dieselbeSigninDetail
-Konfiguration anfordern.
JSON-Darstellung |
---|
{ "signinUrl": string, "signinEnrollmentToken": string, "qrCode": string, "allowPersonalUsage": enum ( |
Felder | |
---|---|
signin |
Anmelde-URL für die 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= |
signin |
Ein unternehmensweites Registrierungstoken, das zum Auslösen eines benutzerdefinierten Anmeldevorgangs verwendet wird. Dies ist ein schreibgeschütztes Feld, das vom Server generiert wird. |
qr |
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. Wenn Sie ein Gerät per NFC registrieren möchten, muss der NFC-Eintrag eine serialisierte |
allow |
Bestimmt, ob die private Nutzung auf einem Gerät zulässig ist, das mit diesem Registrierungstoken bereitgestellt wurde. Für unternehmenseigene Geräte:
Für private Geräte:
|
default |
Optional. Legt fest, ob die Anmelde-URL standardmäßig für das Unternehmen verwendet werden soll. Die |
token |
Eine EMM-spezifische Metadaten zur Unterscheidung zwischen Instanzen von |
SigninDetailDefaultStatus
Gibt an, 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 | |
---|---|
contact |
E-Mail-Adresse einer Kontaktperson, an die wichtige Mitteilungen zu verwaltetem Google Play gesendet werden. |
data |
Der Name des Datenschutzbeauftragten. |
data |
Die E-Mail-Adresse des Datenschutzbeauftragten. Die E-Mail-Adresse wurde validiert, aber nicht bestätigt. |
data |
Telefonnummer des Datenschutzbeauftragten: Die Telefonnummer wurde validiert, aber nicht bestätigt. |
eu |
Der Name des EU-Bevollmächtigten. |
eu |
Die E-Mail-Adresse des EU-Bevollmächtigten. Die E-Mail-Adresse wurde bestätigt, aber nicht bestätigt. |
eu |
Telefonnummer des EU-Bevollmächtigten. Die Telefonnummer wurde validiert, aber nicht bestätigt. |
GoogleAuthenticationSettings
Enthält Einstellungen für die von Google bereitgestellte Nutzerauthentifizierung.
JSON-Darstellung |
---|
{
"googleAuthenticationRequired": enum ( |
Felder | |
---|---|
google |
Nur Ausgabe. Ob Nutzer während der Registrierung von Google authentifiziert werden müssen. IT-Administratoren können angeben, ob die Google-Authentifizierung für das Unternehmen für Geräte von Wissensarbeitern aktiviert ist. Dieser Wert kann nur über die Google Admin-Konsole festgelegt werden. Die Google-Authentifizierung kann mit |
GoogleAuthenticationRequired
Einstellung, ob für dieses Unternehmen eine Google-Authentifizierung erforderlich ist.
Enums | |
---|---|
GOOGLE_AUTHENTICATION_REQUIRED_UNSPECIFIED |
Dieser Wert wird nicht verwendet. |
NOT_REQUIRED |
Die Google-Authentifizierung ist nicht erforderlich. |
REQUIRED |
Der Nutzer muss von Google erfolgreich authentifiziert werden. |
Methoden |
|
---|---|
|
Erstellt ein Unternehmen. |
|
Löscht ein Unternehmen und alle damit verknüpften Konten und Daten endgültig. |
|
Ruft ein Unternehmen ab. |
|
Listet EMM-verwaltete Unternehmen auf. |
|
Aktualisiert ein Unternehmen. |