Politika şemaları

Chrome politikaları, Schema Service API tarafından politika şemaları olarak temsil edilir. Her politika şemasının tanımlanması için benzersiz bir adı, ayar alanları ve türlerinin tanımı ve İngilizce ayarların kullanıcılar tarafından okunabilir bir açıklaması vardır.

Örneğin, Schema Service API'nin, Chrome'un sistem tepsisinde çıkış yapma 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 olacaktır. Schema Service API'nin bu ayarı nasıl temsil ettiğini görmek için aşağıdaki "Ö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, şu biçimde benzersiz tanımlayıcısıdır: {namespace}.{leafName}.

Yukarıdaki örnekte, tam şema adı chrome.users.ShowLogoutButton şeklindedir. Ad alanı chrome.users. ve yaprak adı ShowLogoutButton'dır.

Benzer kapsama sahip politikalar aynı ad alanı altında gruplandırılır. Örneğin, tüm kullanıcı politikası şemalarının önüne bir chrome.users. ad alanı, tüm yazıcı politikası şemalarının önüne ise chrome.printers. ad alanı eklenir.

Ad alanları

Ad alanı Anahtar Gerekli 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 key="app_id" 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 görüntülemek veya değiştirmek için ek bağlam gerektirir. Örneğin:

  • Bir uygulamanın politikasını değiştirmek için key="app_id" doldurarak hangi uygulamayı belirtmeniz gerekir.
  • Bir Kuruluş Biriminde yazıcı ayarlarıyla ilgili politikayı değiştirmek için key="printer_id" alanını doldurarak hangi yazıcının kullanılacağını belirtmeniz gerekir.

Bu politika şemaları, API isteklerinizde iletilecek anahtarları ve değerleri açıklayan bir additionalTargetKeyNames bölümü içerir.

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ına yöneliktir. Uygulama politikaları bir app_id gerektirir.

app_id, uygulama türü ile uygulama tanımlayıcısının birleştirilmesiyle oluşturulur. Örneğin:

  • chrome:mkaakpdehdafacodkgkpghoibnmamcme, "Google Çizimler" Chrome Uygulamasını temsil eder
  • android:com.google.android.calendar, "Google Takvim" Android uygulamasını temsil eder
  • web:https://canvas.apps.chrome, "Canvas" Web uygulamasını temsil eder

Birden çok değerli alanlar

LABEL_REPEATED etiketine sahip alanlar, listeler veya diziler gibi birden ç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ı içeren aşağıdaki alanları içerir:

  • policyApiLifecycleStage alanı, aşağıdaki tabloda yer alan aşamalardan hangisinin politikanın mevcut durumunu en iyi şekilde açıkladığını gösterir.
  • description alanı, bu politikanın mevcut durumu hakkında daha fazla bilgi verir.
  • endSupport alanı, tanımlanmışsa politikaya ilişkin nihai desteklenme tarihini gösterir.
  • deprecatedInFavorOf, yalnızca policyApiLifecycleStage'i API_DEPRECATED ise ayarlanabilir. Raporda, mevcut politikanın kullanımdan kaldırıldığı yeni politikaların tam olarak tanımlanmış ad alanları gösterilmektedir.
  • scheduledToDeprecatePolicies alanı, deprecatedInFavorOf'a karşılık gelir. Bu politika, bu politikanın yürürlüğe girmesi nedeniyle kullanımdan kaldırılacak olan eski politikaların tam nitelikli ad alanlarını gösterir.

Yaşam döngüsü aşamaları

Aşama Açıklama
API_UNSPECIFIED Politikanın mevcut durumu bilinmiyor. Ayırtıldı, kullanmayın.
API_PREVIEW Politika henüz çalışmıyor. Bu aşama API_CURRENT veya API_DEVELOPMENT alanına aktarılabilir.
API_DEVELOPMENT Politika henüz kesinleşmedi ve önemli değişiklikler uygulanabilir. Bu aşama API_CURRENT veya API_DEPRECATED alanına aktarılabilir.
API_CURRENT Politika resmi bir biçimdedir ancak zarar vermeyen değişiklikler uygulanabilir. Bu aşama API_DEPRECATED alanına aktarılabilir.
API_DEPRECATED Bu politika kullanımdan kaldırılmıştır ve 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ı politikalarla ilişkilendirilmiş notices var ve acknowledgement_required, belirli politika alanlarının belirli değerleri için true olarak ayarlanmış. Bu politikalarda, değeri ayarlamadan önce true değerine özel bir onay alanı ayarlamanız gerekir.

Daha fazla bilgi için Kod örnekleri başlıklı makaleyi inceleyin.

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 Platform belirtilmemiş. Ayırtıldı, 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ı

Sonraki adımlar