Skema kebijakan

Kebijakan Chrome direpresentasikan sebagai skema kebijakan oleh Schema Service API. Setiap skema kebijakan memiliki nama unik untuk mengidentifikasinya, definisi kolom setelan dan jenisnya, serta deskripsi setelan yang dapat dibaca manusia dalam bahasa Inggris.

Sebagai contoh, di bawah ini adalah cara Schema Service API merepresentasikan setelan yang memungkinkan tombol logout muncul di area notifikasi Chrome. Representasi yang disederhanakan dari setelan ini adalah bool showLogoutButtonInTray. Klik "Tampilkan contoh" di bawah untuk melihat bagaimana Schema Service API merepresentasikan setelan ini.

Tampilkan contoh

{
  "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
}

Nama skema kebijakan

name skema adalah ID uniknya, dengan format berikut: {namespace}.{leafName}.

Dalam contoh di atas, nama skema lengkapnya adalah chrome.users.ShowLogoutButton. Namespace ini adalah chrome.users. dan nama daunnya adalah ShowLogoutButton.

Kebijakan dengan cakupan serupa dikelompokkan dalam namespace yang sama. Misalnya, semua skema kebijakan pengguna diawali dengan namespace chrome.users. dan semua skema kebijakan printer diawali dengan namespace chrome.printers..

Namespace

Namespace Kunci Izin peran admin yang diperlukan
chrome.users.LEAF_NAME   Layanan > Pengelolaan Chrome > Setelan > Kelola Setelan Pengguna
chrome.users.apps.LEAF_NAME key="app_id" Layanan > Pengelolaan Chrome > Setelan > Kelola Setelan Pengguna > Kelola Setelan Aplikasi
chrome.users.appsconfig.LEAF_NAME   Layanan > Pengelolaan Chrome > Setelan > Kelola Setelan Pengguna > Kelola Setelan Aplikasi
chrome.devices.LEAF_NAME   Layanan > Pengelolaan Chrome > Setelan > Kelola Setelan Perangkat ChromeOS
chrome.devices.managedguest.LEAF_NAME   Layanan > Pengelolaan Chrome > Setelan > Kelola Setelan Perangkat ChromeOS
chrome.devices.managedguest.apps.LEAF_NAME key="app_id" Layanan > Pengelolaan Chrome > Setelan > Kelola Setelan Perangkat ChromeOS
chrome.devices.kiosk.LEAF_NAME   Layanan > Pengelolaan Chrome > Setelan > Kelola Setelan Perangkat ChromeOS
chrome.devices.kiosk.apps.LEAF_NAME key="app_id" Layanan > Pengelolaan Chrome > Setelan > Kelola Setelan Perangkat ChromeOS
chrome.devices.kiosk.appsconfig.LEAF_NAME   Layanan > Pengelolaan Chrome > Setelan > Kelola Setelan Perangkat ChromeOS
chrome.printers.LEAF_NAME key="printer_id" Layanan > Pengelolaan Chrome > Setelan > Kelola Printer
chrome.printservers.LEAF_NAME key="print_server_id" Layanan > Pengelolaan Chrome > Setelan > Kelola Printer
chrome.networks.globalsettings.LEAF_NAME   Layanan > Setelan Perangkat Bersama
chrome.networks.wifi.LEAF_NAME key="network_id" Layanan > Setelan Perangkat Bersama
chrome.networks.ethernet.LEAF_NAME key="network_id" Layanan > Setelan Perangkat Bersama
chrome.networks.vpn.LEAF_NAME key="network_id" Layanan > Setelan Perangkat Bersama
chrome.networks.certificates.LEAF_NAME key="network_id" Layanan > Setelan Perangkat Bersama

Kunci skema kebijakan

Beberapa kebijakan memerlukan konteks tambahan untuk dilihat atau diubah. Contoh:

  • Untuk mengubah kebijakan aplikasi, Anda perlu menentukan aplikasi mana dengan mengisi key="app_id".
  • Untuk mengubah kebijakan setelan printer di Unit Organisasi, Anda harus menentukan printer mana dengan mengisi key="printer_id".

Skema kebijakan ini berisi bagian additionalTargetKeyNames yang menjelaskan kunci dan nilai yang akan diteruskan dalam permintaan API Anda.

Untuk mengetahui detail selengkapnya, buka Contoh kode.

Tampilkan contoh

{
  "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"
}

Kebijakan aplikasi

Beberapa namespace di atas ditujukan untuk kebijakan aplikasi, seperti kebijakan Aplikasi Pengguna, Aplikasi Kios, Aplikasi Sesi Tamu Terkelola, dan kebijakan Konfigurasi Aplikasi Kios. Kebijakan aplikasi memerlukan app_id.

app_id dibentuk dengan menggabungkan jenis aplikasi dan ID aplikasi. Contoh:

  • chrome:mkaakpdehdafacodkgkpghoibnmamcme mewakili Aplikasi Chrome "Google Gambar"
  • android:com.google.android.calendar mewakili aplikasi Android "Google Kalender"
  • web:https://canvas.apps.chrome mewakili aplikasi Web "Canvas"

Kolom multi-nilai

Kolom dengan label LABEL_REPEATED mewakili kolom multi-nilai, seperti daftar atau array. Anda dapat memberikan beberapa nilai ke kolom ini. Untuk mengetahui detail selengkapnya, lihat Contoh kode.

Status skema kebijakan

Setiap kebijakan memiliki objek policyApiLifecycle untuk mewakili statusnya saat ini. Objek ini berisi kolom berikut dengan detail tentang status kebijakan:

  • Kolom policyApiLifecycleStage menunjukkan tahap mana dalam tabel berikut yang paling menggambarkan status kebijakan saat ini.
  • Kolom description memberikan detail selengkapnya tentang status kebijakan saat ini.
  • Kolom endSupport menunjukkan tanggal dukungan akhir untuk kebijakan, jika ditentukan.
  • deprecatedInFavorOf hanya dapat disetel jika policyApiLifecycleStage adalah API_DEPRECATED. Bagian ini menunjukkan namespace yang sepenuhnya memenuhi syarat dari kebijakan baru yang kebijakan saat ini tidak digunakan lagi.
  • Kolom scheduledToDeprecatePolicies sesuai dengan InFavorOf yang tidak digunakan lagi. Bagian ini menunjukkan namespace yang sepenuhnya memenuhi syarat dari kebijakan lama yang tidak akan digunakan lagi karena diperkenalkannya kebijakan ini.

Tahapan siklus proses

Tahap Deskripsi
API_UNSPECIFIED Status kebijakan saat ini tidak diketahui. Direservasi, jangan digunakan.
API_PREVIEW Kebijakan belum berfungsi. Tahap ini dapat ditransfer ke API_CURRENT atau API_DEVELOPMENT.
API_DEVELOPMENT Kebijakan belum diselesaikan dan perubahan yang dapat menyebabkan gangguan mungkin akan diterapkan. Tahap ini dapat ditransfer ke API_CURRENT atau API_DEPRECATED.
API_CURRENT Kebijakan menggunakan format resmi, tetapi mungkin akan ada perubahan yang tidak menyebabkan gangguan. Tahap ini dapat ditransfer ke API_DEPRECATED.
API_DEPRECATED Kebijakan ini tidak digunakan lagi dan mungkin dihapus pada masa mendatang. Admin sebaiknya berhenti menggunakan kebijakan ini.

Tampilkan contoh

{
  "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"
  }
}

Pemberitahuan skema kebijakan

Beberapa kebijakan memiliki notices yang terkait dengan acknowledgement_required yang ditetapkan ke true untuk nilai tertentu dari kolom kebijakan tertentu. Untuk kebijakan ini, Anda perlu menetapkan kolom konfirmasi khusus ke true sebelum dapat menetapkan nilai.

Untuk mengetahui detail selengkapnya, lihat Contoh kode.

Platform yang didukung

supportedPlatforms adalah daftar yang menunjukkan bahwa kebijakan hanya akan berlaku untuk perangkat atau pengguna di platform tersebut. Semua platform yang didukung tercantum dalam tabel berikut.

Platform yang didukung

Platform Deskripsi
PLATFORM_UNSPECIFIED Platform tidak ditentukan. Direservasi, jangan digunakan.
CHROME_OS ChromeOS
CHROME_BROWSER Browser Chrome untuk macOS/Windows/Linux
CHROME_BROWSER_FOR_ANDROID Browser Chrome untuk Android
CHROME_BROWSER_FOR_IOS Browser Chrome untuk iOS

Langkah berikutnya