REST Resource: customers.chromeBrowsers

Ressource: ChromeBrowser

Ein Gerät mit verwalteten Chrome-Browsern.

JSON-Darstellung 
{
  "name": string,
  "browserPermanentId": string,
  "lastPolicyFetchTime": string,
  "osPlatform": string,
  "osArchitecture": string,
  "osVersion": string,
  "machineName": string,
  "annotatedLocation": string,
  "annotatedUser": string,
  "annotatedAssetId": string,
  "annotatedNotes": string,
  "lastRegistrationTime": string,
  "extensionCount": string,
  "policyCount": string,
  "lastDeviceUser": string,
  "lastActivityTime": string,
  "osPlatformVersion": string,
  "browserVersions": [
    string
  ],
  "lastStatusReportTime": string,
  "lastDeviceUsers": [
    {
      object (BrowserUser)
    }
  ],
  "machinePolicies": [
    {
      object (Policy)
    }
  ],
  "browsers": [
    {
      object (Browser)
    }
  ],
  "serialNumber": string,
  "virtualDeviceId": string,
  "machineExtensionPolicies": [
    {
      object (ExtensionPolicy)
    }
  ],
  "orgUnitId": string,
  "deviceIdentifiersHistory": {
    object (DeviceIdentifiersHistory)
  },
  "attestationCredential": {
    object (AttestationCredential)
  },
  "omahaRecentFetchTime": string
}
Felder
name

string

ID. Format: customers/{customerId}/chromeBrowsers/{browserPermanentId}
browserPermanentId

string

Nur Ausgabe. Eindeutige Kennung des Chrome-Browsers.
lastPolicyFetchTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem der letzte Richtlinienabruf auf diesem Gerät erfolgreich war.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
osPlatform

string

Nur Ausgabe. Betriebssystemplattform des Geräts.
osArchitecture

string

Nur Ausgabe. CPU-Architektur des Geräts.
osVersion

string

Nur Ausgabe. Betriebssystemversion des Geräts.
machineName

string

Nur Ausgabe. Name des Computers.
annotatedLocation

string

Optional. Adresse oder Standort des Geräts, wie vom Administrator angegeben.
annotatedUser

string

Optional. Der Nutzer des Geräts, wie vom Administrator angegeben.
annotatedAssetId

string

Optional. Asset-ID, wie vom Administrator oder bei der Registrierung angegeben.
annotatedNotes

string

Optional. Hinweise zu diesem Gerät, wie vom Administrator angegeben.
lastRegistrationTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem das Gerät zuletzt versucht hat, sich zu registrieren.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
extensionCount

string (int64 format)

Nur Ausgabe. Die Anzahl der verschiedenen Erweiterungen, die auf allen Chrome-Browsern dieses Geräts installiert sind.
policyCount

string (int64 format)

Nur Ausgabe. Die Anzahl der unterschiedlichen Richtlinien, die für alle Chrome-Browser dieses Geräts festgelegt sind.
lastDeviceUser

string

Nur Ausgabe. Der letzte Nutzer, der sich auf diesem Gerät in einem Chrome-Browser angemeldet hat.
lastActivityTime

string (Timestamp format)

Nur Ausgabe. Die Uhrzeit der letzten Aktivität auf dem Gerät, entweder durch Berichterstellung, Richtlinienabruf oder Registrierung.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
osPlatformVersion

string

Nur Ausgabe. Kombination aus Betriebssystemplattform und ‑version des Geräts.
browserVersions[]

string

Nur Ausgabe. Liste aller auf diesem Gerät installierten Browserversionen.
lastStatusReportTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem das Gerät zuletzt einen Statusbericht gesendet hat.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
lastDeviceUsers[]

object (BrowserUser)

Nur Ausgabe. Liste der letzten Browsernutzer, absteigend sortiert nach dem Zeitpunkt des letzten Berichts.
machinePolicies[]

object (Policy)

Nur Ausgabe. Die Liste aller Richtlinien auf Geräteebene, die für Chrome-Browser auf diesem Gerät festgelegt sind.
browsers[]

object (Browser)

Nur Ausgabe. Liste der auf diesem Gerät installierten Chrome-Browser.
serialNumber

string

Nur Ausgabe. Die Seriennummer des Geräts.
virtualDeviceId

string

Nur Ausgabe. Die ursprüngliche Geräte-ID, die vom ersten Chrome-Browser gesendet wurde, mit dem dieses Gerät registriert wurde.
machineExtensionPolicies[]

object (ExtensionPolicy)

Nur Ausgabe. Die Liste aller Richtlinien auf Geräteebene, die für Erweiterungen festgelegt sind, die in Chrome auf diesem Gerät installiert sind.
orgUnitId

string

Nur Ausgabe. Die verschleierte ID der Organisationseinheit des Browsers.
deviceIdentifiersHistory

object (DeviceIdentifiersHistory)

Nur Ausgabe. Der Verlauf der Kennzeichnungen, die für dieses Gerät gemeldet wurden.
attestationCredential

object (AttestationCredential)

Nur Ausgabe. Die Attestierungsanmeldedaten, die für den Device Trust Connector verwendet werden.
omahaRecentFetchTime

string (Timestamp format)

Nur Ausgabe. Letzte Richtlinienabrufe durch Omaha. Nicht unbedingt der letzte Abruf, da dieses Feld nur täglich aktualisiert wird.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

BrowserUser

Sie sind Chrome-Nutzer.

JSON-Darstellung 
{
  "userName": string,
  "lastStatusReportTime": string
}
Felder
userName

string

Nur Ausgabe. Der Nutzername des Nutzers, der sich in Chrome angemeldet hat.
lastStatusReportTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem für diese Nutzerinformationen zuletzt ein Status gemeldet wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

Richtlinie

Die angewendete Richtlinie, die von einem verwalteten Chrome-Browser gemeldet wird. Die Richtlinie kann auf verschiedenen Ebenen angewendet werden (Computer, Profil, Erweiterung).

JSON-Darstellung 
{
  "source": enum (PolicySource),
  "policyName": string,
  "value": string,
  "error": string
}
Felder
source

enum (PolicySource)

Nur Ausgabe. Die Quelle der Richtlinie.
policyName

string

Nur Ausgabe. Der Name der Richtlinie.
value

string

Nur Ausgabe. Der Wert der Richtlinie.
error

string

Nur Ausgabe. Ein lokalisierter String mit allen Fehlern, die beim Versuch, diese Richtlinie anzuwenden, gemeldet wurden (falls vorhanden).

Browser

Eine bestimmte Installation von Chrome auf einem Gerät mit verwalteten Chrome-Browsern.

JSON-Darstellung 
{
  "browserVersion": string,
  "channel": enum (Channel),
  "lastStatusReportTime": string,
  "lastPolicyFetchTime": string,
  "executablePath": string,
  "plugins": [
    {
      object (Plugin)
    }
  ],
  "profiles": [
    {
      object (Profile)
    }
  ],
  "pendingInstallVersion": string
}
Felder
browserVersion

string

Nur Ausgabe. Installierte Browserversion.
channel

enum (Channel)

Nur Ausgabe. Der Kanal des installierten Browsers.
lastStatusReportTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem der letzte Bericht von diesem Chrome-Browser empfangen wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
lastPolicyFetchTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem der letzte Richtlinienabruf in diesem Chrome-Browser erfolgreich war.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
executablePath

string

Nur Ausgabe. Der Pfad zur ausführbaren Datei „Chrome.exe“ für diesen Browser.
plugins[]

object (Plugin)

Nur Ausgabe. Liste aller in diesem Chrome-Browser installierten Plug-ins.
profiles[]

object (Profile)

Nur Ausgabe. Die Liste der Profile für diesen Browser.
pendingInstallVersion

string

Nur Ausgabe. Eine ausstehende Version eines Browsers ist installiert. Dieses Feld wird nur festgelegt, wenn die aktuelle aktive Browserversion von der in „browserVersion“ angegebenen Version abweicht.

Kanal

Mögliche Release-Versionen eines Browsers.

Enums
CHANNEL_UNSPECIFIED Stellt einen nicht angegebenen Channel dar.
CHANNEL_STABLE Stellt einen stabilen Channel dar.
CHANNEL_BETA Stellt einen Betakanal dar.
CHANNEL_DEV Stellt einen Entwicklerkanal dar.
CHANNEL_CANARY Stellt einen Canary-Channel dar.

Plug-in

Informationen zu einem Chrome-Browser-Plug-in, das in einer gemeldeten Chrome-Installation auf einem Gerät mit verwalteten Chrome-Browsern installiert ist.

JSON-Darstellung 
{
  "pluginName": string,
  "description": string,
  "filename": string
}
Felder
pluginName

string

Nur Ausgabe. Der Name des installierten Plug‑ins.
description

string

Nur Ausgabe. Die Beschreibung des installierten Plug-ins.
filename

string

Nur Ausgabe. Der Dateiname des installierten Plug‑ins.

Profil

Ein Profil, das für eine Installation von Chrome auf einem Gerät mit verwalteten Chrome-Browsern gemeldet wurde.

JSON-Darstellung 
{
  "profileName": string,
  "id": string,
  "lastStatusReportTime": string,
  "lastPolicyFetchTime": string,
  "safeBrowsingWarnings": string,
  "safeBrowsingWarningsClickThroughs": string,
  "chromeSignedInUserEmail": string,
  "extensions": [
    {
      object (Extension)
    }
  ],
  "userPolicies": [
    {
      object (Policy)
    }
  ],
  "extensionPolicies": [
    {
      object (ExtensionPolicy)
    }
  ],
  "safeBrowsingWarningsResetTime": string
}
Felder
profileName

string

Nur Ausgabe. Der Name dieses Profils.
id

string

Nur Ausgabe. Eine eindeutige ID für dieses Profil.
lastStatusReportTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem der letzte Bericht für dieses Profil eingegangen ist.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
lastPolicyFetchTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem die letzte Anfrage zum Abrufen von Richtlinien für dieses Profil erfolgreich war.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
safeBrowsingWarnings

string (int64 format)

Nur Ausgabe. Die Anzahl der Safe Browsing-Warnungen, die in diesem Profil angezeigt wurden.
safeBrowsingWarningsClickThroughs

string (int64 format)

Nur Ausgabe. Die Anzahl der Safe Browsing-Warnungen, die in diesem Profil angeklickt wurden.
chromeSignedInUserEmail

string

Nur Ausgabe. Die E‑Mail-Adresse des Nutzers, der in diesem Profil angemeldet ist (falls vorhanden).
extensions[]

object (Extension)

Nur Ausgabe. Die Liste der für dieses Profil installierten Erweiterungen.
userPolicies[]

object (Policy)

Nur Ausgabe. Die Liste der auf dieses Profil angewendeten Chrome-Browserrichtlinien.
extensionPolicies[]

object (ExtensionPolicy)

Nur Ausgabe. Die Liste der Erweiterungen mit angewendeten Erweiterungsrichtlinien.
safeBrowsingWarningsResetTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem die Informationen zur Safe Browsing-Warnung zuletzt auf 0 zurückgesetzt wurden.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

Erweiterung

Informationen zu Erweiterungen, die in Profilen installiert sind, die in einer auf einem Gerät mit verwalteten Chrome-Browsern installierten Chrome-Version gemeldet werden.

JSON-Darstellung 
{
  "extensionId": string,
  "version": string,
  "permissions": [
    string
  ],
  "extensionName": string,
  "description": string,
  "appType": enum (ExtensionType),
  "homepageUri": string,
  "installType": enum (InstallationType),
  "configuredAppPolicy": enum (ConfiguredAppPolicy),
  "disabled": boolean,
  "icons": [
    {
      object (ExtensionIcon)
    }
  ],
  "manifestVersion": integer
}
Felder
extensionId

string

Nur Ausgabe. Die ID der Erweiterung.
version

string

Nur Ausgabe. Die Version der Erweiterung.
permissions[]

string

Nur Ausgabe. Die Liste der für diese Erweiterung erforderlichen Berechtigungen.
extensionName

string

Nur Ausgabe. Der lokalisierte Name dieser Erweiterung, wie er von Chrome gemeldet wird.
description

string

Nur Ausgabe. Die lokalisierte Beschreibung dieser Erweiterung.
appType

enum (ExtensionType)

Nur Ausgabe. Der Typ der Erweiterung.
homepageUri

string

Nur Ausgabe. Die URL der Startseite für diese Erweiterung.
installType

enum (InstallationType)

Nur Ausgabe. Wie die Erweiterung installiert wurde.
configuredAppPolicy

enum (ConfiguredAppPolicy)

Nur Ausgabe. Wenn die Erweiterung durch eine Browserrichtlinie gesteuert wird.
disabled

boolean

Nur Ausgabe. Gibt an, ob die Erweiterung deaktiviert ist.
icons[]

object (ExtensionIcon)

Nur Ausgabe. Die Liste der für diese Erweiterung verfügbaren Symbole.
manifestVersion

integer

Nur Ausgabe. Die Manifestversion dieser Erweiterung.

ConfiguredAppPolicy

Mögliche konfigurierte App-Richtlinien für eine Erweiterung.

Enums
CONFIGURED_APP_POLICY_UNSPECIFIED Stellt eine nicht angegebene konfigurierte App-Richtlinie dar.
CONFIGURED_APP_POLICY_NONE Stellt keine konfigurierte App-Richtlinie dar.
CONFIGURED_APP_POLICY_SHOULD_FORCE Stellt eine Erweiterung dar, die erzwungen werden soll.
CONFIGURED_APP_POLICY_SHOULD_BLOCK Stellt eine Erweiterung dar, die blockiert werden soll.

ExtensionIcon

Ein Symbol einer Chrome-Browsererweiterung.

JSON-Darstellung 
{
  "size": integer,
  "uri": string
}
Felder
size

integer

Nur Ausgabe. Die Größe des Erweiterungssymbols.
uri

string

Nur Ausgabe. Die URL des Erweiterungssymbols.

ExtensionPolicy

Die gemeldeten Richtlinien, die auf eine in einem Chrome-Profil installierte Erweiterung angewendet werden.

JSON-Darstellung 
{
  "extensionId": string,
  "extensionName": string,
  "policies": [
    {
      object (Policy)
    }
  ]
}
Felder
extensionId

string

Nur Ausgabe. Die ID der Erweiterung, auf die die Richtlinien angewendet werden.
extensionName

string

Nur Ausgabe. Der Name der Erweiterung, auf die die Richtlinien angewendet werden.
policies[]

object (Policy)

Nur Ausgabe. Liste der Richtlinien, die auf diese Erweiterung angewendet werden.

DeviceIdentifiersHistory

Verlauf der Geräte-IDs, die von einem Gerät gemeldet wurden.

JSON-Darstellung 
{
  "records": [
    {
      object (DeviceIdentifiersRecord)
    }
  ],
  "deviceIdCollision": boolean,
  "lastDeviceIdCollisionDetectionTime": string
}
Felder
records[]

object (DeviceIdentifiersRecord)

Nur Ausgabe. Liste der von diesem Gerät gesendeten Gerätekennungen. In absteigender Reihenfolge nach „lastActivityTime“ sortiert.
deviceIdCollision

boolean

Nur Ausgabe. Die Geräte-ID wird möglicherweise von mehreren Geräten verwendet.
lastDeviceIdCollisionDetectionTime

string (Timestamp format)

Nur Ausgabe. Das letzte Mal, dass wir eine Kollision der Geräte-ID erkannt haben.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

DeviceIdentifiersRecord

Aufzeichnung der Geräte-IDs und des Zeitpunkts, zu dem sie gemeldet wurden.

JSON-Darstellung 
{
  "identifiers": {
    object (DeviceIdentifiers)
  },
  "firstRecordTime": string,
  "lastActivityTime": string
}
Felder
identifiers

object (DeviceIdentifiers)

Nur Ausgabe. Geräte-IDs
firstRecordTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem diese Kennzeichnungen zum ersten Mal gemeldet wurden.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
lastActivityTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt der letzten Aktivität dieser Kennungen, entweder durch Berichterstellung, Richtlinienabruf oder Registrierung.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

DeviceIdentifiers

Erhebung von Geräte-IDs.

JSON-Darstellung 
{
  "machineName": string,
  "serialNumber": string,
  "hostName": string
}
Felder
machineName

string

Nur Ausgabe. Der Name des Computers, der mit dem Gerät verknüpft ist.
serialNumber

string

Nur Ausgabe. Die Seriennummer des Geräts.
hostName

string

Nur Ausgabe. Der Hostname des Geräts.

Methoden

delete

 Löscht die Daten, die aus einem Chrome-Browserprofil erhoben wurden.

get

 Ruft einen einzelnen Chrome-Browser anhand seiner Kunden-ID und Ressourcen-ID ab.

list

 Ruft alle Chrome-Browser eines Kunden ab (paginiert).

move

 Verschiebt verwaltete Chrome-Browser in eine neue Organisationseinheit.

patch

 Aktualisiert die Anmerkungsinformationen für einen Chrome-Browser.