REST Resource: customers.profiles

Recurso: ChromeBrowserProfile

Representación de un perfil del navegador Chrome.

Representación 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

Solo salida. Es el ID del perfil del cliente de Chrome.

profilePermanentId

string

Solo salida. El ID permanente del perfil es el identificador único de un perfil dentro de un cliente.

displayName

string

Solo salida. Es el nombre visible del perfil que establece el cliente.

userId

string

Solo salida. Es el ID de API de Directory único del usuario que se puede usar en la API de Users del SDK de Admin.

userEmail

string

Solo salida. Dirección de correo electrónico del usuario al que pertenece el perfil.

lastActivityTime

string (Timestamp format)

Solo salida. Marca de tiempo de la actividad más reciente según el perfil.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "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. Marca de tiempo de la última actualización de políticas que realizó el perfil.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

lastPolicySyncTime

string (Timestamp format)

Solo salida. Marca de tiempo de la sincronización de políticas más reciente del perfil.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

lastStatusReportTime

string (Timestamp format)

Solo salida. Marca de tiempo del informe de estado más reciente del perfil.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

deviceInfo

object (DeviceInfo)

Solo salida. Es la información básica del dispositivo en el que existe el perfil. Esta información solo está disponible para los perfiles afiliados.

osPlatformType

string

Solo salida. Es la plataforma del SO del dispositivo en el que existe el perfil.

osVersion

string

Solo salida. Es la versión del SO del dispositivo en el que existe el perfil.

browserVersion

string

Solo salida. Es la versión del navegador en la que existe el perfil.

browserChannel

string

Solo salida. Es el canal del navegador en el que existe el perfil.

annotatedLocation

string

Opcional. Es la ubicación del perfil que anotó el administrador.

annotatedUser

string

Opcional. Es el usuario del perfil que anoto el administrador.

attestationCredential

object (AttestationCredential)

Solo salida. Información de la credencial de certificación del perfil.

reportingData

object (ReportingData)

Solo salida. Datos de informes detallados del perfil. Esta información solo está disponible cuando la política de informes de perfiles está habilitada.

etag

string

Solo salida. Etag de este recurso ChromeBrowserProfile. Esta etiqueta puede usarse con la operación UPDATE para garantizar la coherencia.

identityProvider

enum (IdentityProvider)

Solo salida. Identifica el proveedor del perfil.

firstEnrollmentTime

string (Timestamp format)

Solo salida. Marca de tiempo de la primera inscripción del perfil.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

affiliationState

enum (AffiliationState)

Solo salida. El estado de afiliación específico del perfil.

policyCount

string (int64 format)

Solo salida. Cantidad de políticas aplicadas en el perfil.

extensionCount

string (int64 format)

Solo salida. Cantidad de extensiones instaladas en el perfil.

osPlatformVersion

string

Solo salida. Es la versión principal de la plataforma del SO del dispositivo en el que existe el perfil, según los informes de perfiles.

DeviceInfo

Información de un dispositivo que ejecuta un perfil del navegador Chrome.

Representación JSON
{
  "deviceType": enum (DeviceType),
  "affiliatedDeviceId": string,
  "machine": string,
  "hostname": string
}
Campos
deviceType

enum (DeviceType)

Solo salida. Es el tipo de dispositivo en el que existe el perfil.

affiliatedDeviceId

string

Solo salida. Es el ID de dispositivo que identifica el dispositivo afiliado en el que existe el perfil. Si el tipo de dispositivo es CHROME_BROWSER, este representa un ID de API de Directory único del dispositivo que se puede usar en la API de Browsers del SDK de Admin.

machine

string

Solo salida. Es el nombre de la máquina del dispositivo en el que existe el perfil. En las plataformas que no informan el nombre de la máquina (actualmente, iOS y Android), se establece en el deviceId del navegador, pero ten en cuenta que es un deviceId diferente al |affiliatedDeviceId|.

hostname

string

Solo salida. Es el nombre de host del dispositivo en el que existe el perfil.

DeviceType

Son los tipos posibles de un dispositivo.

Enumeraciones
DEVICE_TYPE_UNSPECIFIED Representa un tipo de dispositivo no especificado.
CHROME_BROWSER Representa un dispositivo con navegador Chrome.

AttestationCredential

Información de la clave pública asociada con un perfil del navegador Chrome.

Representación JSON
{
  "keyType": enum (KeyType),
  "keyTrustLevel": enum (KeyTrustLevel),
  "publicKey": string,
  "keyRotationTime": string
}
Campos
keyType

enum (KeyType)

Solo salida. Es el tipo de clave pública.

keyTrustLevel

enum (KeyTrustLevel)

Solo salida. Es el nivel de confianza de la clave pública.

publicKey

string (bytes format)

Solo salida. Es el valor de la clave pública.

String codificada en base64.

keyRotationTime

string (Timestamp format)

Solo salida. Es la marca de tiempo de rotación más reciente de la rotación de claves públicas.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

KeyType

Posibles tipos de una clave pública.

Enumeraciones
KEY_TYPE_UNSPECIFIED Representa un tipo de clave pública no especificado.
RSA_KEY Representa una clave RSA.
EC_KEY Representa una clave EC.

KeyTrustLevel

Posibles niveles de confianza de una clave pública.

Enumeraciones
KEY_TRUST_LEVEL_UNSPECIFIED Representa un nivel de confianza de clave pública no especificado.
CHROME_BROWSER_HW_KEY Representa una clave de hardware.
CHROME_BROWSER_OS_KEY Representa una clave del SO.

ReportingData

Datos de informes de un perfil del navegador Chrome

Representación JSON
{
  "browserExecutablePath": string,
  "installedBrowserVersion": string,
  "profilePath": string,
  "extensionData": [
    {
      object (ExtensionData)
    }
  ],
  "policyData": [
    {
      object (PolicyData)
    }
  ],
  "extensionPolicyData": [
    {
      object (ExtensionPolicyData)
    }
  ]
}
Campos
browserExecutablePath

string

Solo salida. Es la ruta de acceso al archivo ejecutable del navegador Chrome instalado. Una ruta válida solo se incluye en los perfiles afiliados.

installedBrowserVersion

string

Solo salida. Es la versión actualizada de un navegador, si es diferente de la versión activa.

profilePath

string

Solo salida. Es la ruta del perfil. Una ruta válida solo se incluye en los perfiles afiliados.

extensionData[]

object (ExtensionData)

Solo salida. Información de las extensiones instaladas en el perfil.

policyData[]

object (PolicyData)

Solo salida. Información de las políticas aplicadas en el perfil.

extensionPolicyData[]

object (ExtensionPolicyData)

Solo salida. Información de las políticas aplicadas en las extensiones.

ExtensionData

Información de una extensión instalada en un perfil del navegador Chrome.

Representación 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

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. Permisos que solicitó la extensión.

name

string

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

description

string

Solo salida. Descripción de la extensión.

extensionType

enum (ExtensionType)

Solo salida. Es el tipo de extensión.

homepageUri

string

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

installationType

enum (InstallationType)

Solo salida. Es el tipo de instalación de la extensión.

manifestVersion

integer

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

isDisabled

boolean

Solo salida. Representa si el usuario inhabilitó la extensión.

isWebstoreExtension

boolean

Solo salida. Indica si la extensión es de la tienda web.

ExtensionType

Son los tipos posibles de una extensión.

Enumeraciones
EXTENSION_TYPE_UNSPECIFIED Representa un tipo de extensión no especificado.
EXTENSION Representa una extensión.
APP Representa una app.
THEME Representa un tema.
HOSTED_APP Representa una app alojada.

InstallationType

Posibles tipos de instalación de una extensión.

Enumeraciones
INSTALLATION_TYPE_UNSPECIFIED Representa un tipo de instalación no especificado.
MULTIPLE Representa instancias de la extensión que tienen tipos de instalación mixtos.
NORMAL Representa un tipo de instalación normal.
ADMIN Representa una instalación realizada por el administrador.
DEVELOPMENT Representa un tipo de instalación de desarrollo.
SIDELOAD Representa un tipo de instalación de transferencia lateral.
OTHER Representa un tipo de instalación que no se incluye en las otras opciones.

PolicyData

Información de una política aplicada a un perfil del navegador Chrome.

Representación JSON
{
  "source": enum (PolicySource),
  "name": string,
  "value": string,
  "conflicts": [
    {
      object (ConflictingPolicyData)
    }
  ],
  "error": string
}
Campos
source

enum (PolicySource)

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

name

string

Solo salida. Nombre de la política.

value

string

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

conflicts[]

object (ConflictingPolicyData)

Solo salida. Información de políticas contradictoria.

error

string

Solo salida. Mensaje de error de la política, si corresponde

PolicySource

Posibles fuentes de una política.

Enumeraciones
POLICY_SOURCE_UNSPECIFIED Representa una fuente de política no especificada.
MACHINE_PLATFORM Representa una política de plataforma a nivel de la máquina.
USER_PLATFORM Representa una política de plataforma a nivel del usuario.
MACHINE_LEVEL_USER_CLOUD Representa una política de nube del usuario a nivel de la máquina.
USER_CLOUD Representa una política de nube a nivel del usuario.
MACHINE_MERGED Representa una política combinada a nivel de la máquina.

ConflictingPolicyData

Información de la política en conflicto aplicada a un perfil del navegador Chrome.

Representación JSON
{
  "source": enum (PolicySource)
}
Campos
source

enum (PolicySource)

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

ExtensionPolicyData

Información de las políticas aplicadas a una extensión.

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

string

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

extensionName

string

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

policyData[]

object (PolicyData)

Solo salida. Información de las políticas aplicadas a la extensión.

IdentityProvider

Posibles proveedores de identidad de un perfil.

Enumeraciones
IDENTITY_PROVIDER_UNSPECIFIED Representa un proveedor de identidad no especificado.
GOOGLE_IDENTITY_PROVIDER Representa un proveedor de identidad de Google.
EXTERNAL_IDENTITY_PROVIDER Representa un proveedor de identidad externo.

AffiliationState

El estado de afiliación específico del perfil. Es posible que se agreguen valores nuevos en el futuro.

Enumeraciones
AFFILIATION_STATE_UNSPECIFIED Indica que no se especificó el estado de afiliación.
UNAFFILIATED_GENERIC No afiliado, pero no tenemos los detalles del tipo de perfil no afiliado.
PROFILE_ONLY No afiliado: Es un perfil administrado que aparece en un navegador totalmente no administrado.
UNAFFILIATED_LOCAL_MACHINE No afiliado: Es un perfil administrado que aparece en una máquina que administra de forma local una organización diferente (a través de mecanismos de administración de plataformas, como GPO).
UNAFFILIATED_CLOUD_MACHINE No afiliado: Es un perfil administrado que aparece en un navegador administrado que otra organización administra en la nube (con la Administración en la nube para el navegador Chrome).
AFFILIATED_CLOUD_MANAGED Afiliado: La misma organización administra el perfil y el navegador administrado.

Métodos

delete

Borra los datos recopilados de un perfil del navegador Chrome.

get

Obtiene un perfil del navegador Chrome con el ID del cliente y el ID permanente del perfil.

list

Muestra los perfiles del navegador Chrome de un cliente según los criterios de búsqueda y ordenamiento determinados.