REST Resource: customers.chromeBrowsers

Recurso: ChromeBrowser

Un dispositivo con navegadores Chrome administrados

Representación JSON
{
  "name": string,
  "browserPermanentId": string,
  "lastPolicyFetchTime": string,
  "osPlatform": string,
  "osArchitecture": string,
  "osVersion": string,
  "machineName": string,
  "annotatedLocation": string,
  "annotatedUser": string,
  "annotatedAssetId": string,
  "annotatedNotes": string,
  "lastRegistrationTime": string,
  "extensionCount": string,
  "policyCount": string,
  "lastDeviceUser": string,
  "lastActivityTime": string,
  "osPlatformVersion": string,
  "browserVersions": [
    string
  ],
  "lastStatusReportTime": string,
  "lastDeviceUsers": [
    {
      object (BrowserUser)
    }
  ],
  "machinePolicies": [
    {
      object (Policy)
    }
  ],
  "browsers": [
    {
      object (Browser)
    }
  ],
  "serialNumber": string,
  "virtualDeviceId": string,
  "machineExtensionPolicies": [
    {
      object (ExtensionPolicy)
    }
  ],
  "orgUnitId": string,
  "deviceIdentifiersHistory": {
    object (DeviceIdentifiersHistory)
  },
  "attestationCredential": {
    object (AttestationCredential)
  },
  "omahaRecentFetchTime": string
}
Campos
name

string

Es el identificador. Formato: customers/{customerId}/chromeBrowsers/{browserPermanentId}

browserPermanentId

string

Solo salida. Es el identificador único del navegador Chrome.

lastPolicyFetchTime

string (Timestamp format)

Solo salida. Fecha y hora en que se realizó correctamente la última recuperación de políticas en este dispositivo.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

osPlatform

string

Solo salida. Es la plataforma del SO del dispositivo.

osArchitecture

string

Solo salida. Arquitectura de la CPU del dispositivo.

osVersion

string

Solo salida. Es la versión del SO del dispositivo.

machineName

string

Solo salida. Nombre de la máquina.

annotatedLocation

string

Opcional. Dirección o ubicación del dispositivo anotada por el administrador

annotatedUser

string

Opcional. Usuario del dispositivo anotado por el administrador

annotatedAssetId

string

Opcional. Identificador de recurso anotado por el administrador o especificado durante la inscripción

annotatedNotes

string

Opcional. Notas sobre este dispositivo anotadas por el administrador

lastRegistrationTime

string (Timestamp format)

Solo salida. Fecha y hora en que el dispositivo intentó registrarse por última vez.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

extensionCount

string (int64 format)

Solo salida. Es la cantidad de extensiones distintas instaladas en todos los navegadores Chrome de este dispositivo.

policyCount

string (int64 format)

Solo salida. Es la cantidad de políticas distintas establecidas en todos los navegadores Chrome de este dispositivo.

lastDeviceUser

string

Solo salida. Es el último usuario que accedió a un navegador Chrome en este dispositivo.

lastActivityTime

string (Timestamp format)

Solo salida. Es la fecha y hora de la última actividad en el dispositivo, ya sea por informes, recuperación de políticas o registro.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

osPlatformVersion

string

Solo salida. Es la combinación de la plataforma y la versión del SO del dispositivo.

browserVersions[]

string

Solo salida. Es la lista de todas las versiones del navegador instaladas en este dispositivo.

lastStatusReportTime

string (Timestamp format)

Solo salida. Fecha y hora en que el dispositivo envió un informe de estado por última vez.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

lastDeviceUsers[]

object (BrowserUser)

Solo salida. Lista de usuarios recientes del navegador, en orden descendente según la hora del último informe.

machinePolicies[]

object (Policy)

Solo salida. Es la lista de todas las políticas establecidas a nivel del dispositivo para los navegadores Chrome en este dispositivo.

browsers[]

object (Browser)

Solo salida. Es la lista de navegadores Chrome instalados en este dispositivo.

serialNumber

string

Solo salida. Es el número de serie del dispositivo.

virtualDeviceId

string

Solo salida. Es el ID inicial del dispositivo que envió el primer navegador Chrome que inscribió este dispositivo.

machineExtensionPolicies[]

object (ExtensionPolicy)

Solo salida. Es la lista de todas las políticas a nivel del dispositivo establecidas para las extensiones instaladas en Chrome en este dispositivo.

orgUnitId

string

Solo salida. Es el ID de la unidad organizativa ofuscado del navegador.

deviceIdentifiersHistory

object (DeviceIdentifiersHistory)

Solo salida. Historial de identificadores informados a este dispositivo.

attestationCredential

object (AttestationCredential)

Solo salida. Es la credencial de certificación que se usa para el conector de confianza del dispositivo.

omahaRecentFetchTime

string (Timestamp format)

Solo salida. Actividad reciente de recuperación de políticas por parte de Omaha. No necesariamente la última recuperación, ya que este campo solo se actualiza a diario.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

BrowserUser

Usuario del navegador Chrome

Representación JSON
{
  "userName": string,
  "lastStatusReportTime": string
}
Campos
userName

string

Solo salida. Es el nombre de usuario del usuario que accedió a Chrome.

lastStatusReportTime

string (Timestamp format)

Solo salida. Es la fecha y hora en la que la información del usuario informó un estado por última vez.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

Política

Es la política aplicada que informa un navegador Chrome administrado. La política se puede aplicar en varios ámbitos (máquina, perfil, extensión).

Representación JSON
{
  "source": enum (PolicySource),
  "policyName": string,
  "value": string,
  "error": string
}
Campos
source

enum (PolicySource)

Solo salida. Es la fuente de la política.

policyName

string

Solo salida. Es el nombre de la política.

value

string

Solo salida. Es el valor de la política.

error

string

Solo salida. Es una cadena localizada con todos los errores que se informaron al intentar aplicar esta política, si corresponde.

Navegador

Es una instalación específica de Chrome en un dispositivo con navegadores Chrome administrados.

Representación JSON
{
  "browserVersion": string,
  "channel": enum (Channel),
  "lastStatusReportTime": string,
  "lastPolicyFetchTime": string,
  "executablePath": string,
  "plugins": [
    {
      object (Plugin)
    }
  ],
  "profiles": [
    {
      object (Profile)
    }
  ],
  "pendingInstallVersion": string
}
Campos
browserVersion

string

Solo salida. Versión del navegador instalada.

channel

enum (Channel)

Solo salida. Canal del navegador instalado.

lastStatusReportTime

string (Timestamp format)

Solo salida. Fecha y hora en que se recibió el último informe de este navegador Chrome.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

lastPolicyFetchTime

string (Timestamp format)

Solo salida. Fecha y hora en que se realizó correctamente la última solicitud para recuperar políticas en este navegador Chrome.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

executablePath

string

Solo salida. Es la ruta de acceso al ejecutable Chrome.exe para este navegador.

plugins[]

object (Plugin)

Solo salida. Es la lista de todos los complementos instalados en este navegador Chrome.

profiles[]

object (Profile)

Solo salida. Es la lista de perfiles de este navegador.

pendingInstallVersion

string

Solo salida. Se instaló la versión pendiente de un navegador. Este campo solo se configura cuando el navegador activo actual tiene una versión diferente a la de "browserVersion".

Canal

Son los posibles canales de versiones de un navegador.

Enums
CHANNEL_UNSPECIFIED Representa un canal no especificado.
CHANNEL_STABLE Representa un canal estable.
CHANNEL_BETA Representa un canal beta.
CHANNEL_DEV Representa un canal para desarrolladores.
CHANNEL_CANARY Representa un canal de versión canary.

Complemento

Es información sobre un complemento del navegador Chrome instalado en una instalación de Chrome informada en un dispositivo con navegadores Chrome administrados.

Representación JSON
{
  "pluginName": string,
  "description": string,
  "filename": string
}
Campos
pluginName

string

Solo salida. Es el nombre del complemento instalado.

description

string

Solo salida. Es la descripción del complemento instalado.

filename

string

Solo salida. Nombre de archivo del complemento instalado.

Perfil

Es un perfil informado en una instalación de Chrome en un dispositivo con navegadores Chrome administrados.

Representación JSON
{
  "profileName": string,
  "id": string,
  "lastStatusReportTime": string,
  "lastPolicyFetchTime": string,
  "safeBrowsingWarnings": string,
  "safeBrowsingWarningsClickThroughs": string,
  "chromeSignedInUserEmail": string,
  "extensions": [
    {
      object (Extension)
    }
  ],
  "userPolicies": [
    {
      object (Policy)
    }
  ],
  "extensionPolicies": [
    {
      object (ExtensionPolicy)
    }
  ],
  "safeBrowsingWarningsResetTime": string
}
Campos
profileName

string

Solo salida. Es el nombre que se le asignó a este perfil.

id

string

Solo salida. Es un ID único para este perfil.

lastStatusReportTime

string (Timestamp format)

Solo salida. Es la fecha y hora en que se recibió el último informe de este perfil.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

lastPolicyFetchTime

string (Timestamp format)

Solo salida. Es la fecha y hora en que se realizó correctamente la última solicitud para recuperar políticas de este perfil.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

safeBrowsingWarnings

string (int64 format)

Solo salida. Es la cantidad de advertencias de Navegación segura que se mostraron en este perfil.

safeBrowsingWarningsClickThroughs

string (int64 format)

Solo salida. Es la cantidad de advertencias de Navegación segura en las que se hizo clic en este perfil.

chromeSignedInUserEmail

string

Solo salida. Es el correo electrónico del usuario que accedió a este perfil, si corresponde.

extensions[]

object (Extension)

Solo salida. Es la lista de extensiones instaladas para este perfil.

userPolicies[]

object (Policy)

Solo salida. Es la lista de políticas del navegador Chrome aplicadas a este perfil.

extensionPolicies[]

object (ExtensionPolicy)

Solo salida. Es la lista de extensiones con políticas de extensiones aplicadas.

safeBrowsingWarningsResetTime

string (Timestamp format)

Solo salida. Fecha y hora en que se restableció la información de advertencia de la Navegación segura a 0 por última vez.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

Extensión

Es información sobre las extensiones instaladas en el perfil que se informa en un Chrome instalado en un dispositivo con navegadores Chrome administrados.

Representación JSON
{
  "extensionId": string,
  "version": string,
  "permissions": [
    string
  ],
  "extensionName": string,
  "description": string,
  "appType": enum (ExtensionType),
  "homepageUri": string,
  "installType": enum (InstallationType),
  "configuredAppPolicy": enum (ConfiguredAppPolicy),
  "disabled": boolean,
  "icons": [
    {
      object (ExtensionIcon)
    }
  ],
  "manifestVersion": integer
}
Campos
extensionId

string

Solo salida. Es el ID de la extensión.

version

string

Solo salida. Es la versión de la extensión.

permissions[]

string

Solo salida. Es la lista de permisos que requiere esta extensión.

extensionName

string

Solo salida. Es el nombre localizado de esta extensión, tal como lo informa Chrome.

description

string

Solo salida. Es la descripción localizada de esta extensión.

appType

enum (ExtensionType)

Solo salida. Es el tipo de extensión.

homepageUri

string

Solo salida. Es la URL de la página principal de esta extensión.

installType

enum (InstallationType)

Solo salida. Forma en que se instaló la extensión.

configuredAppPolicy

enum (ConfiguredAppPolicy)

Solo salida. Indica si la extensión está controlada por una política del navegador.

disabled

boolean

Solo salida. Indica si la extensión está inhabilitada.

icons[]

object (ExtensionIcon)

Solo salida. Es la lista de íconos disponibles para esta extensión.

manifestVersion

integer

Solo salida. Es la versión del manifiesto de esta extensión.

ConfiguredAppPolicy

Son las políticas de la app que se pueden configurar para una extensión.

Enums
CONFIGURED_APP_POLICY_UNSPECIFIED Representa una política de app configurada no especificada.
CONFIGURED_APP_POLICY_NONE Representa que no hay una política de la app configurada.
CONFIGURED_APP_POLICY_SHOULD_FORCE Representa una extensión que se debe forzar.
CONFIGURED_APP_POLICY_SHOULD_BLOCK Representa una extensión que se debe bloquear.

ExtensionIcon

Ícono de una extensión del navegador Chrome.

Representación JSON
{
  "size": integer,
  "uri": string
}
Campos
size

integer

Solo salida. Tamaño del ícono de la extensión.

uri

string

Solo salida. Es la URL del ícono de la extensión.

ExtensionPolicy

Son las políticas informadas que se aplican a una extensión instalada en un perfil de Chrome.

Representación JSON
{
  "extensionId": string,
  "extensionName": string,
  "policies": [
    {
      object (Policy)
    }
  ]
}
Campos
extensionId

string

Solo salida. Es el ID de la extensión a la que se aplican las políticas.

extensionName

string

Solo salida. Es el nombre de la extensión a la que se aplican las políticas.

policies[]

object (Policy)

Solo salida. Es la lista de políticas aplicadas a esta extensión.

DeviceIdentifiersHistory

Historial de los identificadores de dispositivos que se informaron desde un dispositivo.

Representación JSON
{
  "records": [
    {
      object (DeviceIdentifiersRecord)
    }
  ],
  "deviceIdCollision": boolean,
  "lastDeviceIdCollisionDetectionTime": string
}
Campos
records[]

object (DeviceIdentifiersRecord)

Solo salida. Es la lista de identificadores de dispositivos que envía este dispositivo. En orden descendente según lastActivityTime.

deviceIdCollision

boolean

Solo salida. Es posible que varios dispositivos estén usando el ID del dispositivo.

lastDeviceIdCollisionDetectionTime

string (Timestamp format)

Solo salida. Es la última vez que detectamos una colisión de ID de dispositivo.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

DeviceIdentifiersRecord

Registro de los identificadores de dispositivo y cuándo se informaron.

Representación JSON
{
  "identifiers": {
    object (DeviceIdentifiers)
  },
  "firstRecordTime": string,
  "lastActivityTime": string
}
Campos
identifiers

object (DeviceIdentifiers)

Solo salida. Identificadores de dispositivos

firstRecordTime

string (Timestamp format)

Solo salida. Es la primera vez que se informaron estos identificadores.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

lastActivityTime

string (Timestamp format)

Solo salida. Es la fecha y hora de la última actividad de estos identificadores, ya sea por informes, recuperación de políticas o registro.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

DeviceIdentifiers

Es una colección de identificadores de dispositivos.

Representación JSON
{
  "machineName": string,
  "serialNumber": string,
  "hostName": string
}
Campos
machineName

string

Solo salida. Es el nombre de la máquina asociada con el dispositivo.

serialNumber

string

Solo salida. Es el número de serie del dispositivo.

hostName

string

Solo salida. Es el nombre de host del dispositivo.

Métodos

delete

Borra los datos recopilados de un perfil del navegador Chrome.

get

Recupera un solo navegador Chrome identificado por su ID de cliente y su ID de recurso.

list

Recupera todos los navegadores Chrome de un cliente (paginados).

move

Mueve los navegadores Chrome administrados a una nueva unidad organizativa (UO).

patch

Actualiza la información de anotación de un navegador Chrome.