REST Resource: customers.profiles

Zasób: ChromeBrowserProfile

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: customers/{customer_id}/profiles/{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żyć 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.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

lastPolicyFetchTime

string (Timestamp format)

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

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

lastPolicySyncTime

string (Timestamp format)

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

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

lastStatusReportTime

string (Timestamp format)

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

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

deviceInfo

object (DeviceInfo)

Tylko dane wyjściowe. podstawowe informacje o urządzeniu, na którym znajduje się 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 znajduje się 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. Zidentyfikuj dostawcę profilu.

firstEnrollmentTime

string (Timestamp format)

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

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

affiliationState

enum (AffiliationState)

Tylko dane wyjściowe. Stan przynależności profilu.

policyCount

string (int64 format)

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

extensionCount

string (int64 format)

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

osPlatformVersion

string

Tylko dane wyjściowe. Wersja główna platformy systemu operacyjnego urządzenia, na którym znajduje się profil, z raportowania profilu.

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. Na platformach, które nie podają nazwy maszyny (obecnie iOS i Android), zamiast tego ustawiany jest identyfikator urządzenia przeglądarki. Należy jednak pamiętać, że jest to inny identyfikator 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 do 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.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

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 krzyżowy.

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 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 Reprezentuje aplikację.
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 o różnych typach instalacji.
NORMAL Reprezentuje normalny typ instalacji.
ADMIN Oznacza instalację 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. Konfliktowe 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 zasad.
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 sprzecznych zasadach zastosowanych w 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 w rozszerzeniu.

IdentityProvider

Możliwi 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 – nie mamy informacji o typie niepowiązanego profilu.
PROFILE_ONLY Niepowiązany – zarządzany profil, który pojawia się w pełni niezarządzonej przeglądarce.
UNAFFILIATED_LOCAL_MACHINE Niepowiązany – zarządzany profil, który pojawia się na urządzeniu zarządzanym lokalnie przez inną organizację (za pomocą mechanizmów zarządzania platformą, takich jak zasady grupy).
UNAFFILIATED_CLOUD_MACHINE Niepowiązany – zarządzany profil, który pojawia się w 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.