REST Resource: customers.profiles

Recurso: ChromeBrowserProfile

Uma representação de um perfil do navegador Chrome.

Representação 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
}
Campos
name

string

Identificador. Formato: customers/{customer_id}/profiles/{profilePermanentId}

profileId

string

Apenas saída. ID do perfil do lado do cliente do Chrome.

profilePermanentId

string

Apenas saída. O ID permanente do perfil é o identificador exclusivo de um perfil dentro de um cliente.

displayName

string

Apenas saída. Nome de exibição do perfil definido pelo cliente.

userId

string

Apenas saída. ID exclusivo da API Directory do usuário que pode ser usado na API Admin SDK Users.

userEmail

string

Apenas saída. Endereço de e-mail do usuário ao qual o perfil pertence.

lastActivityTime

string (Timestamp format)

Apenas saída. Carimbo de data/hora da atividade mais recente do perfil.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

lastPolicyFetchTime

string (Timestamp format)

Apenas saída. Carimbo de data/hora da busca de políticas mais recente pelo perfil.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

lastPolicySyncTime

string (Timestamp format)

Apenas saída. Carimbo de data/hora da última sincronização de política pelo perfil.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

lastStatusReportTime

string (Timestamp format)

Apenas saída. Carimbo de data/hora do relatório de status mais recente do perfil.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

deviceInfo

object (DeviceInfo)

Apenas saída. Informações básicas do dispositivo em que o perfil existe. Essas informações estão disponíveis apenas para os perfis afiliados.

osPlatformType

string

Apenas saída. Plataforma do SO do dispositivo em que o perfil existe.

osVersion

string

Apenas saída. Versão do SO do dispositivo em que o perfil existe.

browserVersion

string

Apenas saída. Versão do navegador em que o perfil existe.

browserChannel

string

Apenas saída. Canal do navegador em que o perfil existe.

annotatedLocation

string

Opcional. Local do perfil anotado pelo administrador.

annotatedUser

string

Opcional. Usuário do perfil anotado pelo administrador.

attestationCredential

object (AttestationCredential)

Apenas saída. Informações das credenciais de atestado do perfil.

reportingData

object (ReportingData)

Apenas saída. Dados de relatórios detalhados do perfil. Essas informações só estão disponíveis quando a política de relatórios de perfil está ativada.

etag

string

Apenas saída. Etag deste recurso do ChromeBrowserProfile. Essa ETag pode ser usada com a operação UPDATE para garantir a consistência.

identityProvider

enum (IdentityProvider)

Apenas saída. Identifique o provedor do perfil.

firstEnrollmentTime

string (Timestamp format)

Apenas saída. Carimbo de data/hora da primeira inscrição do perfil.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

affiliationState

enum (AffiliationState)

Apenas saída. O estado de afiliação específico do perfil.

policyCount

string (int64 format)

Apenas saída. Número de políticas aplicadas no perfil.

extensionCount

string (int64 format)

Apenas saída. Número de extensões instaladas no perfil.

osPlatformVersion

string

Apenas saída. Versão principal do SO do dispositivo em que o perfil existe. (por exemplo, Windows 10)

DeviceInfo

Informações de um dispositivo que executa um perfil do navegador Chrome.

Representação JSON
{
  "deviceType": enum (DeviceType),
  "affiliatedDeviceId": string,
  "machine": string,
  "hostname": string
}
Campos
deviceType

enum (DeviceType)

Apenas saída. Tipo de dispositivo em que o perfil existe.

affiliatedDeviceId

string

Apenas saída. ID do dispositivo que identifica o dispositivo afiliado em que o perfil existe. Se o tipo de dispositivo for CHROME_BROWSER, isso representa um ID exclusivo da API Directory do dispositivo que pode ser usado na API Browsers do SDK Admin.

machine

string

Apenas saída. Nome da máquina do dispositivo em que o perfil existe. Em plataformas que não informam o nome da máquina (atualmente iOS e Android), esse valor é definido como o deviceId do navegador, mas é um deviceId diferente do |affiliatedDeviceId|.

hostname

string

Apenas saída. Nome do host do dispositivo em que o perfil existe.

DeviceType

Possíveis tipos de dispositivo.

Enums
DEVICE_TYPE_UNSPECIFIED Representa um tipo de dispositivo não especificado.
CHROME_BROWSER Representa um dispositivo com o navegador Chrome.

AttestationCredential

Informações da chave pública associada a um perfil do navegador Chrome.

Representação JSON
{
  "keyType": enum (KeyType),
  "keyTrustLevel": enum (KeyTrustLevel),
  "publicKey": string,
  "keyRotationTime": string
}
Campos
keyType

enum (KeyType)

Apenas saída. Tipo de chave pública.

keyTrustLevel

enum (KeyTrustLevel)

Apenas saída. Nível de confiança da chave pública.

publicKey

string (bytes format)

Apenas saída. Valor da chave pública.

Uma string codificada em base64.

keyRotationTime

string (Timestamp format)

Apenas saída. Carimbo de data/hora da última rotação da chave pública.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

KeyType

Tipos possíveis de chave pública.

Enums
KEY_TYPE_UNSPECIFIED Representa um tipo de chave pública não especificado.
RSA_KEY Representa uma chave RSA.
EC_KEY Representa uma chave EC.

KeyTrustLevel

Possíveis níveis de confiança de uma chave pública.

Enums
KEY_TRUST_LEVEL_UNSPECIFIED Representa um nível de confiança de chave pública não especificado.
CHROME_BROWSER_HW_KEY Representa uma chave de hardware.
CHROME_BROWSER_OS_KEY Representa uma chave do SO.

ReportingData

Dados de relatórios de um perfil do navegador Chrome.

Representação JSON
{
  "browserExecutablePath": string,
  "installedBrowserVersion": string,
  "profilePath": string,
  "extensionData": [
    {
      object (ExtensionData)
    }
  ],
  "policyData": [
    {
      object (PolicyData)
    }
  ],
  "extensionPolicyData": [
    {
      object (ExtensionPolicyData)
    }
  ]
}
Campos
browserExecutablePath

string

Apenas saída. Caminho executável do navegador Chrome instalado. Um caminho válido é incluído apenas em perfis afiliados.

installedBrowserVersion

string

Apenas saída. Versão atualizada de um navegador, se for diferente da versão ativa.

profilePath

string

Apenas saída. Caminho do perfil. Um caminho válido é incluído apenas em perfis afiliados.

extensionData[]

object (ExtensionData)

Apenas saída. Informações das extensões instaladas no perfil.

policyData[]

object (PolicyData)

Apenas saída. Informações sobre as políticas aplicadas no perfil.

extensionPolicyData[]

object (ExtensionPolicyData)

Apenas saída. Informações sobre as políticas aplicadas às extensões.

ExtensionData

Informações de uma extensão instalada em um perfil do navegador Chrome.

Representação 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
}
Campos
extensionId

string

Apenas saída. ID da extensão.

version

string

Apenas saída. Versão da extensão.

permissions[]

string

Apenas saída. Permissões solicitadas pela extensão.

name

string

Apenas saída. Nome da extensão.

description

string

Apenas saída. Descrição da extensão.

extensionType

enum (ExtensionType)

Apenas saída. Tipo de extensão.

homepageUri

string

Apenas saída. O URL da página inicial da extensão.

installationType

enum (InstallationType)

Apenas saída. Tipo de instalação da extensão.

manifestVersion

integer

Apenas saída. Versão do manifesto da extensão.

isDisabled

boolean

Apenas saída. Representa se o usuário desativou a extensão.

isWebstoreExtension

boolean

Apenas saída. Representa se a extensão é da loja da Web.

ExtensionType

Tipos possíveis de uma extensão.

Enums
EXTENSION_TYPE_UNSPECIFIED Representa um tipo de extensão não especificado.
EXTENSION Representa uma extensão.
APP Representa um app.
THEME Representa um tema.
HOSTED_APP Representa um app hospedado.

InstallationType

Possíveis tipos de instalação de uma extensão.

Enums
INSTALLATION_TYPE_UNSPECIFIED Representa um tipo de instalação não especificado.
MULTIPLE Representa instâncias da extensão com tipos de instalação mistas.
NORMAL Representa um tipo de instalação normal.
ADMIN Representa uma instalação feita pelo administrador.
DEVELOPMENT Representa um tipo de instalação de desenvolvimento.
SIDELOAD Representa um tipo de instalação de sideload.
OTHER Representa um tipo de instalação que não é abordado nas outras opções.

PolicyData

Informações de uma política aplicada em um perfil do navegador Chrome.

Representação JSON
{
  "source": enum (PolicySource),
  "name": string,
  "value": string,
  "conflicts": [
    {
      object (ConflictingPolicyData)
    }
  ],
  "error": string
}
Campos
source

enum (PolicySource)

Apenas saída. Origem da política.

name

string

Apenas saída. Nome da política.

value

string

Apenas saída. Valor da política.

conflicts[]

object (ConflictingPolicyData)

Apenas saída. Informações de política conflitantes.

error

string

Apenas saída. Mensagem de erro da política, se houver.

PolicySource

Possíveis origens de uma política.

Enums
POLICY_SOURCE_UNSPECIFIED Representa uma origem da política não especificada.
MACHINE_PLATFORM Representa uma política de plataforma no nível da máquina.
USER_PLATFORM Representa uma política de plataforma no nível do usuário.
MACHINE_LEVEL_USER_CLOUD Representa uma política de nuvem do usuário no nível da máquina.
USER_CLOUD Representa uma política de nuvem no nível do usuário.
MACHINE_MERGED Representa uma política mesclada no nível da máquina.

ConflictingPolicyData

Informações sobre a política em conflito aplicada em um perfil do navegador Chrome.

Representação JSON
{
  "source": enum (PolicySource)
}
Campos
source

enum (PolicySource)

Apenas saída. Origem da política.

ExtensionPolicyData

Informações sobre as políticas aplicadas a uma extensão.

Representação JSON
{
  "extensionId": string,
  "extensionName": string,
  "policyData": [
    {
      object (PolicyData)
    }
  ]
}
Campos
extensionId

string

Apenas saída. ID da extensão.

extensionName

string

Apenas saída. Nome da extensão.

policyData[]

object (PolicyData)

Apenas saída. Informações sobre as políticas aplicadas à extensão.

IdentityProvider

Possíveis provedores de identidade de um perfil.

Enums
IDENTITY_PROVIDER_UNSPECIFIED Representa um provedor de identidade não especificado.
GOOGLE_IDENTITY_PROVIDER Representa um provedor de identidade do Google.
EXTERNAL_IDENTITY_PROVIDER Representa um provedor de identidade externo.

AffiliationState

O estado de afiliação específico do perfil. Novos valores podem ser adicionados no futuro.

Enums
AFFILIATION_STATE_UNSPECIFIED Estado de afiliação não especificado.
UNAFFILIATED_GENERIC Não afiliado, mas não temos detalhes sobre o tipo de perfil não afiliado.
PROFILE_ONLY Não afiliado - Um perfil gerenciado que aparece em um navegador totalmente não gerenciado.
UNAFFILIATED_LOCAL_MACHINE Não afiliado: um perfil gerenciado que aparece em uma máquina gerenciada localmente por uma organização diferente (por mecanismos de gerenciamento de plataforma, como GPO).
UNAFFILIATED_CLOUD_MACHINE Não afiliado: um perfil gerenciado que aparece em um navegador gerenciado e gerenciado na nuvem por uma organização diferente (usando o Gerenciamento de nuvem do navegador Chrome).
AFFILIATED_CLOUD_MANAGED Afiliado: o perfil e o navegador gerenciado são gerenciados pela mesma organização.

Métodos

delete

Exclui os dados coletados de um perfil do navegador Chrome.

get

Recupera um perfil do navegador Chrome com o ID do cliente e o ID permanente do perfil.

list

Lista os perfis do navegador Chrome de um cliente com base nos critérios de pesquisa e classificação fornecidos.