Trang này được dịch bởi Cloud Translation API.

Mã mẫu cho chính sách ứng dụng

Những yêu cầu bên dưới minh hoạ hoạt động quản lý chính sách bằng API Chính sách, lấy chính sách ứng dụng làm ví dụ. Trước khi bắt đầu, hãy nhớ xem bài viết Tổng quan về API Chính sách của Chrome và hướng dẫn về Giản đồ chính sách.

Tất cả yêu cầu được trình bày bên dưới đều sử dụng các biến sau:

$TOKEN – Mã thông báo OAuth 2
$CUSTOMER - Mã khách hàng hoặc giá trị cố định my_customer

Buộc cài đặt một ứng dụng

Sau đây là ví dụ về một Đơn vị tổ chức. Yêu cầu Nhóm sẽ giống nhau, ngoại trừ targetResource có "groups/" thay vì "orgunits/" trước mã nhận dạng.

Ở đây, chúng ta đang đặt ứng dụng Google Bản vẽ thành buộc cài đặt:

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
        requests: [{
                policyTargetKey: {
                        targetResource: "orgunits/04fatzly4jbjho9",
                        additionalTargetKeys: {"app_id": "chrome:mkaakpdehdafacodkgkpghoibnmamcme"}
                        },
                policyValue: {
                        policySchema: "chrome.users.apps.InstallType",
                        value: {appInstallType: "FORCED"}
                        },
                updateMask: {paths: "appInstallType"}
                }]
      }' \
  "https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies/orgunits:batchModify"

Bạn nên để trống phản hồi thành công:

{}

Ví dụ này dành cho Ứng dụng người dùng. Yêu cầu Phiên khách được quản lý sẽ giống nhau, ngoại trừ giản đồ chính sách là chrome.devices.managedguest.apps.InstallType. Sau đây là yêu cầu tương đương về chính sách Ứng dụng kiosk như sau:

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
        requests: [{
                policyTargetKey: {
                        targetResource: "orgunits/04fatzly4jbjho9",
                        additionalTargetKeys: {"app_id": "chrome:mkaakpdehdafacodkgkpghoibnmamcme"}
                        },
                policyValue: {
                        policySchema: "chrome.devices.kiosk.apps.ForceInstall",
                        value: {forceInstall: false}
                        },
                updateMask: {paths: "forceInstall"}
                }]
      }' \
  "https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies/orgunits:batchModify"

Bạn nên để trống phản hồi thành công:

{}

Xoá ứng dụng

Bạn phải xoá một ứng dụng tại đơn vị tổ chức nơi ứng dụng đã được thêm rõ ràng để quản lý. Khi gọi lệnh phân giải, trường addedSourceKey chứa Đơn vị tổ chức đã được thêm vào để quản lý. Nói cách khác, bạn chỉ nên gọi delete cho những ứng dụng mà Đơn vị tổ chức trong addedSourceKey bằng với đơn vị tổ chức trong policyTargetKey.

Để xoá một ứng dụng (xoá ứng dụng khỏi hoạt động quản lý một cách rõ ràng), bạn nên gửi yêu cầu batchInherit, trong đó policySchema là giản đồ cho loại ứng dụng nhất định, với dấu hoa thị (*) thay cho một chính sách cụ thể. Trong ví dụ này, chúng tôi sẽ xoá ứng dụng Google Bản vẽ, ứng dụng này được cài đặt tại Đơn vị tổ chức "04fatzly4víjho9":

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
        requests: [{
                policyTargetKey: {
                        targetResource: "orgunits/04fatzly4jbjho9",
                        additionalTargetKeys: {"app_id": "chrome:gbchcmhmhahfdphkhkmpfmihenigjmpp"}
                        },
                policySchema: "chrome.users.apps.*",
                }]
      }' \
  "https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies/orgunits:batchInherit"

Bạn nên để trống phản hồi thành công:

{}

Các yêu cầu xoá ứng dụng Kiosk và ứng dụng Phiên khách được quản lý sẽ sử dụng giản đồ chrome.devices.kiosk.apps.\* và chrome.devices.managedguest.apps.\* tương ứng.

Tải chính sách cài đặt ứng dụng cho một ứng dụng trong một đơn vị tổ chức

Để nhận chính sách cho một ứng dụng cụ thể, bạn phải chỉ định cả chính sách và Mã ứng dụng trong yêu cầu. Trong ví dụ này, chúng ta sẽ đọc giá trị của chính sách InstallType cho ứng dụng Google Bản vẽ:

Yêu cầu

  curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
        policyTargetKey: {
          targetResource: "orgunits/04fatzly4jbjho9",
          additionalTargetKeys: {"app_id": "chrome:mkaakpdehdafacodkgkpghoibnmamcme"}
        },
        policySchemaFilter: "chrome.users.apps.InstallType"
    }' \
  "https://chromepolicy.googleapis.com/v1/$CUSTOMER/C02l1chq7/policies:resolve"

Phản hồi

{
  "resolvedPolicies": [
    {
      "targetKey": {
        "targetResource": "orgunits/04fatzly4jbjho9",
        "additionalTargetKeys": {
          "app_id": "chrome:mkaakpdehdafacodkgkpghoibnmamcme"
        }
      },
      "value": {
        "policySchema": "chrome.users.apps.InstallType",
        "value": {
          "appInstallType": "FORCED"
        }
      },
      "sourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      },
      "addedSourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      }
    }
  ]
}

Tải Chính sách cài đặt ứng dụng cho tất cả ứng dụng trong một đơn vị tổ chức

Nếu bạn bỏ qua Mã ứng dụng khỏi yêu cầu trong ví dụ trước, mã ứng dụng đó sẽ trở thành yêu cầu cho giá trị của chính sách InstallType cho tất cả ứng dụng trong đơn vị tổ chức đó.

Yêu cầu

  curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
        policyTargetKey: {
          targetResource: "orgunits/04fatzly4jbjho9",
        },
        policySchemaFilter: "chrome.users.apps.InstallType"
    }' \
  "https://chromepolicy.googleapis.com/v1/$CUSTOMER/C02l1chq7/policies:resolve"

Phản hồi

{
  "resolvedPolicies": [
    {
      "targetKey": {
        "targetResource": "orgunits/04fatzly4jbjho9",
        "additionalTargetKeys": {
          "app_id": "chrome:mkaakpdehdafacodkgkpghoibnmamcme"
        }
      },
      "value": {
        "policySchema": "chrome.users.apps.InstallType",
        "value": {
          "appInstallType": "FORCED"
        }
      },
      "sourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      },
      "addedSourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      }
    },
    {
      "targetKey": {
        "targetResource": "orgunits/04fatzly4jbjho9",
        "additionalTargetKeys": {
          "app_id": "chrome:fhcfdhnmhdkemdfdncjmgnanbekfmbab"
        }
      },
      "value": {
        "policySchema": "chrome.users.apps.InstallType",
        "value": {
          "appInstallType": "ALLOWED"
        }
      },
      "sourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      },
      "addedSourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      }
    },
    ...
  ]
}

Liệt kê tất cả các chính sách cho một ứng dụng trong đơn vị tổ chức

Tương tự như việc có thể bỏ qua mã ứng dụng khỏi yêu cầu truy xuất chính sách cho tất cả ứng dụng, bạn cũng có thể xem tất cả chính sách của một ứng dụng bằng cách dùng ký tự đại diện trong chính sách đó. Trong ví dụ này, chúng ta sẽ nhận giá trị của tất cả các chính sách cho ứng dụng Google Bản vẽ.

Yêu cầu

  curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
        policyTargetKey: {
          targetResource: "orgunits/04fatzly4jbjho9",
          additionalTargetKeys: {"app_id": "chrome:mkaakpdehdafacodkgkpghoibnmamcme"}
        },
        policySchemaFilter: "chrome.users.apps.*"
    }' \
  "https://chromepolicy.googleapis.com/v1/$CUSTOMER/C02l1chq7/policies:resolve"

Phản hồi

{
  "resolvedPolicies": [
    {
      "targetKey": {
        "targetResource": "orgunits/04fatzly4jbjho9",
        "additionalTargetKeys": {
          "app_id": "chrome:mkaakpdehdafacodkgkpghoibnmamcme"
        }
      },
      "value": {
        "policySchema": "chrome.users.apps.InstallType",
        "value": {
          "appInstallType": "FORCED"
        }
      },
      "sourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      },
      "addedSourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      }
    },
    {
      "targetKey": {
        "targetResource": "orgunits/04fatzly4jbjho9",
        "additionalTargetKeys": {
          "app_id": "chrome:mkaakpdehdafacodkgkpghoibnmamcme"
        }
      },
      "value": {
        "policySchema": "chrome.users.apps.IncludeInChromeWebStoreCollection",
        "value": {
          "includeInCollection": true
        }
      },
      "sourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      },
      "addedSourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      }
    },
    ...
  ]
}

Liệt kê tất cả các chính sách cho tất cả ứng dụng trong một đơn vị tổ chức

Bạn có thể bỏ qua mã ứng dụng và dùng ký tự đại diện trong chính sách để yêu cầu tất cả chế độ cài đặt ứng dụng cho tất cả ứng dụng trong một đơn vị tổ chức.

Yêu cầu

  curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
        policyTargetKey: {
          targetResource: "orgunits/04fatzly4jbjho9"
        },
        policySchemaFilter: "chrome.users.apps.*"
    }' \
  "https://chromepolicy.googleapis.com/v1/$CUSTOMER/C02l1chq7/policies:resolve"

Phản hồi

{
  "resolvedPolicies": [
    {
      "targetKey": {
        "targetResource": "orgunits/04fatzly4jbjho9",
        "additionalTargetKeys": {
          "app_id": "chrome:mkaakpdehdafacodkgkpghoibnmamcme"
        }
      },
      "value": {
        "policySchema": "chrome.users.apps.InstallType",
        "value": {
          "appInstallType": "FORCED"
        }
      },
      "sourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      },
      "addedSourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      }
    },
    {
      "targetKey": {
        "targetResource": "orgunits/04fatzly4jbjho9",
        "additionalTargetKeys": {
          "app_id": "chrome:mkaakpdehdafacodkgkpghoibnmamcme"
        }
      },
      "value": {
        "policySchema": "chrome.users.apps.IncludeInChromeWebStoreCollection",
        "value": {
          "includeInCollection": true
        }
      },
      "sourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      },
      "addedSourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      }
    },
    {
      "targetKey": {
        "targetResource": "orgunits/04fatzly4jbjho9",
        "additionalTargetKeys": {
          "app_id": "chrome:fhcfdhnmhdkemdfdncjmgnanbekfmbab"
        }
      },
      "value": {
        "policySchema": "chrome.users.apps.InstallType",
        "value": {
          "appInstallType": "ALLOWED"
        }
      },
      "sourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      },
      "addedSourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      }
    },
    {
      "targetKey": {
        "targetResource": "orgunits/04fatzly4jbjho9",
        "additionalTargetKeys": {
          "app_id": "chrome:fhcfdhnmhdkemdfdncjmgnanbekfmbab"
        }
      },
      "value": {
        "policySchema": "chrome.users.apps.CertificateManagement",
        "value": {
          "allowAccessToKeys": true
        }
      },
      "sourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      },
      "addedSourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      }
    },
    ...
  ]
}

Xoá ứng dụng AutoLaunchApp trong Kiosk Appsconfig

Để xoá AutoLaunchApp, bạn có thể đặt appId thành "None".

Lưu ý rằng khi đặt appId thành "None", tất cả các chế độ cài đặt AutoLaunchApp khác sẽ được đặt thành giá trị mặc định. Mọi chế độ cài đặt AutoLaunchApp ngoài appId được gửi trong yêu cầu đều sẽ bị bỏ qua trong trường hợp này.

Yêu cầu

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
        requests: [{
                policyTargetKey: {
                        targetResource: "orgunits/04fatzly4jbjho9"
                        },
                policyValue: {
                        policySchema: "chrome.devices.kiosk.appsconfig.AutoLaunchApp",
                        value: {appId: "None"}
                        },
                updateMask: {paths: "appId"}
                }]
      }' \
  "https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies/orgunits:batchModify"

Phản hồi

Không có phản hồi thành công.

{}