REST Resource: customers.profiles

Tài nguyên: ChromeBrowserProfile

Hình ảnh đại diện cho một hồ sơ trình duyệt Chrome.

Biểu diễn dưới dạng 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
}
Trường
name

string

Giá trị nhận dạng. Định dạng: customers/{customer_id}/profiles/{profilePermanentId}

profileId

string

Chỉ có đầu ra. Mã hồ sơ phía máy khách của Chrome.

profilePermanentId

string

Chỉ có đầu ra. Mã vĩnh viễn của hồ sơ là giá trị nhận dạng duy nhất của hồ sơ trong một khách hàng.

displayName

string

Chỉ có đầu ra. Tên hiển thị của hồ sơ do ứng dụng đặt.

userId

string

Chỉ có đầu ra. Mã nhận dạng API thư mục duy nhất của người dùng có thể được sử dụng trong API Người dùng SDK dành cho quản trị viên.

userEmail

string

Chỉ có đầu ra. Địa chỉ email của người dùng sở hữu hồ sơ.

lastActivityTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian của hoạt động mới nhất theo hồ sơ.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

lastPolicyFetchTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian của lần tìm nạp chính sách gần đây nhất theo cấu hình.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

lastPolicySyncTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian của lần đồng bộ hoá chính sách gần đây nhất theo cấu hình.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

lastStatusReportTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian của báo cáo trạng thái mới nhất theo hồ sơ.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

deviceInfo

object (DeviceInfo)

Chỉ có đầu ra. Thông tin cơ bản về thiết bị có hồ sơ. Thông tin này chỉ có sẵn cho các trang doanh nghiệp liên kết.

osPlatformType

string

Chỉ có đầu ra. Nền tảng hệ điều hành của thiết bị có hồ sơ.

osVersion

string

Chỉ có đầu ra. Phiên bản hệ điều hành của thiết bị có hồ sơ.

browserVersion

string

Chỉ có đầu ra. Phiên bản trình duyệt có hồ sơ.

browserChannel

string

Chỉ có đầu ra. Kênh của trình duyệt có hồ sơ.

annotatedLocation

string

Không bắt buộc. Vị trí của hồ sơ được quản trị viên chú thích.

annotatedUser

string

Không bắt buộc. Người dùng của hồ sơ mà quản trị viên đã chú thích.

attestationCredential

object (AttestationCredential)

Chỉ có đầu ra. Thông tin chứng thực của hồ sơ.

reportingData

object (ReportingData)

Chỉ có đầu ra. Dữ liệu báo cáo chi tiết của hồ sơ. Thông tin này chỉ có sẵn khi bạn bật chính sách báo cáo hồ sơ.

etag

string

Chỉ có đầu ra. Etag của tài nguyên ChromeBrowserProfile này. Bạn có thể sử dụng etag này với thao tác CẬP NHẬT để đảm bảo tính nhất quán.

identityProvider

enum (IdentityProvider)

Chỉ có đầu ra. Xác định nhà cung cấp của hồ sơ.

firstEnrollmentTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian của lần đăng ký đầu tiên của hồ sơ.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

affiliationState

enum (AffiliationState)

Chỉ có đầu ra. Trạng thái liên kết cụ thể của hồ sơ.

policyCount

string (int64 format)

Chỉ có đầu ra. Số lượng chính sách được áp dụng cho hồ sơ.

extensionCount

string (int64 format)

Chỉ có đầu ra. Số tiện ích được cài đặt trên hồ sơ.

osPlatformVersion

string

Chỉ có đầu ra. Phiên bản chính của hệ điều hành trên thiết bị có hồ sơ. (ví dụ: Windows 10)

DeviceInfo

Thông tin về một thiết bị chạy hồ sơ trình duyệt Chrome.

Biểu diễn dưới dạng JSON
{
  "deviceType": enum (DeviceType),
  "affiliatedDeviceId": string,
  "machine": string,
  "hostname": string
}
Trường
deviceType

enum (DeviceType)

Chỉ có đầu ra. Loại thiết bị có hồ sơ.

affiliatedDeviceId

string

Chỉ có đầu ra. Mã thiết bị xác định thiết bị liên kết có hồ sơ. Nếu loại thiết bị là CHROME_BROWSER, thì đây là mã nhận dạng API thư mục duy nhất của thiết bị có thể được sử dụng trong API Trình duyệt SDK quản trị.

machine

string

Chỉ có đầu ra. Tên máy của thiết bị có hồ sơ. Trên các nền tảng không báo cáo tên máy (hiện là iOS và Android), giá trị này được đặt thành deviceId của trình duyệt – nhưng xin lưu ý rằng đây là một deviceId khác với |affiliatedDeviceId|.

hostname

string

Chỉ có đầu ra. Tên máy chủ của thiết bị có hồ sơ.

DeviceType

Các loại thiết bị có thể có.

Enum
DEVICE_TYPE_UNSPECIFIED Biểu thị một loại thiết bị không xác định.
CHROME_BROWSER Biểu thị một thiết bị dùng trình duyệt Chrome.

AttestationCredential

Thông tin về khoá công khai được liên kết với một hồ sơ trình duyệt Chrome.

Biểu diễn dưới dạng JSON
{
  "keyType": enum (KeyType),
  "keyTrustLevel": enum (KeyTrustLevel),
  "publicKey": string,
  "keyRotationTime": string
}
Trường
keyType

enum (KeyType)

Chỉ có đầu ra. Loại khoá công khai.

keyTrustLevel

enum (KeyTrustLevel)

Chỉ có đầu ra. Mức độ tin cậy của khoá công khai.

publicKey

string (bytes format)

Chỉ có đầu ra. Giá trị của khoá công khai.

Chuỗi được mã hoá base64.

keyRotationTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian xoay vòng mới nhất của quá trình xoay vòng khoá công khai.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

KeyType

Các loại khoá công khai có thể có.

Enum
KEY_TYPE_UNSPECIFIED Biểu thị một loại khoá công khai chưa chỉ định.
RSA_KEY Đại diện cho khoá RSA.
EC_KEY Đại diện cho khoá EC.

KeyTrustLevel

Các cấp độ tin cậy có thể có của khoá công khai.

Enum
KEY_TRUST_LEVEL_UNSPECIFIED Biểu thị cấp độ tin cậy khoá công khai chưa xác định.
CHROME_BROWSER_HW_KEY Đại diện cho khoá phần cứng.
CHROME_BROWSER_OS_KEY Đại diện cho khoá hệ điều hành.

ReportingData

Báo cáo dữ liệu của một hồ sơ trình duyệt Chrome.

Biểu diễn dưới dạng JSON
{
  "browserExecutablePath": string,
  "installedBrowserVersion": string,
  "profilePath": string,
  "extensionData": [
    {
      object (ExtensionData)
    }
  ],
  "policyData": [
    {
      object (PolicyData)
    }
  ],
  "extensionPolicyData": [
    {
      object (ExtensionPolicyData)
    }
  ]
}
Trường
browserExecutablePath

string

Chỉ có đầu ra. Đường dẫn thực thi của trình duyệt Chrome đã cài đặt. Đường dẫn hợp lệ chỉ có trong trang doanh nghiệp liên kết.

installedBrowserVersion

string

Chỉ có đầu ra. Phiên bản cập nhật của trình duyệt, nếu phiên bản này khác với phiên bản trình duyệt đang hoạt động.

profilePath

string

Chỉ có đầu ra. Đường dẫn của hồ sơ. Đường dẫn hợp lệ chỉ có trong trang doanh nghiệp liên kết.

extensionData[]

object (ExtensionData)

Chỉ có đầu ra. Thông tin về các tiện ích đã cài đặt trên hồ sơ.

policyData[]

object (PolicyData)

Chỉ có đầu ra. Thông tin về các chính sách được áp dụng cho hồ sơ.

extensionPolicyData[]

object (ExtensionPolicyData)

Chỉ có đầu ra. Thông tin về các chính sách được áp dụng cho tiện ích.

ExtensionData

Thông tin về một tiện ích được cài đặt trên hồ sơ trình duyệt Chrome.

Biểu diễn dưới dạng 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
}
Trường
extensionId

string

Chỉ có đầu ra. Mã của phần mở rộng.

version

string

Chỉ có đầu ra. Phiên bản của tiện ích.

permissions[]

string

Chỉ có đầu ra. Quyền mà tiện ích yêu cầu.

name

string

Chỉ có đầu ra. Tên của tiện ích.

description

string

Chỉ có đầu ra. Nội dung mô tả về tiện ích.

extensionType

enum (ExtensionType)

Chỉ có đầu ra. Loại phần mở rộng.

homepageUri

string

Chỉ có đầu ra. URL của trang chủ của tiện ích.

installationType

enum (InstallationType)

Chỉ có đầu ra. Loại cài đặt tiện ích.

manifestVersion

integer

Chỉ có đầu ra. Phiên bản tệp kê khai của tiện ích.

isDisabled

boolean

Chỉ có đầu ra. Cho biết liệu người dùng có tắt tiện ích hay không.

isWebstoreExtension

boolean

Chỉ có đầu ra. Cho biết tiện ích có phải là của cửa hàng web hay không.

ExtensionType

Các loại phần mở rộng có thể có.

Enum
EXTENSION_TYPE_UNSPECIFIED Biểu thị một loại tiện ích chưa chỉ định.
EXTENSION Đại diện cho một tiện ích.
APP Đại diện cho một ứng dụng.
THEME Đại diện cho một giao diện.
HOSTED_APP Đại diện cho một ứng dụng được lưu trữ.

InstallationType

Các loại cài đặt tiện ích có thể có.

Enum
INSTALLATION_TYPE_UNSPECIFIED Biểu thị một loại cài đặt chưa xác định.
MULTIPLE Biểu thị các thực thể của tiện ích có nhiều loại cài đặt.
NORMAL Biểu thị loại cài đặt thông thường.
ADMIN Biểu thị một lượt cài đặt do quản trị viên thực hiện.
DEVELOPMENT Biểu thị một loại cài đặt phát triển.
SIDELOAD Đại diện cho một loại cài đặt tải không qua cửa hàng ứng dụng.
OTHER Biểu thị một loại hình cài đặt không có trong các tuỳ chọn khác.

PolicyData

Thông tin về một chính sách được áp dụng cho hồ sơ trình duyệt Chrome.

Biểu diễn dưới dạng JSON
{
  "source": enum (PolicySource),
  "name": string,
  "value": string,
  "conflicts": [
    {
      object (ConflictingPolicyData)
    }
  ],
  "error": string
}
Trường
source

enum (PolicySource)

Chỉ có đầu ra. Nguồn của chính sách.

name

string

Chỉ có đầu ra. Tên chính sách.

value

string

Chỉ có đầu ra. Giá trị của chính sách.

conflicts[]

object (ConflictingPolicyData)

Chỉ có đầu ra. Thông tin về chính sách xung đột.

error

string

Chỉ có đầu ra. Thông báo lỗi của chính sách (nếu có).

PolicySource

Các nguồn có thể dẫn đến việc áp dụng chính sách.

Enum
POLICY_SOURCE_UNSPECIFIED Biểu thị một nguồn chính sách không xác định.
MACHINE_PLATFORM Biểu thị chính sách nền tảng ở cấp máy.
USER_PLATFORM Biểu thị chính sách nền tảng ở cấp người dùng.
MACHINE_LEVEL_USER_CLOUD Biểu thị chính sách đám mây cho người dùng ở cấp thiết bị.
USER_CLOUD Biểu thị chính sách đám mây ở cấp người dùng.
MACHINE_MERGED Biểu thị một chính sách hợp nhất ở cấp máy.

ConflictingPolicyData

Thông tin về chính sách xung đột được áp dụng cho một hồ sơ trình duyệt Chrome.

Biểu diễn dưới dạng JSON
{
  "source": enum (PolicySource)
}
Trường
source

enum (PolicySource)

Chỉ có đầu ra. Nguồn của chính sách.

ExtensionPolicyData

Thông tin về các chính sách được áp dụng cho một tiện ích.

Biểu diễn dưới dạng JSON
{
  "extensionId": string,
  "extensionName": string,
  "policyData": [
    {
      object (PolicyData)
    }
  ]
}
Trường
extensionId

string

Chỉ có đầu ra. Mã của phần mở rộng.

extensionName

string

Chỉ có đầu ra. Tên của tiện ích.

policyData[]

object (PolicyData)

Chỉ có đầu ra. Thông tin về các chính sách được áp dụng cho tiện ích.

IdentityProvider

Nhà cung cấp danh tính có thể có của một hồ sơ.

Enum
IDENTITY_PROVIDER_UNSPECIFIED Đại diện cho một nhà cung cấp danh tính không xác định.
GOOGLE_IDENTITY_PROVIDER Đại diện cho nhà cung cấp danh tính của Google.
EXTERNAL_IDENTITY_PROVIDER Đại diện cho một trình cung cấp danh tính bên ngoài.

AffiliationState

Trạng thái liên kết cụ thể của hồ sơ. Các giá trị mới có thể được thêm vào trong tương lai.

Enum
AFFILIATION_STATE_UNSPECIFIED Trạng thái liên kết không xác định.
UNAFFILIATED_GENERIC Không liên kết – nhưng chúng tôi không có thông tin chi tiết về loại trang doanh nghiệp không liên kết.
PROFILE_ONLY Chưa liên kết – Hồ sơ được quản lý xuất hiện trên trình duyệt hoàn toàn không được quản lý.
UNAFFILIATED_LOCAL_MACHINE Không liên kết – Hồ sơ được quản lý xuất hiện trên máy do một tổ chức khác quản lý cục bộ (thông qua các cơ chế quản lý nền tảng như GPO).
UNAFFILIATED_CLOUD_MACHINE Chưa liên kết – Hồ sơ được quản lý xuất hiện trên một trình duyệt được quản lý do một tổ chức khác quản lý qua đám mây (bằng giải pháp Quản lý trình duyệt Chrome qua đám mây).
AFFILIATED_CLOUD_MANAGED Liên kết – Cả hồ sơ và trình duyệt được quản lý đều do cùng một tổ chức quản lý.

Phương thức

delete

Xoá dữ liệu được thu thập từ hồ sơ trình duyệt Chrome.

get

Tải một hồ sơ trên trình duyệt Chrome có mã khách hàng và mã vĩnh viễn của hồ sơ.

list

Liệt kê hồ sơ trình duyệt Chrome của một khách hàng dựa trên tiêu chí tìm kiếm và sắp xếp đã cho.