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

ID。格式：customers/{customer_id}/profiles/{profilePermanentId}
profileId

string

僅供輸出。Chrome 用戶端設定檔 ID。
profilePermanentId

string

僅供輸出。個人資料永久 ID 是客戶內個人資料的專屬 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

僅供輸出。裝置 OS 版本 (其中包含設定檔)。
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，但請注意，這個 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 代表 OS 鍵。

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 瀏覽器設定檔。