REST Resource: customers.profiles

资源：ChromeBrowserProfile

Chrome 浏览器个人资料的表示法。

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
}
字段
name

string

标识符。格式：customers/{customer_id}/profiles/{profilePermanentId}
profileId

string

仅限输出。Chrome 客户端个人资料 ID。
profilePermanentId

string

仅限输出。个人资料永久 ID 是客户中个人资料的唯一标识符。
displayName

string

仅限输出。由客户端设置的配置文件显示名称。
userId

string

仅限输出。用户的唯一 Directory API ID，可在 Admin SDK Users API 中使用。
userEmail

string

仅限输出。该付款资料所属用户的电子邮件地址。
lastActivityTime

string (Timestamp format)

仅限输出。按个人资料显示的最新活动的时间戳。

采用 RFC 3339 标准，生成的输出将始终在末尾带 Z，并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
lastPolicyFetchTime

string (Timestamp format)

仅限输出。个人资料最近一次提取政策的时间戳。

采用 RFC 3339 标准，生成的输出将始终在末尾带 Z，并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
lastPolicySyncTime

string (Timestamp format)

仅限输出。按个人资料显示的最近一次政策同步的时间戳。

采用 RFC 3339 标准，生成的输出将始终在末尾带 Z，并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
lastStatusReportTime

string (Timestamp format)

仅限输出。配置文件的最新状态报告的时间戳。

采用 RFC 3339 标准，生成的输出将始终在末尾带 Z，并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
deviceInfo

object (DeviceInfo)

仅限输出。包含配置文件的设备的基本信息。此信息仅适用于关联的商家资料。
osPlatformType

string

仅限输出。包含个人资料的设备的操作系统平台。
osVersion

string

仅限输出。包含该个人资料的设备的操作系统版本。
browserVersion

string

仅限输出。个人资料所在的浏览器的版本。
browserChannel

string

仅限输出。包含该个人资料的浏览器的渠道。
annotatedLocation

string

可选。管理员注释的配置文件的位置。
annotatedUser

string

可选。管理员注释的个人资料的用户。
attestationCredential

object (AttestationCredential)

仅限输出。配置文件的认证凭据信息。
reportingData

object (ReportingData)

仅限输出。配置文件的详细报告数据。只有在启用配置文件报告政策后，此信息才可用。
etag

string

仅限输出。此 ChromeBrowserProfile 资源的 ETag。此 etag 可与 UPDATE 操作搭配使用，以确保一致性。
identityProvider

enum (IdentityProvider)

仅限输出。标识配置文件的提供方。
firstEnrollmentTime

string (Timestamp format)

仅限输出。个人资料首次注册的时间戳。

采用 RFC 3339 标准，生成的输出将始终在末尾带 Z，并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
affiliationState

enum (AffiliationState)

仅限输出。个人资料的具体联属状态。
policyCount

string (int64 format)

仅限输出。在个人资料中应用的政策数量。
extensionCount

string (int64 format)

仅限输出。个人资料中安装的扩展程序数量。
osPlatformVersion

string

仅限输出。包含配置文件的设备的操作系统平台主要版本（来自配置文件报告）。

DeviceInfo

运行 Chrome 浏览器个人资料的设备的信息。

JSON 表示法 
{
  "deviceType": enum (DeviceType),
  "affiliatedDeviceId": string,
  "machine": string,
  "hostname": string
}
字段
deviceType

enum (DeviceType)

仅限输出。配置文件所在设备的类型。
affiliatedDeviceId

string

仅限输出。用于标识包含该个人资料的附属设备的设备 ID。如果设备类型为 CHROME_BROWSER，则表示设备的唯一 Directory API ID，可在 Admin SDK Browsers API 中使用。
machine

string

仅限输出。包含配置文件的设备的机器名称。在未报告机器名称的平台（目前为 iOS 和 Android）上，此属性会改为设置为浏览器的 deviceId，但请注意，这与 |affiliatedDeviceId| 不同。
hostname

string

仅限输出。配置文件所在设备的主机名。

DeviceType

设备的可能类型。

枚举
DEVICE_TYPE_UNSPECIFIED 表示未指定的设备类型。
CHROME_BROWSER 表示 Chrome 浏览器设备。

AttestationCredential

与 Chrome 浏览器个人资料关联的公钥信息。

JSON 表示法 
{
  "keyType": enum (KeyType),
  "keyTrustLevel": enum (KeyTrustLevel),
  "publicKey": string,
  "keyRotationTime": string
}
字段
keyType

enum (KeyType)

仅限输出。公钥的类型。
keyTrustLevel

enum (KeyTrustLevel)

仅限输出。公钥的信任级别。
publicKey

string (bytes format)

仅限输出。公钥的值。

使用 base64 编码的字符串。
keyRotationTime

string (Timestamp format)

仅限输出。公钥轮替的最新轮替时间戳。

采用 RFC 3339 标准，生成的输出将始终在末尾带 Z，并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

KeyType

公钥的可能类型。

枚举
KEY_TYPE_UNSPECIFIED 表示未指定的公钥类型。
RSA_KEY 表示 RSA 密钥。
EC_KEY 表示 EC 密钥。

KeyTrustLevel

公钥的可能信任级别。

枚举
KEY_TRUST_LEVEL_UNSPECIFIED 表示未指定的公钥信任级别。
CHROME_BROWSER_HW_KEY 表示硬件密钥。
CHROME_BROWSER_OS_KEY 表示操作系统密钥。

ReportingData

Chrome 浏览器个人资料的报告数据。

JSON 表示法 
{
  "browserExecutablePath": string,
  "installedBrowserVersion": string,
  "profilePath": string,
  "extensionData": [
    {
      object (ExtensionData)
    }
  ],
  "policyData": [
    {
      object (PolicyData)
    }
  ],
  "extensionPolicyData": [
    {
      object (ExtensionPolicyData)
    }
  ]
}
字段
browserExecutablePath

string

仅限输出。已安装的 Chrome 浏览器的可执行路径。有效的路径仅包含在联属频道个人资料中。
installedBrowserVersion

string

仅限输出。浏览器的更新版本（如果不同于有效的浏览器版本）。
profilePath

string

仅限输出。配置文件的路径。有效的路径仅包含在联属频道个人资料中。
extensionData[]

object (ExtensionData)

仅限输出。个人资料中安装的扩展程序的相关信息。
policyData[]

object (PolicyData)

仅限输出。应用于商家资料的政策的相关信息。
extensionPolicyData[]

object (ExtensionPolicyData)

仅限输出。应用于扩展程序的政策的相关信息。

ExtensionData

在 Chrome 浏览器个人资料中安装的扩展程序的信息。

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
}
字段
extensionId

string

仅限输出。扩展程序的 ID。
version

string

仅限输出。扩展程序的版本。
permissions[]

string

仅限输出。扩展程序请求的权限。
name

string

仅限输出。扩展程序的名称。
description

string

仅限输出。扩展程序的说明。
extensionType

enum (ExtensionType)

仅限输出。扩展程序的类型。
homepageUri

string

仅限输出。扩展程序主页的网址。
installationType

enum (InstallationType)

仅限输出。扩展程序的安装类型。
manifestVersion

integer

仅限输出。扩展程序的清单版本。
isDisabled

boolean

仅限输出。表示用户是否停用了扩展程序。
isWebstoreExtension

boolean

仅限输出。表示扩展程序是否来自应用商店。

ExtensionType

扩展程序的可能类型。

枚举
EXTENSION_TYPE_UNSPECIFIED 表示未指定的扩展程序类型。
EXTENSION 表示扩展程序。
APP 表示应用。
THEME 表示主题。
HOSTED_APP 表示托管的应用。

InstallationType

扩展程序的可能安装类型。

枚举
INSTALLATION_TYPE_UNSPECIFIED 表示未指定的安装类型。
MULTIPLE 表示具有混合安装类型的扩展程序实例。
NORMAL 表示正常安装类型。
ADMIN 表示由管理员安装。
DEVELOPMENT 表示开发安装类型。
SIDELOAD 表示旁加载安装类型。
OTHER 表示其他选项未涵盖的安装类型。

PolicyData

应用于 Chrome 浏览器个人资料的政策的相关信息。

JSON 表示法 
{
  "source": enum (PolicySource),
  "name": string,
  "value": string,
  "conflicts": [
    {
      object (ConflictingPolicyData)
    }
  ],
  "error": string
}
字段
source

enum (PolicySource)

仅限输出。政策的来源。
name

string

仅限输出。政策的名称。
value

string

仅限输出。政策的值。
conflicts[]

object (ConflictingPolicyData)

仅限输出。政策信息存在冲突。
error

string

仅限输出。政策的错误消息（如果有）。

PolicySource

政策的可能来源。

枚举
POLICY_SOURCE_UNSPECIFIED 表示未指定的政策来源。
MACHINE_PLATFORM 表示计算机级平台政策。
USER_PLATFORM 表示用户级平台政策。
MACHINE_LEVEL_USER_CLOUD 表示计算机级用户云政策。
USER_CLOUD 表示用户级云政策。
MACHINE_MERGED 表示设备级合并政策。

ConflictingPolicyData

应用于 Chrome 浏览器个人资料的冲突政策的相关信息。

JSON 表示法 
{
  "source": enum (PolicySource)
}
字段
source

enum (PolicySource)

仅限输出。政策的来源。

ExtensionPolicyData

应用于扩展程序的政策的相关信息。

JSON 表示法 
{
  "extensionId": string,
  "extensionName": string,
  "policyData": [
    {
      object (PolicyData)
    }
  ]
}
字段
extensionId

string

仅限输出。扩展程序的 ID。
extensionName

string

仅限输出。扩展程序的名称。
policyData[]

object (PolicyData)

仅限输出。与扩展程序应用的政策相关的信息。

IdentityProvider

商家资料的可能身份提供方。

枚举
IDENTITY_PROVIDER_UNSPECIFIED 表示未指定的身份提供方。
GOOGLE_IDENTITY_PROVIDER 表示 Google 身份提供方。
EXTERNAL_IDENTITY_PROVIDER 表示外部身份提供方。

AffiliationState

付款资料的具体联属状态。未来可能会添加新值。

枚举
AFFILIATION_STATE_UNSPECIFIED 未指定联属状态。
UNAFFILIATED_GENERIC 无关联 - 但我们没有无关联个人资料类型的详细信息。
PROFILE_ONLY 不关联 - 在完全不受管理的浏览器中显示的受管理个人资料。
UNAFFILIATED_LOCAL_MACHINE 非关联 - 显示在由其他组织本地管理（通过 GPO 等平台管理机制）的机器上的受管理个人资料。
UNAFFILIATED_CLOUD_MACHINE 非关联 - 在由其他组织（使用 Chrome 浏览器云管理）云端管理的受管理浏览器中显示的受管理个人资料。
AFFILIATED_CLOUD_MANAGED 关联 - 个人资料和受管理的浏览器均由同一组织管理。

方法

delete

 删除从 Chrome 浏览器个人资料收集的数据。

get

 获取包含客户 ID 和个人资料永久 ID 的 Chrome 浏览器个人资料。

list

 根据给定的搜索和排序条件列出客户的 Chrome 浏览器个人资料。