REST Resource: customers.profiles

Risorsa: ChromeBrowserProfile

Una rappresentazione di un profilo del browser Chrome.

Rappresentazione 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
}
Campi
name

string

Identificatore. Formato: customers/{customer_id}/profiles/{profilePermanentId}
profileId

string

Solo output. ID profilo lato client di Chrome.
profilePermanentId

string

Solo output. L'ID profilo permanente è l'identificatore univoco di un profilo all'interno di un cliente.
displayName

string

Solo output. Nome visualizzato del profilo impostato dal cliente.
userId

string

Solo output. L'ID API Directory univoco dell'utente che può essere utilizzato nell'API Users dell'SDK Admin.
userEmail

string

Solo output. Indirizzo email dell'utente a cui appartiene il profilo.
lastActivityTime

string (Timestamp format)

Solo output. Timestamp dell'ultima attività del profilo.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
lastPolicyFetchTime

string (Timestamp format)

Solo output. Timestamp dell'ultimo recupero del criterio da parte del profilo.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
lastPolicySyncTime

string (Timestamp format)

Solo output. Timestamp dell'ultima sincronizzazione dei criteri da parte del profilo.

Un timestamp nel formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
lastStatusReportTime

string (Timestamp format)

Solo output. Timestamp dell'ultimo report di stato del profilo.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
deviceInfo

object (DeviceInfo)

Solo output. Informazioni di base sul dispositivo su cui esiste il profilo. Queste informazioni sono disponibili solo per i profili affiliati.
osPlatformType

string

Solo output. Piattaforma del sistema operativo del dispositivo su cui esiste il profilo.
osVersion

string

Solo output. Versione del sistema operativo del dispositivo su cui esiste il profilo.
browserVersion

string

Solo output. Versione del browser su cui esiste il profilo.
browserChannel

string

Solo output. Canale del browser su cui esiste il profilo.
annotatedLocation

string

(Facoltativo) Posizione del profilo annotata dall'amministratore.
annotatedUser

string

(Facoltativo) Utente del profilo annotato dall'amministratore.
attestationCredential

object (AttestationCredential)

Solo output. Informazioni sulle credenziali di attestazione del profilo.
reportingData

object (ReportingData)

Solo output. Dati dei report dettagliati del profilo. Queste informazioni sono disponibili solo se è attivato il criterio per i report sui profili.
etag

string

Solo output. Etag di questa risorsa ChromeBrowserProfile. Questo etag può essere utilizzato con l'operazione UPDATE per garantire coerenza.
identityProvider

enum (IdentityProvider)

Solo output. Identifica il fornitore del profilo.
firstEnrollmentTime

string (Timestamp format)

Solo output. Timestamp della prima registrazione del profilo.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
affiliationState

enum (AffiliationState)

Solo output. Lo stato di affiliazione specifico del profilo.
policyCount

string (int64 format)

Solo output. Numero di criteri applicati al profilo.
extensionCount

string (int64 format)

Solo output. Numero di estensioni installate nel profilo.
osPlatformVersion

string

Solo output. Versione principale del sistema operativo del dispositivo su cui esiste il profilo. (ad es. Windows 10)

DeviceInfo

Informazioni su un dispositivo su cui è in esecuzione un profilo del browser Chrome.

Rappresentazione JSON 
{
  "deviceType": enum (DeviceType),
  "affiliatedDeviceId": string,
  "machine": string,
  "hostname": string
}
Campi
deviceType

enum (DeviceType)

Solo output. Tipo di dispositivo su cui esiste il profilo.
affiliatedDeviceId

string

Solo output. ID dispositivo che identifica il dispositivo affiliato su cui esiste il profilo. Se il tipo di dispositivo è CHROME_BROWSER, questo rappresenta un ID API Directory univoco del dispositivo che può essere utilizzato nell'API Browser dell'SDK Admin.
machine

string

Solo output. Nome della macchina del dispositivo su cui esiste il profilo. Sulle piattaforme che non segnalano il nome della macchina (attualmente iOS e Android), questo valore viene impostato sul deviceId del browser, ma tieni presente che si tratta di un deviceId diverso da |affiliatedDeviceId|.
hostname

string

Solo output. Nome host del dispositivo su cui esiste il profilo.

DeviceType

Possibili tipi di dispositivo.

Enum
DEVICE_TYPE_UNSPECIFIED Rappresenta un tipo di dispositivo non specificato.
CHROME_BROWSER Rappresenta un dispositivo con browser Chrome.

AttestationCredential

Informazioni sulla chiave pubblica associata a un profilo del browser Chrome.

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

enum (KeyType)

Solo output. Tipo di chiave pubblica.
keyTrustLevel

enum (KeyTrustLevel)

Solo output. Livello di attendibilità della chiave pubblica.
publicKey

string (bytes format)

Solo output. Valore della chiave pubblica.

Una stringa con codifica Base64.
keyRotationTime

string (Timestamp format)

Solo output. Timestamp dell'ultima rotazione della chiave pubblica.

Un timestamp nel formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

KeyType

Possibili tipi di chiave pubblica.

Enum
KEY_TYPE_UNSPECIFIED Rappresenta un tipo di chiave pubblica non specificato.
RSA_KEY Rappresenta una chiave RSA.
EC_KEY Rappresenta una chiave EC.

KeyTrustLevel

Possibili livelli di attendibilità di una chiave pubblica.

Enum
KEY_TRUST_LEVEL_UNSPECIFIED Rappresenta un livello di attendibilità della chiave pubblica non specificato.
CHROME_BROWSER_HW_KEY Rappresenta una chiave HW.
CHROME_BROWSER_OS_KEY Rappresenta una chiave del sistema operativo.

ReportingData

Dati dei report di un profilo del browser Chrome.

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

string

Solo output. Percorso del file eseguibile del browser Chrome installato. Un percorso valido è incluso solo nei profili affiliati.
installedBrowserVersion

string

Solo output. Versione aggiornata di un browser, se diversa da quella attiva.
profilePath

string

Solo output. Percorso del profilo. Un percorso valido è incluso solo nei profili affiliati.
extensionData[]

object (ExtensionData)

Solo output. Informazioni sulle estensioni installate nel profilo.
policyData[]

object (PolicyData)

Solo output. Informazioni sui criteri applicati al profilo.
extensionPolicyData[]

object (ExtensionPolicyData)

Solo output. Informazioni sui criteri applicati alle estensioni.

ExtensionData

Informazioni su un'estensione installata in un profilo del browser Chrome.

Rappresentazione 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
}
Campi
extensionId

string

Solo output. ID dell'estensione.
version

string

Solo output. Versione dell'estensione.
permissions[]

string

Solo output. Autorizzazioni richieste dall'estensione.
name

string

Solo output. Nome dell'estensione.
description

string

Solo output. Descrizione dell'estensione.
extensionType

enum (ExtensionType)

Solo output. Tipo di estensione.
homepageUri

string

Solo output. L'URL della home page dell'estensione.
installationType

enum (InstallationType)

Solo output. Tipo di installazione dell'estensione.
manifestVersion

integer

Solo output. Versione del manifest dell'estensione.
isDisabled

boolean

Solo output. Indica se l'utente ha disattivato l'estensione.
isWebstoreExtension

boolean

Solo output. Indica se l'estensione proviene dal web store.

ExtensionType

Possibili tipi di un'estensione.

Enum
EXTENSION_TYPE_UNSPECIFIED Rappresenta un tipo di estensione non specificato.
EXTENSION Rappresenta un'estensione.
APP Rappresenta un'app.
THEME Rappresenta un tema.
HOSTED_APP Rappresenta un'app ospitata.

InstallationType

Possibili tipi di installazione di un'estensione.

Enum
INSTALLATION_TYPE_UNSPECIFIED Rappresenta un tipo di installazione non specificato.
MULTIPLE Rappresenta le istanze dell'estensione con tipi di installazione misti.
NORMAL Rappresenta un tipo di installazione normale.
ADMIN Rappresenta un'installazione eseguita dall'amministratore.
DEVELOPMENT Rappresenta un tipo di installazione di sviluppo.
SIDELOAD Rappresenta un tipo di installazione sideload.
OTHER Rappresenta un tipo di installazione non coperto dalle altre opzioni.

PolicyData

Informazioni su un criterio applicato a un profilo del browser Chrome.

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

enum (PolicySource)

Solo output. Origine del criterio.
name

string

Solo output. Nome del criterio.
value

string

Solo output. Valore del criterio.
conflicts[]

object (ConflictingPolicyData)

Solo output. Informazioni sulle norme in conflitto.
error

string

Solo output. Messaggio di errore del criterio, se presente.

PolicySource

Possibili fonti di una norma.

Enum
POLICY_SOURCE_UNSPECIFIED Rappresenta un'origine criterio non specificata.
MACHINE_PLATFORM Rappresenta un criterio della piattaforma a livello di macchina.
USER_PLATFORM Rappresenta un criterio della piattaforma a livello di utente.
MACHINE_LEVEL_USER_CLOUD Rappresenta un criterio relativo al cloud degli utenti a livello di macchina.
USER_CLOUD Rappresenta un criterio relativo al cloud a livello di utente.
MACHINE_MERGED Rappresenta un criterio unito a livello di macchina.

ConflictingPolicyData

Informazioni sui criteri in conflitto applicati a un profilo del browser Chrome.

Rappresentazione JSON 
{
  "source": enum (PolicySource)
}
Campi
source

enum (PolicySource)

Solo output. Origine del criterio.

ExtensionPolicyData

Informazioni sui criteri applicati a un'estensione.

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

string

Solo output. ID dell'estensione.
extensionName

string

Solo output. Nome dell'estensione.
policyData[]

object (PolicyData)

Solo output. Informazioni sui criteri applicati all'estensione.

IdentityProvider

Possibili provider di identità di un profilo.

Enum
IDENTITY_PROVIDER_UNSPECIFIED Rappresenta un provider di identità non specificato.
GOOGLE_IDENTITY_PROVIDER Rappresenta un provider di identità Google.
EXTERNAL_IDENTITY_PROVIDER Rappresenta un provider di identità esterno.

AffiliationState

Lo stato specifico dell'affiliazione per il profilo. In futuro potrebbero essere aggiunti nuovi valori.

Enum
AFFILIATION_STATE_UNSPECIFIED Stato di affiliazione non specificato.
UNAFFILIATED_GENERIC Non affiliato, ma non disponiamo dei dettagli per il tipo di profilo non affiliato.
PROFILE_ONLY Non affiliato: un profilo gestito che appare su un browser completamente non gestito.
UNAFFILIATED_LOCAL_MACHINE Non affiliato: un profilo gestito visualizzato su una macchina gestita localmente da un'altra organizzazione (tramite meccanismi di gestione della piattaforma come GPO).
UNAFFILIATED_CLOUD_MACHINE Non affiliato: un profilo gestito visualizzato in un browser gestito gestito nel cloud da un'altra organizzazione (utilizzando Chrome Browser Cloud Management).
AFFILIATED_CLOUD_MANAGED Affiliato: sia il profilo sia il browser gestito sono gestiti dalla stessa organizzazione.

Metodi

delete

 Consente di eliminare i dati raccolti da un profilo del browser Chrome.

get

 Ottiene un profilo del browser Chrome con ID cliente e ID permanente del profilo.

list

 Elenca i profili del browser Chrome di un cliente in base ai criteri di ricerca e ordinamento specificati.