ภาพรวมของ Chrome Policy API
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
Chrome Policy API คือชุดบริการที่ช่วยให้ผู้ดูแลระบบ Chrome สามารถดูและจัดการนโยบาย Chrome ที่กำหนดให้กับหน่วยขององค์กรในองค์กรผ่านการเขียนโปรแกรม ด้วย API นี้ ผู้ดูแลระบบ Chrome จะได้รับข้อมูลเชิงลึกเกี่ยวกับวิธีใช้อุปกรณ์ ChromeOS และเบราว์เซอร์ Chrome ในองค์กร
ข้อดีหลักๆ
ความเข้ากันได้กับคอนโซลผู้ดูแลระบบของ Google:การเปลี่ยนแปลงที่คุณทำด้วย API จะแสดงใน UI ของคอนโซลผู้ดูแลระบบของ Google และการเปลี่ยนแปลงใน UI ของคอนโซลผู้ดูแลระบบของ Google ก็เช่นกัน
การบันทึกการตรวจสอบ: การเปลี่ยนแปลงที่ทําด้วย API นี้จะบันทึกไว้ในบันทึกการตรวจสอบของผู้ดูแลระบบมาตรฐาน
แนวทางที่อิงตามข้อมูล: นโยบาย Chrome จะแสดงเป็นข้อมูลและอินเทอร์เฟซ API ไม่ได้อ้างอิงนโยบายดังกล่าวโดยตรง วิธีนี้จะช่วยให้ไคลเอ็นต์ API ใช้งานนโยบาย Chrome ในอนาคตได้โดยอัตโนมัติโดยไม่ต้องพัฒนาเพิ่มเติม เมื่อเวลาผ่านไป จำนวนนโยบายที่รองรับผ่าน API จะเพิ่มขึ้น
เสริม Admin SDK API: API นี้จะเสริม Admin SDK API ให้ผู้ดูแลระบบ Chrome ทำงานต่อไปนี้
กรณีการใช้งานยอดนิยม
ตารางด้านล่างแสดงงานยอดนิยมที่คุณใช้ API นี้ได้ หากต้องการตรวจสอบตัวอย่างคำขอและคำตอบ ให้ไปที่ตัวอย่างโค้ด
URL จะสัมพัทธ์กับ https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER
| คำอธิบายงาน |
URL ที่เกี่ยวข้อง |
เมธอด HTTP |
พารามิเตอร์คำขอ |
| ระบุสคีมานโยบาย |
./policySchemas |
GET |
ไม่บังคับ: filter, pageSize, pageToken |
| รับสคีมานโยบาย |
./policySchemas/$SCHEMA_NAME |
GET |
|
| รับหรือแสดงรายการนโยบายสำหรับหน่วยขององค์กรหรือกลุ่ม |
./policies:resolve |
POST |
จำเป็น: policySchemaFilter, policyTargetKey
ไม่บังคับ: pageSize, pageToken
|
| แก้ไขนโยบายในหน่วยขององค์กร |
./policies/orgunits:batchModify |
POST |
จำเป็น: requests: {policyTargetKey, policyValue, updateMask} |
| รับค่านโยบายในหน่วยขององค์กร |
./policies/orgunits:batchInherit |
POST |
จำเป็น: requests: {policyTargetKey, policySchema} |
| แก้ไขนโยบายในกลุ่ม |
./policies/groups:batchModify |
POST |
จำเป็น: requests: {policyTargetKey, policyValue, updateMask} |
| ลบนโยบายในกลุ่ม |
./policies/groups:batchDelete |
POST |
จำเป็น: requests: {policyTargetKey, policySchema} |
| แสดงรายการลำดับความสำคัญในกลุ่ม |
./policies/groups:listGroupPriorityOrdering |
POST |
จำเป็น: requests: {policyTargetKey, policyNamespace} |
| อัปเดตลำดับความสำคัญในกลุ่ม |
./policies/groups:updateGroupPriorityOrdering |
POST |
จำเป็น: requests: {policyTargetKey, policyNamespace, groupIds} |
| อัปโหลดไฟล์สำหรับนโยบาย |
./policies/files:uploadPolicyFile |
POST |
จำเป็น: requests: {policyField} |
ขีดจำกัดการใช้งาน
API นี้มีไว้สำหรับใช้ภายในภายในองค์กรของลูกค้า Chrome เท่านั้น โปรดอ่านรายละเอียดเพิ่มเติมที่ข้อกำหนดในการให้บริการของ Chrome Policy API หากต้องการสร้างไคลเอ็นต์ API เชิงพาณิชย์ร่วมกับ Google ให้ส่งใบสมัครพาร์ทเนอร์
ขั้นตอนถัดไป
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-07-25 UTC
[null,null,["อัปเดตล่าสุด 2025-07-25 UTC"],[[["\u003cp\u003eThe Chrome Policy API enables Chrome administrators to programmatically view and manage Chrome policies for their organization's ChromeOS devices and Chrome browsers.\u003c/p\u003e\n"],["\u003cp\u003eIt offers key benefits like Google Admin console compatibility, audit logging, and a data-driven approach for easier automation.\u003c/p\u003e\n"],["\u003cp\u003eAdmins can utilize this API to perform tasks such as listing policy schemas, retrieving specific schemas, and managing policies for organizational units and groups.\u003c/p\u003e\n"],["\u003cp\u003eUsage of this API is restricted to internal use within a Chrome customer's organization, with commercial partnerships requiring a separate application process.\u003c/p\u003e\n"],["\u003cp\u003eFurther exploration is encouraged through provided resources on policy schemas, request setup, and code samples.\u003c/p\u003e\n"]]],[],null,["# Chrome Policy API Overview\n\nThe Chrome Policy API is a suite of services that empower Chrome administrators\nto programmatically view and manage Chrome policies assigned to the\n[Organizational Units](https://support.google.com/a/answer/4352075)\nin their organization. With this API, Chrome admins can gain insights about how\nChromeOS devices and Chrome browsers are being used in their organization.\n\nKey advantages\n--------------\n\n- **Google Admin console compatibility:** Changes you make with the API are\n reflected in Google Admin console UI, and vice versa.\n\n- **Audit logging:** Changes made with this API are logged in the standard\n [Admin Audit logs](https://support.google.com/a/answer/4579579).\n\n- **Data-driven approach:** Chrome policies are represented as data and aren't\n directly referenced by the API interface. This lets you automate API clients\n for consumption of future Chrome policies without additional development. Over\n time, the number of policies supported via API will increase.\n\n- **Complements the Admin SDK API:** This API complements the Admin SDK API,\n where Chrome admins can perform the following tasks:\n\n - [Manage Chrome devices](/admin-sdk/directory/v1/guides/manage-chrome-devices) with the Admin SDK's Directory API.\n - [Manage Chrome browsers](https://support.google.com/chrome/a/answer/9681204) with the Admin SDK's Chrome Browser Management API.\n - [Manage Chrome CUPS printers](/admin-sdk/chrome-printer) with the Admin SDK's Chrome Printer Management API.\n\nPopular use cases\n-----------------\n\nThe table below lists the top tasks you can complete with this API. To review\nexample requests and responses, go to [Code samples](/chrome/policy/guides/samples_policyapi).\n\nURLs are relative to `https://chromepolicy.googleapis.com/v1/customers/`\u003cvar translate=\"no\"\u003e$CUSTOMER\u003c/var\u003e.\n\n| Task description | Relative URL | HTTP method | Request parameters |\n|--------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------|-------------|-----------------------------------------------------------------------------------------|\n| [List policy schemas](/chrome/policy/reference/rest/v1/customers.policySchemas/list) | `./policySchemas` | `GET` | *Optional:* `filter`, `pageSize`, `pageToken` |\n| [Get a policy schema](/chrome/policy/reference/rest/v1/customers.policySchemas/get) | `./policySchemas/`\u003cvar translate=\"no\"\u003e$SCHEMA_NAME\u003c/var\u003e | `GET` | |\n| [Get or list policies for an Organizational Unit or Group](/chrome/policy/reference/rest/v1/customers.policies/resolve) | `./policies:resolve` | `POST` | *Required:* `policySchemaFilter`, `policyTargetKey` *Optional:* `pageSize`, `pageToken` |\n| [Modify policies in an Organizational Unit](/chrome/policy/reference/rest/v1/customers.policies.orgunits/batchModify) | `./policies/orgunits:batchModify` | `POST` | *Required:* `requests: {policyTargetKey, policyValue, updateMask}` |\n| [Inherit policies in an Organizational Unit](/chrome/policy/reference/rest/v1/customers.policies.orgunits/batchInherit) | `./policies/orgunits:batchInherit` | `POST` | *Required:* `requests: {policyTargetKey, policySchema}` |\n| [Modify policies in a Group](/chrome/policy/reference/rest/v1/customers.policies.groups/batchModify) | `./policies/groups:batchModify` | `POST` | *Required:* `requests: {policyTargetKey, policyValue, updateMask}` |\n| [Delete policies in a Group](/chrome/policy/reference/rest/v1/customers.policies.groups/batchDelete) | `./policies/groups:batchDelete` | `POST` | *Required:* `requests: {policyTargetKey, policySchema}` |\n| [List priority orderings in a Group](/chrome/policy/reference/rest/v1/customers.policies.groups/listGroupPriorityOrdering) | `./policies/groups:listGroupPriorityOrdering` | `POST` | *Required:* `requests: {policyTargetKey, policyNamespace}` |\n| [Update priority orderings in a Group](/chrome/policy/reference/rest/v1/customers.policies.groups/updateGroupPriorityOrdering) | `./policies/groups:updateGroupPriorityOrdering` | `POST` | *Required:* `requests: {policyTargetKey, policyNamespace, groupIds}` |\n| [Upload files for a policy](/chrome/policy/reference/rest/v1/media/upload) | `./policies/files:uploadPolicyFile` | `POST` | *Required:* `requests: {policyField}` |\n\nUsage limits\n------------\n\nThis API is only for use internally within a Chrome customer's organization. For more details, review the [Chrome Policy API Terms of Service](http://console.cloud.google.com/tos?id=chrome-policy). To build a commercial API client in partnership with Google, submit a [partner application](https://docs.google.com/forms/d/e/1FAIpQLSdJA-2_BZ3FJLSBtuWkPCMPXqUpxGbCta1wXRrrVdUCX7apog/viewform).\n\nNext steps\n----------\n\n- [Learn about policy schemas](./policy-schemas)\n- [Set up and authorize requests](./setup)\n- [Review code samples](./samples)"]]
