REST Resource: customers.profiles

Ressource: ChromeBrowserProfile

Eine Darstellung eines Chrome-Browserprofils.

JSON-Darstellung 
{
  "name": string,
  "profileId": string,
  "profilePermanentId": string,
  "displayName": string,
  "userId": string,
  "userEmail": string,
  "lastActivityTime": string,
  "lastPolicyFetchTime": string,
  "lastPolicySyncTime": string,
  "lastStatusReportTime": string,
  "deviceInfo": {
    object (DeviceInfo)
  },
  "osPlatformType": string,
  "osVersion": string,
  "browserVersion": string,
  "browserChannel": string,
  "annotatedLocation": string,
  "annotatedUser": string,
  "attestationCredential": {
    object (AttestationCredential)
  },
  "reportingData": {
    object (ReportingData)
  },
  "etag": string,
  "identityProvider": enum (IdentityProvider),
  "firstEnrollmentTime": string,
  "affiliationState": enum (AffiliationState),
  "policyCount": string,
  "extensionCount": string,
  "osPlatformVersion": string
}
Felder
name

string

Kennung. Format: customers/{customer_id}/profiles/{profilePermanentId}
profileId

string

Nur Ausgabe. Clientseitige Chrome-Profil-ID.
profilePermanentId

string

Nur Ausgabe. Die dauerhafte Profil-ID ist die eindeutige Kennung eines Profils innerhalb eines Kunden.
displayName

string

Nur Ausgabe. Vom Kunden festgelegter Anzeigename des Profils.
userId

string

Nur Ausgabe. Eindeutige Directory API-ID des Nutzers, die in der Admin SDK Users API verwendet werden kann.
userEmail

string

Nur Ausgabe. Die E-Mail-Adresse des Nutzers, zu dem das Profil gehört.
lastActivityTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel der letzten Aktivität des Profils.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
lastPolicyFetchTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel des letzten Richtlinienabrufs durch das Profil.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
lastPolicySyncTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel der letzten Richtliniensynchronisierung durch das Profil.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
lastStatusReportTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel des letzten Statusberichts des Profils.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
deviceInfo

object (DeviceInfo)

Nur Ausgabe. Grundlegende Informationen zu dem Gerät, auf dem das Profil vorhanden ist. Diese Informationen sind nur für die verknüpften Profile verfügbar.
osPlatformType

string

Nur Ausgabe. Betriebssystemplattform des Geräts, auf dem das Profil vorhanden ist
osVersion

string

Nur Ausgabe. Die Betriebssystemversion des Geräts, auf dem das Profil vorhanden ist.
browserVersion

string

Nur Ausgabe. Version des Browsers, in dem das Profil vorhanden ist.
browserChannel

string

Nur Ausgabe. Kanal des Browsers, in dem das Profil vorhanden ist.
annotatedLocation

string

Optional. Standort des Profils, der vom Administrator angegeben wurde.
annotatedUser

string

Optional. Nutzer des Profils, das vom Administrator kommentiert wurde.
attestationCredential

object (AttestationCredential)

Nur Ausgabe. Informationen zu den Anmeldedaten für die Attestierung des Profils.
reportingData

object (ReportingData)

Nur Ausgabe. Detaillierte Berichtsdaten des Profils. Diese Informationen sind nur verfügbar, wenn die Richtlinie für die Berichterstellung für Profile aktiviert ist.
etag

string

Nur Ausgabe. Etag dieser ChromeBrowserProfile-Ressource. Dieses etag kann mit dem UPDATE-Vorgang verwendet werden, um für Konsistenz zu sorgen.
identityProvider

enum (IdentityProvider)

Nur Ausgabe. Anbieter des Profils angeben
firstEnrollmentTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel der ersten Registrierung des Profils.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
affiliationState

enum (AffiliationState)

Nur Ausgabe. Der spezifische Zugehörigkeitsstatus des Profils.
policyCount

string (int64 format)

Nur Ausgabe. Anzahl der Richtlinien, die auf das Profil angewendet werden.
extensionCount

string (int64 format)

Nur Ausgabe. Anzahl der im Profil installierten Erweiterungen.
osPlatformVersion

string

Nur Ausgabe. Hauptversion des Betriebssystems des Geräts, auf dem das Profil vorhanden ist. (z.B. Windows 10)

DeviceInfo

Informationen zu einem Gerät, auf dem ein Chrome-Browserprofil ausgeführt wird.

JSON-Darstellung 
{
  "deviceType": enum (DeviceType),
  "affiliatedDeviceId": string,
  "machine": string,
  "hostname": string
}
Felder
deviceType

enum (DeviceType)

Nur Ausgabe. Typ des Geräts, auf dem das Profil vorhanden ist.
affiliatedDeviceId

string

Nur Ausgabe. Die Geräte-ID, die das zugehörige Gerät identifiziert, auf dem das Profil vorhanden ist. Wenn der Gerätetyp CHROME_BROWSER ist, handelt es sich um eine eindeutige Directory API-ID des Geräts, die in der Admin SDK Browsers API verwendet werden kann.
machine

string

Nur Ausgabe. Computername des Geräts, auf dem das Profil vorhanden ist. Auf Plattformen, auf denen der Computername nicht gemeldet wird (aktuell iOS und Android), wird stattdessen die deviceId des Browsers festgelegt. Hinweis: Dies ist eine andere deviceId als die |affiliatedDeviceId|.
hostname

string

Nur Ausgabe. Hostname des Geräts, auf dem das Profil vorhanden ist.

DeviceType

Mögliche Gerätetypen

Enums
DEVICE_TYPE_UNSPECIFIED Stellt einen nicht angegebenen Gerätetyp dar.
CHROME_BROWSER Stellt ein Chrome-Gerät dar.

AttestationCredential

Informationen zum öffentlichen Schlüssel, der mit einem Chrome-Browserprofil verknüpft ist.

JSON-Darstellung 
{
  "keyType": enum (KeyType),
  "keyTrustLevel": enum (KeyTrustLevel),
  "publicKey": string,
  "keyRotationTime": string
}
Felder
keyType

enum (KeyType)

Nur Ausgabe. Typ des öffentlichen Schlüssels.
keyTrustLevel

enum (KeyTrustLevel)

Nur Ausgabe. Vertrauensstufe des öffentlichen Schlüssels.
publicKey

string (bytes format)

Nur Ausgabe. Wert des öffentlichen Schlüssels.

Ein base64-codierter String.
keyRotationTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel der letzten Rotation des öffentlichen Schlüssels.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

KeyType

Mögliche Typen eines öffentlichen Schlüssels.

Enums
KEY_TYPE_UNSPECIFIED Stellt einen nicht angegebenen öffentlichen Schlüsseltyp dar.
RSA_KEY Stellt einen RSA-Schlüssel dar.
EC_KEY Stellt einen EC-Schlüssel dar.

KeyTrustLevel

Mögliche Vertrauensstufen eines öffentlichen Schlüssels.

Enums
KEY_TRUST_LEVEL_UNSPECIFIED Stellt ein nicht angegebenes Vertrauensniveau für Public-Key-Zertifikate dar.
CHROME_BROWSER_HW_KEY Stellt einen Hardwareschlüssel dar.
CHROME_BROWSER_OS_KEY Stellt einen Betriebssystemschlüssel dar.

ReportingData

Berichtsdaten eines Chrome-Browserprofils.

JSON-Darstellung 
{
  "browserExecutablePath": string,
  "installedBrowserVersion": string,
  "profilePath": string,
  "extensionData": [
    {
      object (ExtensionData)
    }
  ],
  "policyData": [
    {
      object (PolicyData)
    }
  ],
  "extensionPolicyData": [
    {
      object (ExtensionPolicyData)
    }
  ]
}
Felder
browserExecutablePath

string

Nur Ausgabe. Ausführbarer Pfad des installierten Chrome-Browsers. Ein gültiger Pfad ist nur in verknüpften Profilen enthalten.
installedBrowserVersion

string

Nur Ausgabe. Aktualisierte Version eines Browsers, falls sie von der aktiven Browserversion abweicht
profilePath

string

Nur Ausgabe. Pfad des Profils. Ein gültiger Pfad ist nur in verknüpften Profilen enthalten.
extensionData[]

object (ExtensionData)

Nur Ausgabe. Informationen zu den im Profil installierten Erweiterungen.
policyData[]

object (PolicyData)

Nur Ausgabe. Informationen zu den Richtlinien, die auf das Profil angewendet werden.
extensionPolicyData[]

object (ExtensionPolicyData)

Nur Ausgabe. Informationen zu den auf die Erweiterungen angewendeten Richtlinien.

ExtensionData

Informationen zu einer Erweiterung, die in einem Chrome-Browserprofil installiert ist.

JSON-Darstellung 
{
  "extensionId": string,
  "version": string,
  "permissions": [
    string
  ],
  "name": string,
  "description": string,
  "extensionType": enum (ExtensionType),
  "homepageUri": string,
  "installationType": enum (InstallationType),
  "manifestVersion": integer,
  "isDisabled": boolean,
  "isWebstoreExtension": boolean
}
Felder
extensionId

string

Nur Ausgabe. ID der Erweiterung.
version

string

Nur Ausgabe. Version der Erweiterung.
permissions[]

string

Nur Ausgabe. Von der Erweiterung angeforderte Berechtigungen.
name

string

Nur Ausgabe. Name der Erweiterung.
description

string

Nur Ausgabe. Beschreibung der Erweiterung.
extensionType

enum (ExtensionType)

Nur Ausgabe. Typ der Erweiterung.
homepageUri

string

Nur Ausgabe. Die URL der Startseite der Erweiterung.
installationType

enum (InstallationType)

Nur Ausgabe. Installationstyp der Erweiterung.
manifestVersion

integer

Nur Ausgabe. Manifestversion der Erweiterung.
isDisabled

boolean

Nur Ausgabe. Gibt an, ob der Nutzer die Erweiterung deaktiviert hat.
isWebstoreExtension

boolean

Nur Ausgabe. Gibt an, ob die Erweiterung aus dem Webstore stammt.

ExtensionType

Mögliche Typen einer Erweiterung.

Enums
EXTENSION_TYPE_UNSPECIFIED Stellt einen nicht angegebenen Erweiterungstyp dar.
EXTENSION Stellt eine Erweiterung dar.
APP Stellt eine App dar.
THEME Stellt ein Thema dar.
HOSTED_APP Stellt eine gehostete App dar.

InstallationType

Mögliche Installationstypen einer Erweiterung.

Enums
INSTALLATION_TYPE_UNSPECIFIED Stellt einen nicht angegebenen Installationstyp dar.
MULTIPLE Stellt Instanzen der Erweiterung mit gemischten Installationstypen dar.
NORMAL Stellt einen normalen Installationstyp dar.
ADMIN Stellt eine Installation durch den Administrator dar.
DEVELOPMENT Stellt einen Entwicklungsinstallationstyp dar.
SIDELOAD Stellt einen Installationstyp für Sideloading dar.
OTHER Stellt einen Installationstyp dar, der von den anderen Optionen nicht abgedeckt wird.

PolicyData

Informationen zu einer Richtlinie, die auf ein Chrome-Browserprofil angewendet wird.

JSON-Darstellung 
{
  "source": enum (PolicySource),
  "name": string,
  "value": string,
  "conflicts": [
    {
      object (ConflictingPolicyData)
    }
  ],
  "error": string
}
Felder
source

enum (PolicySource)

Nur Ausgabe. Quelle der Richtlinie.
name

string

Nur Ausgabe. Name der Richtlinie.
value

string

Nur Ausgabe. Wert der Richtlinie.
conflicts[]

object (ConflictingPolicyData)

Nur Ausgabe. Widersprüchliche Richtlinieninformationen.
error

string

Nur Ausgabe. Fehlermeldung der Richtlinie, falls vorhanden.

PolicySource

Mögliche Quellen einer Richtlinie.

Enums
POLICY_SOURCE_UNSPECIFIED Stellt eine nicht angegebene Richtlinienquelle dar.
MACHINE_PLATFORM Stellt eine Plattformrichtlinie auf Maschinenebene dar.
USER_PLATFORM Stellt eine Plattformrichtlinie auf Nutzerebene dar.
MACHINE_LEVEL_USER_CLOUD Stellt eine Nutzer-Cloud-Richtlinie auf Maschinenebene dar.
USER_CLOUD Stellt eine Cloud-Richtlinie auf Nutzerebene dar.
MACHINE_MERGED Stellt eine zusammengeführte Richtlinie auf Computerebene dar.

ConflictingPolicyData

Informationen zu einer in Konflikt stehenden Richtlinie, die auf ein Chrome-Browserprofil angewendet wird.

JSON-Darstellung 
{
  "source": enum (PolicySource)
}
Felder
source

enum (PolicySource)

Nur Ausgabe. Quelle der Richtlinie.

ExtensionPolicyData

Informationen zu den Richtlinien, die auf eine Erweiterung angewendet werden.

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

string

Nur Ausgabe. ID der Erweiterung.
extensionName

string

Nur Ausgabe. Name der Erweiterung.
policyData[]

object (PolicyData)

Nur Ausgabe. Informationen zu den für die Erweiterung geltenden Richtlinien.

IdentityProvider

Mögliche Identitätsanbieter eines Profils.

Enums
IDENTITY_PROVIDER_UNSPECIFIED Stellt einen nicht angegebenen Identitätsanbieter dar.
GOOGLE_IDENTITY_PROVIDER Stellt einen Google-Identitätsanbieter dar.
EXTERNAL_IDENTITY_PROVIDER Stellt einen externen Identitätsanbieter dar.

AffiliationState

Der spezifische Status der Zugehörigkeit für das Profil. Es können in Zukunft weitere Werte hinzugefügt werden.

Enums
AFFILIATION_STATE_UNSPECIFIED Nicht angegebener Zugehörigkeitsstatus.
UNAFFILIATED_GENERIC Nicht mit einem Unternehmen verbunden, aber wir haben keine Details zur Art des nicht mit einem Unternehmen verbundenen Profils.
PROFILE_ONLY Nicht verknüpft: Ein verwaltetes Profil, das in einem völlig nicht verwalteten Browser angezeigt wird.
UNAFFILIATED_LOCAL_MACHINE Nicht verbunden: Ein verwaltetes Profil, das auf einem Computer angezeigt wird, der lokal von einer anderen Organisation verwaltet wird (über Plattformverwaltungsmechanismen wie GPO).
UNAFFILIATED_CLOUD_MACHINE Nicht verknüpft: Ein verwaltetes Profil, das in einem verwalteten Browser angezeigt wird, der von einer anderen Organisation über die Chrome-Verwaltung über die Cloud verwaltet wird.
AFFILIATED_CLOUD_MANAGED Verknüpft: Sowohl das Profil als auch der verwaltete Browser werden von derselben Organisation verwaltet.

Methoden

delete

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

get

 Ruft ein Chrome-Browserprofil mit Kunden-ID und dauerhafter Profil-ID ab.

list

 Listet Chrome-Browserprofile eines Kunden anhand der angegebenen Such- und Sortierkriterien auf.