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 permanente del profilo è 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 Admin SDK Users.
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.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
lastPolicyFetchTime

string (Timestamp format)

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

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
lastPolicySyncTime

string (Timestamp format)

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

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
lastStatusReportTime

string (Timestamp format)

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

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
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 la coerenza.
identityProvider

enum (IdentityProvider)

Solo output. Identifica il provider del profilo.
firstEnrollmentTime

string (Timestamp format)

Solo output. Timestamp della prima registrazione del profilo.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
affiliationState

enum (AffiliationState)

Solo output. Lo stato specifico dell'affiliazione 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 della piattaforma del sistema operativo del dispositivo su cui esiste il profilo, dai report sui profili.

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. L'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.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

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 dalla versione 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 da parte dell'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 cloud utente a livello di macchina.
USER_CLOUD Rappresenta un criterio cloud a livello di utente.
MACHINE_MERGED Rappresenta un criterio accorpato 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 appartenenza non specificato.
UNAFFILIATED_GENERIC Non affiliato, ma non disponiamo dei dettagli relativi al tipo di profilo non affiliato.
PROFILE_ONLY Non affiliato: un profilo gestito visualizzato su un browser completamente non gestito.
UNAFFILIATED_LOCAL_MACHINE Non affiliato: un profilo gestito visualizzato su un computer gestito localmente da un'altra organizzazione (tramite meccanismi di gestione della piattaforma come i GPO).
UNAFFILIATED_CLOUD_MACHINE Non affiliato: un profilo gestito visualizzato su un browser gestito che è gestito su cloud da un'organizzazione diversa (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

 Recupera un profilo del browser Chrome con l'ID cliente e l'ID profilo permanente.

list

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