Chính sách Chrome được biểu thị dưới dạng giản đồ chính sách bởi Schema Service API. Mỗi giản đồ chính sách có một tên riêng để xác định, định nghĩa các trường cài đặt và loại của các trường đó, cũng như nội dung mô tả mà con người có thể đọc được về các chế độ cài đặt bằng tiếng Anh.
Ví dụ: dưới đây là cách Schema Service API thể hiện một chế độ cài đặt cho phép nút đăng xuất xuất hiện trong khay hệ thống của Chrome. Cách biểu thị được đơn giản hoá của chế độ cài đặt này sẽ là bool showLogoutButtonInTray. Nhấp vào "Show an example" (Hiển thị ví dụ) bên dưới để xem cách Schema Service API thể hiện cho chế độ cài đặt này.
Hiển thị ví dụ
{
"name": "customers/C0202nabg/policySchemas/chrome.users.ShowLogoutButton",
"policyDescription": "Show logout button in tray.", // description of the policy
"definition": { // definition of the settings (fields names and types)
"messageType": [
{
"name": "ShowLogoutButton",
"field": [
{
"name": "showLogoutButtonInTray", // the setting showLogoutButtonInTray
"number": 1,
"label": "LABEL_OPTIONAL",
"type": "TYPE_BOOL" // the setting showLogoutButtonInTray is of type boolean
}
]
}
]
},
"fieldDescriptions": [ // human readable descriptions of the settings and their values
{
"field": "showLogoutButtonInTray",
"knownValueDescriptions": [
{
"value": "true",
"description": "Show logout button in tray." // description for showLogoutButtonInTray=true
},
{
"value": "false",
"description": "Do not show logout button in tray." // description for showLogoutButtonInTray=false
}
]
}
],
"schemaName": "chrome.users.ShowLogoutButton" // unique name to identify the policy
}
Tên giản đồ chính sách
name của giản đồ là giá trị nhận dạng duy nhất, có định dạng sau: {namespace}.{leafName}.
Trong ví dụ trên, tên đầy đủ của giản đồ là chrome.users.ShowLogoutButton.
Không gian tên là chrome.users. và tên lá là ShowLogoutButton.
Các chính sách có phạm vi tương tự nhau được nhóm vào cùng một vùng chứa tên. Ví dụ: tất cả giản đồ chính sách người dùng đều có tiền tố là không gian tên chrome.users. và tất cả giản đồ chính sách máy in đều có tiền tố là không gian tên chrome.printers..
Không gian tên
| Không gian tên | Khoá | Quyền bắt buộc đối với vai trò quản trị viên |
|---|---|---|
chrome.users.LEAF_NAME |
Dịch vụ > Quản lý Chrome > Cài đặt > Quản lý chế độ cài đặt người dùng | |
chrome.users.apps.LEAF_NAME |
key="app_id" |
Dịch vụ > Quản lý Chrome > Cài đặt > Quản lý cài đặt người dùng > Quản lý cài đặt ứng dụng |
chrome.users.appsconfig.LEAF_NAME |
Dịch vụ > Quản lý Chrome > Cài đặt > Quản lý cài đặt người dùng > Quản lý cài đặt ứng dụng | |
chrome.devices.LEAF_NAME |
Dịch vụ > Quản lý Chrome > Cài đặt > Quản lý chế độ cài đặt thiết bị ChromeOS | |
chrome.devices.managedguest.LEAF_NAME |
Dịch vụ > Quản lý Chrome > Cài đặt > Quản lý chế độ cài đặt thiết bị ChromeOS | |
chrome.devices.managedguest.apps.LEAF_NAME |
key="app_id" |
Dịch vụ > Quản lý Chrome > Cài đặt > Quản lý chế độ cài đặt thiết bị ChromeOS |
chrome.devices.kiosk.LEAF_NAME |
Dịch vụ > Quản lý Chrome > Cài đặt > Quản lý chế độ cài đặt thiết bị ChromeOS | |
chrome.devices.kiosk.apps.LEAF_NAME |
key="app_id" |
Dịch vụ > Quản lý Chrome > Cài đặt > Quản lý chế độ cài đặt thiết bị ChromeOS |
chrome.devices.kiosk.appsconfig.LEAF_NAME |
Dịch vụ > Quản lý Chrome > Cài đặt > Quản lý chế độ cài đặt thiết bị ChromeOS | |
chrome.printers.LEAF_NAME |
key="printer_id" |
Dịch vụ > Quản lý Chrome > Cài đặt > Quản lý máy in |
chrome.printservers.LEAF_NAME |
key="print_server_id" |
Dịch vụ > Quản lý Chrome > Cài đặt > Quản lý máy in |
chrome.networks.globalsettings.LEAF_NAME |
Dịch vụ > Cài đặt thiết bị dùng chung | |
chrome.networks.wifi.LEAF_NAME |
key="network_id" |
Dịch vụ > Cài đặt thiết bị dùng chung |
chrome.networks.ethernet.LEAF_NAME |
key="network_id" |
Dịch vụ > Cài đặt thiết bị dùng chung |
chrome.networks.vpn.LEAF_NAME |
key="network_id" |
Dịch vụ > Cài đặt thiết bị dùng chung |
chrome.networks.certificates.LEAF_NAME |
key="network_id" |
Dịch vụ > Cài đặt thiết bị dùng chung |
Khoá giản đồ chính sách
Một số chính sách yêu cầu thêm ngữ cảnh để xem hoặc sửa đổi. Ví dụ:
- Để sửa đổi chính sách cho một ứng dụng, bạn cần chỉ định ứng dụng nào bằng cách điền
key="app_id". - Để sửa đổi chính sách cho các chế độ cài đặt máy in trong một Đơn vị tổ chức, bạn cần chỉ định máy in nào bằng cách điền
key="printer_id".
Các giản đồ chính sách này chứa một phần additionalTargetKeyNames mô tả các khoá và giá trị cần chuyển trong các yêu cầu API.
Để biết thêm thông tin chi tiết, hãy chuyển đến phần Mã mẫu.
Hiển thị ví dụ
{
"name": "customers/C0202nabg/policySchemas/chrome.printers.AllowForUsers",
"policyDescription": "Allows a printer for users in a given organization.",
"additionalTargetKeyNames": [
{
"key": "printer_id",
"keyDescription": "Id of printer as visible in Admin SDK printers API."
}
],
"definition": {
"messageType": [
{
"name": "AllowForUsers",
"field": [
{
"name": "allowForUsers",
"number": 1,
"label": "LABEL_OPTIONAL",
"type": "TYPE_BOOL"
}
]
}
]
},
"fieldDescriptions": [
{
"field": "allowForUsers",
"description": "Controls whether a printer is allowed for users in a given organization."
}
],
"schemaName": "chrome.printers.AllowForUsers"
}
Chính sách ứng dụng
Một số không gian tên ở trên là dành cho chính sách ứng dụng, chẳng hạn như Ứng dụng của người dùng, Ứng dụng kiosk, Ứng dụng phiên khách được quản lý và chính sách Cấu hình ứng dụng kiosk. Các chính sách ứng dụng yêu cầu phải có app_id.
app_id được tạo thành bằng cách kết hợp loại ứng dụng và giá trị nhận dạng ứng dụng. Ví dụ:
chrome:mkaakpdehdafacodkgkpghoibnmamcmeđại diện cho Ứng dụng Chrome "Google Bản vẽ"android:com.google.android.calendarbiểu thị ứng dụng "Lịch Google" dành cho Androidweb:https://canvas.apps.chromeđại diện cho ứng dụng web "Canvas"
Trường nhiều giá trị
Các trường có nhãn LABEL_REPEATED đại diện cho các trường có nhiều giá trị, như danh sách hoặc mảng. Bạn có thể cung cấp nhiều giá trị cho các trường này. Để biết thêm thông tin chi tiết, hãy xem phần Mã mẫu.
Trạng thái giản đồ chính sách
Mỗi chính sách đều có một đối tượng policyApiLifecycle để thể hiện trạng thái hiện tại.
Đối tượng này chứa các trường sau đây kèm theo thông tin chi tiết về trạng thái của chính sách:
- Trường
policyApiLifecycleStagecho thấy giai đoạn nào trong bảng sau đây mô tả đúng nhất trạng thái hiện tại của chính sách. - Trường
descriptioncung cấp thêm thông tin chi tiết về trạng thái hiện tại của chính sách này. - Trường
endSupporthiển thị ngày hỗ trợ cuối cùng cho chính sách, nếu bạn đã xác định ngày đó. - Bạn chỉ có thể đặt
deprecatedInFavorOfnếu policyApiLifecycleWork được thiết lập là API_DEPRE Tỷ lệ có hiệu lực. Cột này cho biết(các) không gian tên đủ điều kiện của các chính sách mới mà chính sách hiện tại không còn được dùng nữa. - Trường
scheduledToDeprecatePoliciestương ứng với deprecatedInFavorOf. Trang này cho biết(các) không gian tên đủ điều kiện của các chính sách cũ sẽ không được dùng nữa do chính sách này ra mắt.
Các giai đoạn trong vòng đời
| Sân khấu | Nội dung mô tả |
|---|---|
API_UNSPECIFIED |
Trạng thái hiện tại của chính sách không xác định. Dành riêng, không sử dụng. |
API_PREVIEW |
Chính sách chưa hoạt động. Giai đoạn này có thể chuyển sang API_CURRENT hoặc API_DEVELOPMENT. |
API_DEVELOPMENT |
Chính sách chưa hoàn thiện và có thể có một số thay đổi có thể gây lỗi. Giai đoạn này có thể chuyển sang API_CURRENT hoặc API_DEPRECATED. |
API_CURRENT |
Chính sách là định dạng chính thức, nhưng có thể có sự thay đổi không gây ra lỗi. Giai đoạn này có thể chuyển sang API_DEPRECATED. |
API_DEPRECATED |
Chính sách này không được dùng nữa và có thể bị loại bỏ trong tương lai. Quản trị viên nên ngừng sử dụng chính sách này. |
Hiển thị ví dụ
{
"name": "customers/C0202nabg/policySchemas/chrome.users.OutdatedPolicy",
"policyDescription": "Just for demo, this is an outdated policy.",
"definition": {
"messageType": [
{
"name": "OutdatedPolicy",
"field": [
{
"name": "outdatedField",
"number": 1,
"label": "LABEL_OPTIONAL",
"type": "TYPE_BOOL"
}
]
}
]
},
"fieldDescriptions": [
{
"field": "outdatedField",
"description": "This is an outdated field"
}
],
"schemaName": "chrome.users.OutdatedPolicy",
"policyApiLifecycle": { // policy's current lifecycle status
"policyApiLifecycleStage": "API_DEPRECATED",
"description": "This policy is deprecated. Please stop using it",
"endSupport": {
"year": 2021,
"month": 2,
"day": 29
}
"deprecatedInFavorOf": "chrome.users.NewPolicy"
}
}
{
"name": "customers/C0202nabg/policySchemas/chrome.users.NewPolicy",
"policyDescription": "Just for demo, this is a new policy.",
"definition": {
"messageType": [
{
"name": "NewPolicy",
"field": [
{
"name": "newField",
"number": 1,
"label": "LABEL_OPTIONAL",
"type": "TYPE_BOOL"
}
]
}
]
},
"fieldDescriptions": [
{
"field": "newField",
"description": "This is an new field"
}
],
"schemaName": "chrome.users.NewPolicy",
"policyApiLifecycle": { // policy's current lifecycle status
"policyApiLifecycleStage": "API_CURRENT,
"scheduledToDeprecatePolicies": "chrome.users.OutdatedPolicy"
}
}
Thông báo giản đồ chính sách
Một số chính sách có liên kết với notices, trong đó acknowledgement_required
được đặt thành true cho một số giá trị nhất định của một số trường chính sách nhất định. Đối với các chính sách này, bạn cần đặt trường xác nhận đặc biệt thành true trước khi có thể đặt giá trị.
Để biết thêm thông tin chi tiết, hãy xem phần Mã mẫu.
Nền tảng được hỗ trợ
supportedPlatforms là một danh sách cho biết chính sách sẽ chỉ áp dụng
cho các thiết bị hoặc người dùng trên những nền tảng này. Tất cả các nền tảng được hỗ trợ được liệt kê trong bảng sau.
Nền tảng được hỗ trợ
| Nền tảng | Nội dung mô tả |
|---|---|
PLATFORM_UNSPECIFIED |
Nền tảng chưa được chỉ định. Dành riêng, không sử dụng. |
CHROME_OS |
ChromeOS |
CHROME_BROWSER |
Trình duyệt Chrome dành cho macOS/Windows/Linux |
CHROME_BROWSER_FOR_ANDROID |
Trình duyệt Chrome dành cho Android |
CHROME_BROWSER_FOR_IOS |
Trình duyệt Chrome dành cho iOS |