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ę, czyli definicję ustawienia i ich typach, a także zrozumiały dla człowieka opis ustawień Angielski.
Poniżej znajdziesz przykładowy sposób, w jaki interfejs Schema Service API reprezentuje ustawienie, które
umożliwia wyświetlenie przycisku wylogowania w obszarze powiadomień Chrome. Uproszczona
reprezentacja tego ustawienia będzie wyglądała tak: bool showLogoutButtonInTray
. Kliknij
„Pokaż przykład” poniżej możesz zobaczyć, jak interfejs Schema Service API przedstawia to
.
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 są poprzedzone przestrzenią nazw chrome.users.
i wszystkie
schematy zasad dotyczących 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ądzanie 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ądzanie ustawieniami aplikacji |
chrome.users.appsconfig.LEAF_NAME |
Usługi > Zarządzanie urządzeniami z Chrome > Ustawienia > Zarządzaj ustawieniami użytkowników > Zarządzanie 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 określić, która aplikacja
dzięki wypełnieniu pola
key="app_id"
. - Aby zmodyfikować zasady ustawień drukarek w jednostce organizacyjnej, musisz wykonać te czynności:
Określ drukarkę, wypełniając pole
key="printer_id"
.
Te schematy zasad zawierają sekcję additionalTargetKeyNames
, która opisuje
klucze i wartości przekazywane w żądaniach do interfejsu API.
Więcej informacji: Przykładowy kod
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 dotyczą zasad dotyczących aplikacji, na przykład aplikacji użytkowników, aplikacji kiosku,
Zasady konfiguracji aplikacji z zarządzanej sesji gościa i aplikacji kiosku. Zasady dotyczące aplikacji wymagają
app_id
.
app_id
powstaje, łącząc typ i identyfikator aplikacji. Na przykład:
chrome:mkaakpdehdafacodkgkpghoibnmamcme
reprezentuje „Rysunki Google” Aplikacja Chromeandroid:com.google.android.calendar
reprezentuje „Kalendarz Google” Aplikacja na Androidaweb:https://canvas.apps.chrome
reprezentuje element „Canvas” Aplikacja internetowa
Pola z wieloma wartościami
Pola z etykietą LABEL_REPEATED
reprezentują pola z wieloma wartościami, np. listy
lub tablice. Tym polach możesz nadać kilka wartości. Więcej informacji:
Przykładowy kod
Stan schematu zasad
Każda zasada ma obiekt policyApiLifecycle
reprezentujący jej bieżący stan.
Ten obiekt zawiera następujące pola ze szczegółowymi informacjami o
stan:
- Pole
policyApiLifecycleStage
pokazuje, które etapy w następujących przypadkach tabela najlepiej opisuje bieżący stan zasady. - Pole
description
zawiera więcej informacji o bieżącym stanie tej zasady. - Pole
endSupport
podaje końcową datę uzasadnienia zastosowania zasady (jeśli taka jest) . - Pole
deprecatedInFavorOf
można ustawić tylko wtedy, gdy zasada policyApiLifecycleStage ma wartość API_DEPRECATED. Wyświetla w pełni kwalifikowane przestrzenie nazw nowych zasad które zastąpią obecne zasady. - Pole
scheduledToDeprecatePolicies
odpowiada wycofanoInFavorOf. Wyświetla w pełni kwalifikowane przestrzenie nazw starych zasad, które zostaną wycofane w związku z wprowadzeniem tych zasad.
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 są powiązane zasady notices
, z którymi jest acknowledgement_required
ustawiono na true
dla określonych wartości niektórych pól zasad. W przypadku tych zasad
musisz ustawić specjalne pole potwierdzenia na true
, aby móc
.
Więcej informacji znajdziesz w artykule Przykładowe fragmenty kodu.
Obsługiwane platformy
supportedPlatforms
to lista, która oznacza, że zasada będzie stosowana tylko
do urządzeń lub użytkowników tych platform. Wszystkie obsługiwane platformy są wymienione 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 |