REST Resource: customers.profiles

Zasób: Chrome BrowserProfile

Ilustracja przedstawiająca profil w przeglądarce Chrome.

Zapis JSON
{
  "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
}
Pola
name

string

Identyfikator. Format: klienci/{identyfikator_klienta}/profile/{profilePermanentId}

profileId

string

Tylko dane wyjściowe. Identyfikator profilu po stronie klienta w Chrome.

profilePermanentId

string

Tylko dane wyjściowe. Trwały identyfikator profilu to unikalny identyfikator profilu w ramach jednego klienta.

displayName

string

Tylko dane wyjściowe. Wyświetlana nazwa profilu ustawiona przez klienta.

userId

string

Tylko dane wyjściowe. Unikalny identyfikator interfejsu Directory API użytkownika, który można używać w interfejsie Admin SDK Users API.

userEmail

string

Tylko dane wyjściowe. Adres e-mail użytkownika, do którego należy profil.

lastActivityTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa ostatniej aktywności profilu.

Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

lastPolicyFetchTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa ostatniego pobrania zasad przez profil.

Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

lastPolicySyncTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa ostatniej synchronizacji zasad przez profil.

Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

lastStatusReportTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa ostatniego raportu o stanie profilu.

Sygnatura czasowa w formacie RFC3339 UTC „Zulu” z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

deviceInfo

object (DeviceInfo)

Tylko dane wyjściowe. Podstawowe informacje o urządzeniu, na którym istnieje profil. Te informacje są dostępne tylko w przypadku profili powiązanych.

osPlatformType

string

Tylko dane wyjściowe. Platforma systemu operacyjnego urządzenia, na którym znajduje się profil.

osVersion

string

Tylko dane wyjściowe. Wersja systemu operacyjnego urządzenia, na którym istnieje profil.

browserVersion

string

Tylko dane wyjściowe. Wersja przeglądarki, w której znajduje się profil.

browserChannel

string

Tylko dane wyjściowe. Kanał przeglądarki, na którym znajduje się profil.

annotatedLocation

string

Opcjonalnie: Lokalizacja profilu oznaczonego adnotacją przez administratora.

annotatedUser

string

Opcjonalnie: Użytkownik profilu oznaczonego adnotacją przez administratora.

attestationCredential

object (AttestationCredential)

Tylko dane wyjściowe. Informacje o kwalifikacji profilu.

reportingData

object (ReportingData)

Tylko dane wyjściowe. szczegółowe dane raportowania profilu; Te informacje są dostępne tylko wtedy, gdy włączona jest zasada raportowania profilu.

etag

string

Tylko dane wyjściowe. Etag tego zasobu ChromeBrowserProfile. Etag można używać w operacji UPDATE w celu zapewnienia spójności.

identityProvider

enum (IdentityProvider)

Tylko dane wyjściowe. Wskaż dostawcę profilu.

firstEnrollmentTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa pierwszego zarejestrowania profilu.

Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

affiliationState

enum (AffiliationState)

Tylko dane wyjściowe. Konkretny stan powiązania profilu.

policyCount

string (int64 format)

Tylko dane wyjściowe. Liczba zasad zastosowanych do profilu.

extensionCount

string (int64 format)

Tylko dane wyjściowe. Liczba rozszerzeń zainstalowanych na profilu.

osPlatformVersion

string

Tylko dane wyjściowe. Główna wersja systemu operacyjnego urządzenia, na którym znajduje się profil. (np.Windows 10).

DeviceInfo

Informacje o urządzeniu z profilem przeglądarki Chrome.

Zapis JSON
{
  "deviceType": enum (DeviceType),
  "affiliatedDeviceId": string,
  "machine": string,
  "hostname": string
}
Pola
deviceType

enum (DeviceType)

Tylko dane wyjściowe. Typ urządzenia, na którym istnieje profil.

affiliatedDeviceId

string

Tylko dane wyjściowe. Identyfikator urządzenia, który identyfikuje powiązane urządzenie, na którym znajduje się profil. Jeśli typ urządzenia to CHROME_BROWSER, to jest to unikalny identyfikator interfejsu Directory API urządzenia, który można użyć w interfejsie Admin SDK Browsers API.

machine

string

Tylko dane wyjściowe. Nazwa komputera, na którym znajduje się profil. W przypadku platform, które nie raportują nazwy komputera (obecnie iOS i Android), wartość ta jest ustawiona na identyfikator urządzenia przeglądarki. Pamiętaj jednak, że jest to inny identyfikator deviceId niż |affiliatedDeviceId|.

hostname

string

Tylko dane wyjściowe. Nazwa hosta urządzenia, na którym znajduje się profil.

DeviceType

Możliwe typy urządzeń.

Wartości w polu enum
DEVICE_TYPE_UNSPECIFIED Reprezentuje nieokreślony typ urządzenia.
CHROME_BROWSER Reprezentuje urządzenie z przeglądarką Chrome.

AttestationCredential

Informacje o kluczu publicznym powiązanym z profilem przeglądarki Chrome.

Zapis JSON
{
  "keyType": enum (KeyType),
  "keyTrustLevel": enum (KeyTrustLevel),
  "publicKey": string,
  "keyRotationTime": string
}
Pola
keyType

enum (KeyType)

Tylko dane wyjściowe. Typ klucza publicznego.

keyTrustLevel

enum (KeyTrustLevel)

Tylko dane wyjściowe. Poziom zaufania klucza publicznego.

publicKey

string (bytes format)

Tylko dane wyjściowe. Wartość klucza publicznego.

Ciąg znaków zakodowany w formacie Base64.

keyRotationTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa ostatniej rotacji klucza publicznego.

Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

KeyType

Możliwe typy kluczy publicznych.

Wartości w polu enum
KEY_TYPE_UNSPECIFIED Reprezentuje nieokreślony typ klucza publicznego.
RSA_KEY Reprezentuje klucz RSA.
EC_KEY Reprezentuje klucz EC.

KeyTrustLevel

Możliwe poziomy zaufania do klucza publicznego.

Wartości w polu enum
KEY_TRUST_LEVEL_UNSPECIFIED Reprezentuje nieokreślony poziom zaufania do klucza publicznego.
CHROME_BROWSER_HW_KEY Reprezentuje klucz sprzętowy.
CHROME_BROWSER_OS_KEY Reprezentuje klucz systemu operacyjnego.

ReportingData

Dane do raportowania profilu przeglądarki Chrome.

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

string

Tylko dane wyjściowe. Ścieżka do pliku wykonywalnego zainstalowanej przeglądarki Chrome. Prawidłowa ścieżka jest uwzględniana tylko w profilach powiązanych.

installedBrowserVersion

string

Tylko dane wyjściowe. zaktualizowana wersja przeglądarki, jeśli różni się od aktywnej wersji przeglądarki;

profilePath

string

Tylko dane wyjściowe. Ścieżka do profilu. Prawidłowa ścieżka jest uwzględniana tylko w profilach powiązanych.

extensionData[]

object (ExtensionData)

Tylko dane wyjściowe. informacje o rozszerzeniach zainstalowanych w profilu.

policyData[]

object (PolicyData)

Tylko dane wyjściowe. Informacje o zasadach zastosowanych w profilu.

extensionPolicyData[]

object (ExtensionPolicyData)

Tylko dane wyjściowe. Informacje o zasadach zastosowanych w rozszerzeniach.

ExtensionData

Informacje o rozszerzeniu zainstalowanym w profilu przeglądarki Chrome.

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

string

Tylko dane wyjściowe. Identyfikator rozszerzenia.

version

string

Tylko dane wyjściowe. Wersja rozszerzenia.

permissions[]

string

Tylko dane wyjściowe. Uprawnienia wymagane przez rozszerzenie.

name

string

Tylko dane wyjściowe. Nazwa rozszerzenia.

description

string

Tylko dane wyjściowe. Opis rozszerzenia.

extensionType

enum (ExtensionType)

Tylko dane wyjściowe. Typ rozszerzenia.

homepageUri

string

Tylko dane wyjściowe. Adres URL strony głównej rozszerzenia.

installationType

enum (InstallationType)

Tylko dane wyjściowe. Typ instalacji rozszerzenia.

manifestVersion

integer

Tylko dane wyjściowe. Wersja pliku manifestu rozszerzenia.

isDisabled

boolean

Tylko dane wyjściowe. Wskazuje, czy użytkownik wyłączył rozszerzenie.

isWebstoreExtension

boolean

Tylko dane wyjściowe. Wskazuje, czy rozszerzenie pochodzi ze sklepu internetowego.

ExtensionType

Możliwe typy rozszerzeń.

Wartości w polu enum
EXTENSION_TYPE_UNSPECIFIED Reprezentuje nieokreślony typ rozszerzenia.
EXTENSION Reprezentuje rozszerzenie.
APP Odpowiada aplikacji.
THEME Reprezentuje temat.
HOSTED_APP Reprezentuje hostowaną aplikację.

InstallationType

Możliwe typy instalacji rozszerzenia.

Wartości w polu enum
INSTALLATION_TYPE_UNSPECIFIED Reprezentuje nieokreślony typ instalacji.
MULTIPLE Reprezentuje instancje rozszerzenia z różnymi typami instalacji.
NORMAL Reprezentuje normalny typ instalacji.
ADMIN Reprezentuje instalację wykonane przez administratora.
DEVELOPMENT Reprezentuje typ instalacji w celu testowania.
SIDELOAD Oznacza typ instalacji z płyty.
OTHER Reprezentuje typ instalacji, który nie jest objęty innymi opcjami.

PolicyData

Informacje o zasadzie zastosowanych w profilu przeglądarki Chrome.

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

enum (PolicySource)

Tylko dane wyjściowe. Źródło zasady.

name

string

Tylko dane wyjściowe. Nazwa zasady.

value

string

Tylko dane wyjściowe. Wartość zasady.

conflicts[]

object (ConflictingPolicyData)

Tylko dane wyjściowe. sprzeczne informacje o zasadach;

error

string

Tylko dane wyjściowe. Komunikat o błędzie zasady, jeśli występuje.

PolicySource

Możliwe źródła zasad:

Wartości w polu enum
POLICY_SOURCE_UNSPECIFIED Reprezentuje nieokreślone źródło zasady.
MACHINE_PLATFORM Reprezentuje zasady platformy na poziomie komputera.
USER_PLATFORM Reprezentuje zasady platformy na poziomie użytkownika.
MACHINE_LEVEL_USER_CLOUD Reprezentuje zasady dotyczące chmury użytkownika na poziomie komputera.
USER_CLOUD Reprezentuje zasady w chmurze na poziomie użytkownika.
MACHINE_MERGED Reprezentuje scalone zasady na poziomie komputera.

ConflictingPolicyData

Informacje o kolidujących zasadach zastosowanych do profilu przeglądarki Chrome.

Zapis JSON
{
  "source": enum (PolicySource)
}
Pola
source

enum (PolicySource)

Tylko dane wyjściowe. Źródło zasady.

ExtensionPolicyData

Informacje o zasadach zastosowanych w rozszerzeniu.

Zapis JSON
{
  "extensionId": string,
  "extensionName": string,
  "policyData": [
    {
      object (PolicyData)
    }
  ]
}
Pola
extensionId

string

Tylko dane wyjściowe. Identyfikator rozszerzenia.

extensionName

string

Tylko dane wyjściowe. Nazwa rozszerzenia.

policyData[]

object (PolicyData)

Tylko dane wyjściowe. Informacje o zasadach zastosowanych do rozszerzenia.

IdentityProvider

Potencjalni dostawcy tożsamości profilu.

Wartości w polu enum
IDENTITY_PROVIDER_UNSPECIFIED Reprezentuje nieokreślonego dostawcę tożsamości.
GOOGLE_IDENTITY_PROVIDER Reprezentuje dostawcę tożsamości Google.
EXTERNAL_IDENTITY_PROVIDER Reprezentuje zewnętrznego dostawcę tożsamości.

AffiliationState

Stan przynależności profilu. W przyszłości mogą zostać dodane nowe wartości.

Wartości w polu enum
AFFILIATION_STATE_UNSPECIFIED Nieokreślony stan przynależności.
UNAFFILIATED_GENERIC Niepowiązany profil – ale nie mamy szczegółowych informacji o typie profilu niestowarzyszonego.
PROFILE_ONLY Niepowiązany – zarządzany profil, który pojawia się w całkowicie niezarządzanym przez przeglądarkę.
UNAFFILIATED_LOCAL_MACHINE Niepowiązany – profil zarządzany wyświetlany na komputerze zarządzanym lokalnie przez inną organizację (za pomocą mechanizmów zarządzania platformą, takich jak GPO).
UNAFFILIATED_CLOUD_MACHINE Niepowiązany – zarządzany profil, który pojawia się w zarządzanej przeglądarce zarządzanej w chmurze przez inną organizację (za pomocą zarządzania przeglądarką Chrome w chmurze).
AFFILIATED_CLOUD_MANAGED Powiązany – profilem i przeglądarką zarządza ta sama organizacja.

Metody

delete

Usuwa dane zebrane z profilu przeglądarki Chrome.

get

Pobiera profil przeglądarki Chrome z identyfikatorem klienta i trwałym identyfikatorem profilu.

list

Wyświetla listę profili przeglądarki Chrome klienta na podstawie podanych kryteriów wyszukiwania i sortowania.