REST Resource: customers.profiles

Ressource: ChromeBrowserProfile

Représentation d'un profil de navigateur Chrome.

Représentation 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
}
Champs
name

string

Identifiant. Format: customers/{customer_id}/profiles/{profilePermanentId}

profileId

string

Uniquement en sortie. ID du profil côté client Chrome.

profilePermanentId

string

Uniquement en sortie. L'ID permanent du profil est l'identifiant unique d'un profil au sein d'un même client.

displayName

string

Uniquement en sortie. Nom à afficher du profil défini par le client.

userId

string

Uniquement en sortie. Identifiant unique de l'API Directory de l'utilisateur pouvant être utilisé dans l'API Admin SDK Users.

userEmail

string

Uniquement en sortie. Adresse e-mail de l'utilisateur auquel le profil appartient.

lastActivityTime

string (Timestamp format)

Uniquement en sortie. Code temporel de la dernière activité enregistrée par le profil.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

lastPolicyFetchTime

string (Timestamp format)

Uniquement en sortie. Code temporel de la dernière récupération de règle par le profil.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

lastPolicySyncTime

string (Timestamp format)

Uniquement en sortie. Code temporel de la dernière synchronisation des règles par le profil.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

lastStatusReportTime

string (Timestamp format)

Uniquement en sortie. Code temporel du dernier rapport d'état du profil.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

deviceInfo

object (DeviceInfo)

Uniquement en sortie. Informations de base sur l'appareil sur lequel le profil existe. Ces informations ne sont disponibles que pour les fiches affiliées.

osPlatformType

string

Uniquement en sortie. Plate-forme de l'OS de l'appareil sur lequel le profil existe.

osVersion

string

Uniquement en sortie. Version de l'OS de l'appareil sur lequel le profil existe.

browserVersion

string

Uniquement en sortie. Version du navigateur dans lequel le profil existe.

browserChannel

string

Uniquement en sortie. Version du navigateur dans laquelle le profil existe.

annotatedLocation

string

Facultatif. Emplacement du profil annoté par l'administrateur.

annotatedUser

string

Facultatif. Utilisateur du profil annoté par l'administrateur.

attestationCredential

object (AttestationCredential)

Uniquement en sortie. Informations d'identification d'attestation du profil.

reportingData

object (ReportingData)

Uniquement en sortie. Données de rapport détaillées du profil. Ces informations ne sont disponibles que lorsque la règle de création de rapports sur les profils est activée.

etag

string

Uniquement en sortie. Etag de cette ressource ChromeBrowserProfile. Cet etag peut être utilisé avec l'opération UPDATE pour assurer la cohérence.

identityProvider

enum (IdentityProvider)

Uniquement en sortie. Identifiez le fournisseur du profil.

firstEnrollmentTime

string (Timestamp format)

Uniquement en sortie. Code temporel de la première inscription du profil.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

affiliationState

enum (AffiliationState)

Uniquement en sortie. État d'affiliation spécifique du profil.

policyCount

string (int64 format)

Uniquement en sortie. Nombre de règles appliquées au profil.

extensionCount

string (int64 format)

Uniquement en sortie. Nombre d'extensions installées sur le profil.

osPlatformVersion

string

Uniquement en sortie. Version majeure de l'OS de l'appareil sur lequel le profil existe. (par exemple, Windows 10)

DeviceInfo

Informations sur un appareil exécutant un profil de navigateur Chrome.

Représentation JSON
{
  "deviceType": enum (DeviceType),
  "affiliatedDeviceId": string,
  "machine": string,
  "hostname": string
}
Champs
deviceType

enum (DeviceType)

Uniquement en sortie. Type de l'appareil sur lequel le profil existe.

affiliatedDeviceId

string

Uniquement en sortie. L'ID de l'appareil qui identifie l'appareil affilié sur lequel le profil existe. Si le type d'appareil est CHROME_BROWSER, il s'agit d'un ID d'API Directory unique de l'appareil pouvant être utilisé dans l'API Browsers du SDK Admin.

machine

string

Uniquement en sortie. Nom de la machine de l'appareil sur lequel le profil existe. Sur les plates-formes qui ne signalent pas le nom de la machine (actuellement iOS et Android), il est défini sur l'ID de l'appareil du navigateur. Notez qu'il s'agit d'un ID d'appareil différent de l'|affiliatedDeviceId|.

hostname

string

Uniquement en sortie. Nom d'hôte de l'appareil sur lequel le profil existe.

DeviceType

Types d'appareils possibles.

Enums
DEVICE_TYPE_UNSPECIFIED Représente un type d'appareil non spécifié.
CHROME_BROWSER Représente un appareil utilisant le navigateur Chrome.

AttestationCredential

Informations de la clé publique associée à un profil de navigateur Chrome.

Représentation JSON
{
  "keyType": enum (KeyType),
  "keyTrustLevel": enum (KeyTrustLevel),
  "publicKey": string,
  "keyRotationTime": string
}
Champs
keyType

enum (KeyType)

Uniquement en sortie. Type de clé publique.

keyTrustLevel

enum (KeyTrustLevel)

Uniquement en sortie. Niveau de confiance de la clé publique.

publicKey

string (bytes format)

Uniquement en sortie. Valeur de la clé publique.

Chaîne encodée en base64.

keyRotationTime

string (Timestamp format)

Uniquement en sortie. Code temporel de la dernière rotation de la clé publique.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

KeyType

Types possibles de clé publique.

Enums
KEY_TYPE_UNSPECIFIED Représente un type de clé publique non spécifié.
RSA_KEY Représente une clé RSA.
EC_KEY Représente une clé EC.

KeyTrustLevel

Niveaux de confiance possibles d'une clé publique.

Enums
KEY_TRUST_LEVEL_UNSPECIFIED Représente un niveau de confiance de clé publique non spécifié.
CHROME_BROWSER_HW_KEY Représente une clé matérielle.
CHROME_BROWSER_OS_KEY Représente une clé d'OS.

ReportingData

Données de rapport d'un profil du navigateur Chrome

Représentation JSON
{
  "browserExecutablePath": string,
  "installedBrowserVersion": string,
  "profilePath": string,
  "extensionData": [
    {
      object (ExtensionData)
    }
  ],
  "policyData": [
    {
      object (PolicyData)
    }
  ],
  "extensionPolicyData": [
    {
      object (ExtensionPolicyData)
    }
  ]
}
Champs
browserExecutablePath

string

Uniquement en sortie. Chemin d'accès au fichier exécutable du navigateur Chrome installé. Un chemin d'accès valide n'est inclus que dans les profils affiliés.

installedBrowserVersion

string

Uniquement en sortie. Version mise à jour d'un navigateur, si elle est différente de la version active.

profilePath

string

Uniquement en sortie. Chemin d'accès au profil. Un chemin d'accès valide n'est inclus que dans les profils affiliés.

extensionData[]

object (ExtensionData)

Uniquement en sortie. Informations sur les extensions installées sur le profil.

policyData[]

object (PolicyData)

Uniquement en sortie. Informations sur les règles appliquées au profil.

extensionPolicyData[]

object (ExtensionPolicyData)

Uniquement en sortie. Informations sur les règles appliquées aux extensions.

ExtensionData

Informations sur une extension installée sur un profil de navigateur Chrome.

Représentation 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
}
Champs
extensionId

string

Uniquement en sortie. ID de l'extension.

version

string

Uniquement en sortie. Version de l'extension.

permissions[]

string

Uniquement en sortie. Autorisations demandées par l'extension.

name

string

Uniquement en sortie. Nom de l'extension.

description

string

Uniquement en sortie. Description de l'extension.

extensionType

enum (ExtensionType)

Uniquement en sortie. Type de l'extension.

homepageUri

string

Uniquement en sortie. URL de la page d'accueil de l'extension.

installationType

enum (InstallationType)

Uniquement en sortie. Type d'installation de l'extension.

manifestVersion

integer

Uniquement en sortie. Version du fichier manifeste de l'extension.

isDisabled

boolean

Uniquement en sortie. Indique si l'utilisateur a désactivé l'extension.

isWebstoreExtension

boolean

Uniquement en sortie. Indique si l'extension provient du Web Store.

ExtensionType

Types d'extension possibles.

Enums
EXTENSION_TYPE_UNSPECIFIED Représente un type d'extension non spécifié.
EXTENSION Représente une extension.
APP Représente une application.
THEME Représente un thème.
HOSTED_APP Représente une application hébergée.

InstallationType

Types d'installation possibles d'une extension.

Enums
INSTALLATION_TYPE_UNSPECIFIED Représente un type d'installation non spécifié.
MULTIPLE Représente les instances de l'extension avec des types d'installation mixtes.
NORMAL Représente un type d'installation normal.
ADMIN Représente une installation par l'administrateur.
DEVELOPMENT Représente un type d'installation de développement.
SIDELOAD Représente un type d'installation côté chargement.
OTHER Représente un type d'installation qui n'est pas couvert par les autres options.

PolicyData

Informations sur une règle appliquée à un profil de navigateur Chrome.

Représentation JSON
{
  "source": enum (PolicySource),
  "name": string,
  "value": string,
  "conflicts": [
    {
      object (ConflictingPolicyData)
    }
  ],
  "error": string
}
Champs
source

enum (PolicySource)

Uniquement en sortie. Source de la règle.

name

string

Uniquement en sortie. Nom de la stratégie

value

string

Uniquement en sortie. Valeur de la règle.

conflicts[]

object (ConflictingPolicyData)

Uniquement en sortie. Informations sur le règlement contradictoires.

error

string

Uniquement en sortie. Message d'erreur de la règle, le cas échéant.

PolicySource

Sources possibles d'une règle.

Enums
POLICY_SOURCE_UNSPECIFIED Représente une source de règles non spécifiée.
MACHINE_PLATFORM Représente une règle de plate-forme au niveau de la machine.
USER_PLATFORM Représente une règle de plate-forme au niveau de l'utilisateur.
MACHINE_LEVEL_USER_CLOUD Représente une règle cloud utilisateur au niveau de la machine.
USER_CLOUD Représente une règle cloud au niveau de l'utilisateur.
MACHINE_MERGED Représente une règle fusionnée au niveau de l'ordinateur.

ConflictingPolicyData

Informations sur une règle en conflit appliquée à un profil de navigateur Chrome.

Représentation JSON
{
  "source": enum (PolicySource)
}
Champs
source

enum (PolicySource)

Uniquement en sortie. Source de la règle.

ExtensionPolicyData

Informations sur les règles appliquées à une extension.

Représentation JSON
{
  "extensionId": string,
  "extensionName": string,
  "policyData": [
    {
      object (PolicyData)
    }
  ]
}
Champs
extensionId

string

Uniquement en sortie. ID de l'extension.

extensionName

string

Uniquement en sortie. Nom de l'extension.

policyData[]

object (PolicyData)

Uniquement en sortie. Informations sur les règles appliquées à l'extension.

IdentityProvider

Fournisseurs d'identité possibles d'un profil.

Enums
IDENTITY_PROVIDER_UNSPECIFIED Représente un fournisseur d'identité non spécifié.
GOOGLE_IDENTITY_PROVIDER Représente un fournisseur d'identité Google.
EXTERNAL_IDENTITY_PROVIDER Représente un fournisseur d'identité externe.

AffiliationState

État d'affiliation spécifique du profil. De nouvelles valeurs pourront être ajoutées à l'avenir.

Enums
AFFILIATION_STATE_UNSPECIFIED État d'affiliation non spécifié.
UNAFFILIATED_GENERIC Non affilié : nous ne disposons pas des informations sur le type de profil non affilié.
PROFILE_ONLY Non affilié : profil géré qui s'affiche dans un navigateur non géré.
UNAFFILIATED_LOCAL_MACHINE Non affilié : profil géré qui apparaît sur une machine gérée localement par une autre organisation (via des mécanismes de gestion de plate-forme tels que GPO).
UNAFFILIATED_CLOUD_MACHINE Non affilié : profil géré qui s'affiche sur un navigateur géré par une autre organisation (à l'aide de la gestion cloud du navigateur Chrome).
AFFILIATED_CLOUD_MANAGED Affilié : le profil et le navigateur géré sont gérés par la même organisation.

Méthodes

delete

Supprime les données collectées à partir d'un profil de navigateur Chrome.

get

Récupère un profil de navigateur Chrome avec l'ID client et l'ID permanent du profil.

list

Répertorie les profils de navigateur Chrome d'un client en fonction des critères de recherche et de tri spécifiés.