Chrome politikaları, Schema Service API tarafından politika şemaları olarak temsil edilir. Her politika şemasını tanımlamak için benzersiz bir ad, ayar alanlarının ve türlerinin tanımı ve ayarların İngilizce dilinde okunabilir bir açıklaması vardır.
Örneğin, Schema Service API'nin, Chrome'un sistem tepsisinde bir oturum kapatma düğmesinin görünmesine izin veren bir ayarı nasıl temsil ettiğini aşağıda görebilirsiniz. Bu ayarın basitleştirilmiş bir gösterimi bool showLogoutButtonInTray
olur. Schema Service API'nin bu ayarı nasıl temsil ettiğini görmek için aşağıda "Bir örnek göster"i tıklayın.
Örnek göster
{ "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 }
Politika şeması adları
Bir şemanın name
öğesi, aşağıdaki biçimde benzersiz bir tanımlayıcıdır:
{namespace}.{leafName}
.
Yukarıdaki örnekte tam şema adı chrome.users.ShowLogoutButton
şeklindedir.
Ad alanı chrome.users.
, yaprak adı ise ShowLogoutButton
şeklindedir.
Benzer kapsama sahip politikalar aynı ad alanı altında gruplandırılır. Örneğin, tüm kullanıcı politikası şemalarının başında chrome.users.
ad alanı bulunur ve tüm yazıcı politikası şemalarının başında chrome.printers.
ad alanı bulunur.
Ad alanları
Ad alanı | Anahtar | Zorunlu yönetici rolü izni |
---|---|---|
chrome.users.LEAF_NAME |
Hizmetler > Chrome Yönetimi > Ayarlar > Kullanıcı Ayarlarını Yönet | |
chrome.users.apps.LEAF_NAME |
key="app_id" |
Hizmetler > Chrome Yönetimi > Ayarlar > Kullanıcı Ayarlarını Yönet > Uygulama Ayarlarını Yönet |
chrome.users.appsconfig.LEAF_NAME |
Hizmetler > Chrome Yönetimi > Ayarlar > Kullanıcı Ayarlarını Yönet > Uygulama Ayarlarını Yönet | |
chrome.devices.LEAF_NAME |
Hizmetler > Chrome Yönetimi > Ayarlar > ChromeOS Cihaz Ayarlarını Yönet | |
chrome.devices.managedguest.LEAF_NAME |
Hizmetler > Chrome Yönetimi > Ayarlar > ChromeOS Cihaz Ayarlarını Yönet | |
chrome.devices.managedguest.apps.LEAF_NAME |
key="app_id" |
Hizmetler > Chrome Yönetimi > Ayarlar > ChromeOS Cihaz Ayarlarını Yönet |
chrome.devices.kiosk.LEAF_NAME |
Hizmetler > Chrome Yönetimi > Ayarlar > ChromeOS Cihaz Ayarlarını Yönet | |
chrome.devices.kiosk.apps.LEAF_NAME |
key="app_id" |
Hizmetler > Chrome Yönetimi > Ayarlar > ChromeOS Cihaz Ayarlarını Yönet |
chrome.devices.kiosk.appsconfig.LEAF_NAME |
Hizmetler > Chrome Yönetimi > Ayarlar > ChromeOS Cihaz Ayarlarını Yönet | |
chrome.printers.LEAF_NAME |
key="printer_id" |
Hizmetler > Chrome Yönetimi > Ayarlar > Yazıcıları Yönet |
chrome.printservers.LEAF_NAME |
key="print_server_id" |
Hizmetler > Chrome Yönetimi > Ayarlar > Yazıcıları Yönet |
chrome.networks.globalsettings.LEAF_NAME |
Hizmetler > Paylaşılan Cihaz Ayarları | |
chrome.networks.wifi.LEAF_NAME |
key="network_id" |
Hizmetler > Paylaşılan Cihaz Ayarları |
chrome.networks.ethernet.LEAF_NAME |
key="network_id" |
Hizmetler > Paylaşılan Cihaz Ayarları |
chrome.networks.vpn.LEAF_NAME |
key="network_id" |
Hizmetler > Paylaşılan Cihaz Ayarları |
chrome.networks.certificates.LEAF_NAME |
key="network_id" |
Hizmetler > Paylaşılan Cihaz Ayarları |
Politika şeması anahtarları
Bazı politikalar için ek bağlamın görüntülenmesi veya değiştirilmesi gerekir. Örneğin:
- Bir uygulamanın politikasını değiştirmek için
key="app_id"
alanını doldurarak hangi uygulamayı eklemeniz gerekir? - Bir Kuruluş Birimindeki yazıcı ayarlarıyla ilgili politikayı değiştirmek için
key="printer_id"
alanını doldurarak hangi yazıcıyı kullandığınızı belirtmeniz gerekir.
Bu politika şemalarında, API isteklerinizde iletilecek anahtarları ve değerleri açıklayan bir additionalTargetKeyNames
bölümü bulunur.
Daha fazla bilgi için Kod örnekleri bölümüne gidin.
Örnek göster
{ "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" }
Uygulama politikaları
Yukarıdaki ad alanlarından bazıları Kullanıcı Uygulamaları, Kiosk Uygulamaları, Yönetilen Misafir Oturumu Uygulamaları ve Kiosk Uygulamaları Yapılandırması politikaları gibi uygulama politikası içindir. Uygulama politikaları için app_id
gerekir.
app_id
, uygulama türü ile uygulama tanımlayıcısı birleştirilerek oluşturulur. Örneğin:
chrome:mkaakpdehdafacodkgkpghoibnmamcme
, "Google Çizimler" Chrome Uygulamasını temsil etmektedirandroid:com.google.android.calendar
, "Google Takvim" Android uygulamasını temsil ederweb:https://canvas.apps.chrome
, "Tuval" Web uygulamasını temsil eder
Birden çok değerli alan
LABEL_REPEATED
etiketli alanlar, listeler veya diziler gibi çok değerli alanları temsil eder. Bu alanlara çeşitli değerler verebilirsiniz. Daha fazla bilgi için Kod örnekleri bölümüne bakın.
Politika şeması durumu
Her politikanın mevcut durumunu temsil eden bir policyApiLifecycle
nesnesi vardır.
Bu nesne, politikanın durumuyla ilgili ayrıntıların yer aldığı aşağıdaki alanları içerir:
policyApiLifecycleStage
alanı, aşağıdaki tabloda yer alan aşamalardan hangisinin politikanın mevcut durumunu en iyi şekilde tanımladığını gösterir.description
alanı, bu politikanın mevcut durumu hakkında daha fazla bilgi sağlar.endSupport
alanı, tanımlanmışsa politikanın nihai desteklenme tarihini gösterir.deprecatedInFavorOf
yalnızca policyApiLifecycleStage API_DEPRECATED ise ayarlanabilir. Mevcut politikanın desteğinin sonlandırıldığı yeni politikaların tam nitelikli ad alanlarını gösterir.scheduledToDeprecatePolicies
alanı, deprecatedInFavorOf öğesine karşılık gelir. Bu raporda, bu politikanın yürürlüğe girmesi nedeniyle desteği sonlandırılacak eski politikaların tam nitelikli ad alanları gösterilmektedir.
Yaşam döngüsü aşamaları
Aşama | Açıklama |
---|---|
API_UNSPECIFIED |
Politikanın mevcut durumu bilinmiyor. Ayrılmış, kullanmayın. |
API_PREVIEW |
Politika henüz çalışmıyor. Bu aşama API_CURRENT veya API_DEVELOPMENT hesabına aktarılabilir. |
API_DEVELOPMENT |
Politika henüz kesinleşmedi ve zarar veren değişiklikler yapılabilir. Bu aşama API_CURRENT veya API_DEPRECATED hesabına aktarılabilir. |
API_CURRENT |
Politika resmi bir biçimdedir ancak ihlal etmeyen değişiklikler yapılabilir. Bu aşama API_DEPRECATED hesabına aktarılabilir. |
API_DEPRECATED |
Bu politikanın desteği sonlandırılmış olup gelecekte kaldırılabilir. Yöneticiler bu politikayı kullanmayı bırakmalıdır. |
Örnek göster
{ "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" } }
Politika şeması bildirimleri
Bazı politikalarda, belirli politika alanlarının belirli değerleri için acknowledgement_required
, true
olarak ayarlanmış notices
bulunur. Bu politikalarda, değeri belirlemeden önce true
olarak özel bir onay alanı ayarlamanız gerekir.
Daha fazla bilgi için Kod örnekleri bölümüne bakın.
Desteklenen platformlar
supportedPlatforms
, politikanın yalnızca bu platformlardaki cihazlar veya kullanıcılar için geçerli olacağını belirten bir listedir. Desteklenen tüm platformlar aşağıdaki tabloda listelenmiştir.
Desteklenen platform
Platform | Açıklama |
---|---|
PLATFORM_UNSPECIFIED |
Belirtilmemiş platform. Ayrılmış, kullanmayın. |
CHROME_OS |
ChromeOS |
CHROME_BROWSER |
macOS/Windows/Linux için Chrome Tarayıcı |
CHROME_BROWSER_FOR_ANDROID |
Android için Chrome Tarayıcı |
CHROME_BROWSER_FOR_IOS |
iOS için Chrome Tarayıcı |