Chrome Policy API 개요
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Chrome Policy API는 Chrome 관리자가 조직의 조직 단위에 할당된 Chrome 정책을 프로그래매틱 방식으로 보고 관리할 수 있도록 하는 서비스 모음입니다. Chrome 관리자는 이 API를 사용하여 조직에서 ChromeOS 기기 및 Chrome 브라우저가 사용되는 방식에 관한 유용한 정보를 얻을 수 있습니다.
주요 이점
Google 관리 콘솔 호환성: API로 변경한 사항은 Google 관리 콘솔 UI에 반영되며 반대의 경우도 마찬가지입니다.
감사 로깅: 이 API를 사용한 변경사항은 표준 관리자 감사 로그에 로깅됩니다.
데이터 기반 접근 방식: Chrome 정책은 데이터로 표현되며 API 인터페이스에서 직접 참조되지 않습니다. 이렇게 하면 추가 개발 없이 향후 Chrome 정책을 사용하도록 API 클라이언트를 자동화할 수 있습니다. 시간이 지남에 따라 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 서비스 약관을 참고하세요. Google과 협력하여 상업용 API 클라이언트를 빌드하려면 파트너 신청서를 제출하세요.
다음 단계
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 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)"]]
