Politika şemaları

Chrome politikaları, Schema Service API tarafından politika şemaları olarak temsil edilir. Her politika şemasını tanımlamak için benzersiz bir ad, ve bunların türlerini ve ayarların okunabilir bir açıklamasını İngilizce.

Aşağıdaki örneğin, Schema Service API'nin aynı zamanda Chrome'un sistem tepsisinde bir çıkış düğmesinin görünmesine olanak tanır. Basitleştirilmiş bu ayarın gösterimi bool showLogoutButtonInTray olur. Sonraki slayta geçin "Örnek göster" Schema Service API'nin bunu nasıl temsil ettiğini görmek için ayarını değiştirebilirsiniz.

{
  "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çime sahip benzersiz tanımlayıcısı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, kullanıcı politikası şemalarının başında bir chrome.users. ad alanı ve Yazıcı politikası şemalarının başında chrome.printers. ad alanı bulunur.

Ad alanları

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 hangi uygulamanın kullanılacağını belirtmeniz gerekir key="app_id" dolduruluyor.
• Bir Kuruluş Birimindeki yazıcı ayarlarıyla ilgili politikayı değiştirmek için: key="printer_id" alanını doldurarak hangi yazıcıyı belirtebilirsiniz.

Bu politika şemalarında, aşağıdakileri açıklayan bir additionalTargetKeyNames bölümü bulunur: API isteklerinizde iletilecek anahtarlar ve değerler.

Ayrıntılı bilgi için Kod örnekleri.

{
  "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ı uygulama politikasına (ör. Kullanıcı Uygulamaları, Kiosk Uygulamaları, Yönetilen Misafir Oturumu Uygulamaları ve Kiosk Uygulamaları Yapılandırma politikaları. Uygulama politikaları için şunlar gerekir: app_id.

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

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

Birden çok değerli alan

LABEL_REPEATED etiketli alanlar, listeler gibi birden çok değerli alanları temsil eder kullanabilirsiniz. Bu alanlara çeşitli değerler verebilirsiniz. Daha fazla bilgi için Kod örnekleri.

Politika şeması durumu

Her politikanın mevcut durumunu temsil eden bir policyApiLifecycle nesnesi vardır. Bu nesne, politikanın kapsamıyla ilgili ayrıntıları içeren aşağıdaki alanları içerir durum:

• policyApiLifecycleStage alanı aşağıdaki aşamalardan hangisinin aşamalarını gösterir tablosu, politikanın mevcut durumunu en iyi şekilde tanımlar.
• description alanı, bu politikanın mevcut durumu hakkında daha fazla bilgi sağlar.
• endSupport alanında, (varsa) politikanın nihai desteklenme tarihi gösterilir tanımlanmıştır.
• deprecatedInFavorOf, yalnızca policyApiLifecycleStage olduğunda ayarlanabilir API_DEPRECATED. Yeni politikaların tam nitelikli ad alanlarını gösterir desteğinin sonlandırıldığını bildirmek istiyorum.
• scheduledToDeprecatePolicies alanı, kullanımdan kaldırıldıInFavorOf. Burada, eski istemcinin tam nitelikli ad alanlarını politikaların kullanıma sunulması nedeniyle kullanımdan kaldırılacak.

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

{
  "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şkili notices var ve bu politika acknowledgement_required belirli politika alanlarının belirli değerleri için true olarak ayarlanır. Bu politikalar için ayarı yapmadan önce true olarak özel bir onay alanı ayarlamanız gerekiyor. değer.

Daha fazla bilgi için Kod örnekleri bölümüne bakın.

Desteklenen platformlar

supportedPlatforms, politikanın yalnızca bu platformlardaki kullanıcılara gösteriliyor. Desteklenen tüm platformlar şurada listelenmiştir: aşağıdaki tabloda bulabilirsiniz.

Desteklenen platform

Sonraki adımlar

• Chrome Policy API'yi etkinleştirme ve istekleri yetkilendirme
• API ile politika şemalarını listeleme