Zasady Chrome są reprezentowane przez schematy zasad przez interfejs Schema Service API. Każdy schemat zasad ma unikalną nazwę, która umożliwia jego identyfikację, definicję pól ustawień i ich typów oraz zrozumiały dla człowieka opis ustawień w języku angielskim.
Poniżej pokazujemy przykład, jak interfejs Schema Service API reprezentuje ustawienie, które umożliwia wyświetlenie przycisku wylogowania w obszarze powiadomień Chrome. Uproszczoną reprezentacją tego ustawienia jest bool showLogoutButtonInTray
. Kliknij „Pokaż przykład” poniżej, aby zobaczyć, jak interfejs Schema Service API przedstawia to ustawienie.
Pokaż przykład
{ "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 }
Nazwy schematów zasad
Element name
schematu to jego unikalny identyfikator w tym formacie: {namespace}.{leafName}
.
W tym przykładzie pełna nazwa schematu to chrome.users.ShowLogoutButton
.
Przestrzeń nazw to chrome.users.
, a nazwa liścia to ShowLogoutButton
.
Zasady o podobnym zakresie są zgrupowane w tej samej przestrzeni nazw. Na przykład wszystkie schematy zasad dotyczących użytkowników mają prefiks przestrzeni nazw chrome.users.
, a wszystkie schematy zasad drukarek mają prefiks przestrzeni nazw chrome.printers.
.
Przestrzenie nazw
Przestrzeń nazw | Klucz | Wymagane uprawnienia roli administratora |
---|---|---|
chrome.users.LEAF_NAME |
Usługi > Zarządzanie urządzeniami z Chrome > Ustawienia > Zarządzaj ustawieniami użytkowników | |
chrome.users.apps.LEAF_NAME |
key="app_id" |
Usługi > Zarządzanie urządzeniami z Chrome > Ustawienia > Zarządzaj ustawieniami użytkowników > Zarządzaj ustawieniami aplikacji |
chrome.users.appsconfig.LEAF_NAME |
Usługi > Zarządzanie urządzeniami z Chrome > Ustawienia > Zarządzaj ustawieniami użytkowników > Zarządzaj ustawieniami aplikacji | |
chrome.devices.LEAF_NAME |
Usługi > Zarządzanie urządzeniami z Chrome > Ustawienia > Zarządzanie ustawieniami urządzeń z ChromeOS | |
chrome.devices.managedguest.LEAF_NAME |
Usługi > Zarządzanie urządzeniami z Chrome > Ustawienia > Zarządzanie ustawieniami urządzeń z ChromeOS | |
chrome.devices.managedguest.apps.LEAF_NAME |
key="app_id" |
Usługi > Zarządzanie urządzeniami z Chrome > Ustawienia > Zarządzanie ustawieniami urządzeń z ChromeOS |
chrome.devices.kiosk.LEAF_NAME |
Usługi > Zarządzanie urządzeniami z Chrome > Ustawienia > Zarządzanie ustawieniami urządzeń z ChromeOS | |
chrome.devices.kiosk.apps.LEAF_NAME |
key="app_id" |
Usługi > Zarządzanie urządzeniami z Chrome > Ustawienia > Zarządzanie ustawieniami urządzeń z ChromeOS |
chrome.devices.kiosk.appsconfig.LEAF_NAME |
Usługi > Zarządzanie urządzeniami z Chrome > Ustawienia > Zarządzanie ustawieniami urządzeń z ChromeOS | |
chrome.printers.LEAF_NAME |
key="printer_id" |
Usługi > Zarządzanie urządzeniami z Chrome > Ustawienia > Zarządzaj drukarkami |
chrome.printservers.LEAF_NAME |
key="print_server_id" |
Usługi > Zarządzanie urządzeniami z Chrome > Ustawienia > Zarządzaj drukarkami |
chrome.networks.globalsettings.LEAF_NAME |
Usługi > Ustawienia urządzeń współdzielonych | |
chrome.networks.wifi.LEAF_NAME |
key="network_id" |
Usługi > Ustawienia urządzeń współdzielonych |
chrome.networks.ethernet.LEAF_NAME |
key="network_id" |
Usługi > Ustawienia urządzeń współdzielonych |
chrome.networks.vpn.LEAF_NAME |
key="network_id" |
Usługi > Ustawienia urządzeń współdzielonych |
chrome.networks.certificates.LEAF_NAME |
key="network_id" |
Usługi > Ustawienia urządzeń współdzielonych |
Klucze schematu zasad
Wyświetlanie lub modyfikowanie niektórych zasad wymaga podania lub zmodyfikowania dodatkowego kontekstu. Na przykład:
- Aby zmodyfikować zasadę dla aplikacji, musisz wskazać aplikację, wypełniając pole
key="app_id"
. - Aby zmodyfikować zasady dotyczące ustawień drukarek w jednostce organizacyjnej, musisz określić, która drukarka, wypełniając pole
key="printer_id"
.
Te schematy zasad zawierają sekcję additionalTargetKeyNames
, w której opisano klucze i wartości, które należy przekazywać w żądaniach do interfejsu API.
Więcej informacji znajdziesz w artykule Przykładowe fragmenty kodu.
Pokaż przykład
{ "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" }
Zasady dotyczące aplikacji
Niektóre z powyższych przestrzeni nazw służą do obsługi zasad dotyczących aplikacji, takich jak aplikacje użytkowników, aplikacje kiosku, aplikacje z zarządzaną sesją gościa i zasady konfiguracji aplikacji kiosku. Zasady dotyczące aplikacji wymagają app_id
.
app_id
powstaje, łącząc typ i identyfikator aplikacji. Na przykład:
chrome:mkaakpdehdafacodkgkpghoibnmamcme
reprezentuje aplikację Chrome „Rysunki Google”android:com.google.android.calendar
reprezentuje aplikację „Kalendarz Google” na Androidaweb:https://canvas.apps.chrome
reprezentuje aplikację internetową „Canvas”
Pola z wieloma wartościami
Pola z etykietą LABEL_REPEATED
reprezentują pola z wieloma wartościami, np. listy i tablice. Tym polach możesz nadać kilka wartości. Więcej informacji znajdziesz w przykładowym kodzie.
Stan schematu zasad
Każda zasada ma obiekt policyApiLifecycle
reprezentujący jej bieżący stan.
Ten obiekt zawiera te pola ze szczegółowymi informacjami o stanie zasady:
- Pole
policyApiLifecycleStage
wskazuje, który z etapów w poniższej tabeli najlepiej opisuje bieżący stan zasady. - Pole
description
zawiera więcej informacji o bieżącym stanie tej zasady. - Pole
endSupport
wskazuje końcową datę obowiązywania zasady, jeśli została ona zdefiniowana. - Wartość
deprecatedInFavorOf
można ustawić tylko wtedy, gdy zasada policyApiLifecycleStage ma wartość API_DEPRECATED. Przedstawia w pełni kwalifikowane przestrzenie nazw nowych zasad, które zastąpiły obecne zasady. - Pole
scheduledToDeprecatePolicies
odpowiada wartości „wycofaneInFavorOf”. Znajdziesz w niej pełne i jednoznaczne przestrzenie nazw starych zasad, które zostaną wycofane w związku z wprowadzeniem tej zasady.
Etapy cyklu życia
Etap | Opis |
---|---|
API_UNSPECIFIED |
Obecny stan zasady jest nieznany. Zarezerwowany, nie używaj. |
API_PREVIEW |
Zasada jeszcze nie działa. Ten etap może zostać przeniesiony na: API_CURRENT lub API_DEVELOPMENT . |
API_DEVELOPMENT |
Zasady nie zostały jeszcze sfinalizowane i możemy wprowadzić zmiany powodujące niezgodność. Ten etap może zostać przeniesiony na: API_CURRENT lub API_DEPRECATED . |
API_CURRENT |
Zasady mają oficjalny format, ale możemy wprowadzić niezmienną zmianę. Ten etap może zostać przeniesiony na: API_DEPRECATED . |
API_DEPRECATED |
Ta zasada została wycofana i w przyszłości może zostać usunięta. Administratorzy powinni przestać używać tej zasady. |
Pokaż przykład
{ "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" } }
Informacje o schemacie zasad
Z niektórymi zasadami powiązane są zasady notices
, które dla określonych wartości w określonych polach zasad acknowledgement_required
ustawiono na wartość true
. Aby w przypadku tych zasad ustawić wartość, w specjalnym polu potwierdzenia musisz ustawić wartość true
.
Więcej informacji znajdziesz w artykule Przykładowe fragmenty kodu.
Obsługiwane platformy
supportedPlatforms
to lista, która wskazuje, że zasada będzie stosowana tylko do urządzeń lub użytkowników na tych platformach. Wszystkie obsługiwane platformy znajdziesz w tabeli poniżej.
Obsługiwana platforma
Platforma | Opis |
---|---|
PLATFORM_UNSPECIFIED |
Nieokreślona platforma. Zarezerwowany, nie używaj. |
CHROME_OS |
ChromeOS |
CHROME_BROWSER |
Przeglądarka Chrome w systemach macOS/Windows/Linux |
CHROME_BROWSER_FOR_ANDROID |
Przeglądarka Chrome na Androida |
CHROME_BROWSER_FOR_IOS |
Przeglądarka Chrome na iOS |