Chrome 정책은 Schema Service API에 의해 정책 스키마로 표시됩니다. 각 정책 스키마에는 이를 식별할 수 있는 고유한 이름과 설정의 정의가 있습니다. 필드 및 그 유형, 사람이 읽을 수 있는 설정에 대한 설명이 영어입니다.
예를 들어 다음은 Schema Service API가
로그아웃 버튼이 Chrome 작업 표시줄에 표시되도록 허용합니다. 단순화된
이 설정의 표현은 bool showLogoutButtonInTray
입니다. 클릭
"예 보기" Schema Service API가 이를 나타내는 방식을
설정을 변경합니다.
예 보기
{ "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 }
정책 스키마 이름
스키마의 name
는 다음과 같은 형식의 고유 식별자입니다.
{namespace}.{leafName}
위의 예시에서 전체 스키마 이름은 chrome.users.ShowLogoutButton
입니다.
네임스페이스는 chrome.users.
이고 리프 이름은 ShowLogoutButton
입니다.
비슷한 범위의 정책은 동일한 네임스페이스로 그룹화됩니다. 예를 들어
사용자 정책 스키마에는 chrome.users.
네임스페이스가 접두사로 사용되며
프린터 정책 스키마에는 chrome.printers.
네임스페이스가 접두사로 붙습니다.
네임스페이스
네임스페이스 | 키 | 필요한 관리자 역할 권한 |
---|---|---|
chrome.users.LEAF_NAME |
서비스 > Chrome 관리 > 설정 > 사용자 설정 관리 | |
chrome.users.apps.LEAF_NAME |
key="app_id" |
서비스 > Chrome 관리 > 설정 > 사용자 설정 관리 > 애플리케이션 설정 관리 |
chrome.users.appsconfig.LEAF_NAME |
서비스 > Chrome 관리 > 설정 > 사용자 설정 관리 > 애플리케이션 설정 관리 | |
chrome.devices.LEAF_NAME |
서비스 > Chrome 관리 > 설정 > ChromeOS 기기 설정 관리 | |
chrome.devices.managedguest.LEAF_NAME |
서비스 > Chrome 관리 > 설정 > ChromeOS 기기 설정 관리 | |
chrome.devices.managedguest.apps.LEAF_NAME |
key="app_id" |
서비스 > Chrome 관리 > 설정 > ChromeOS 기기 설정 관리 |
chrome.devices.kiosk.LEAF_NAME |
서비스 > Chrome 관리 > 설정 > ChromeOS 기기 설정 관리 | |
chrome.devices.kiosk.apps.LEAF_NAME |
key="app_id" |
서비스 > Chrome 관리 > 설정 > ChromeOS 기기 설정 관리 |
chrome.devices.kiosk.appsconfig.LEAF_NAME |
서비스 > Chrome 관리 > 설정 > ChromeOS 기기 설정 관리 | |
chrome.printers.LEAF_NAME |
key="printer_id" |
서비스 > Chrome 관리 > 설정 > 프린터 관리 |
chrome.printservers.LEAF_NAME |
key="print_server_id" |
서비스 > Chrome 관리 > 설정 > 프린터 관리 |
chrome.networks.globalsettings.LEAF_NAME |
서비스 > 공유 기기 설정 | |
chrome.networks.wifi.LEAF_NAME |
key="network_id" |
서비스 > 공유 기기 설정 |
chrome.networks.ethernet.LEAF_NAME |
key="network_id" |
서비스 > 공유 기기 설정 |
chrome.networks.vpn.LEAF_NAME |
key="network_id" |
서비스 > 공유 기기 설정 |
chrome.networks.certificates.LEAF_NAME |
key="network_id" |
서비스 > 공유 기기 설정 |
정책 스키마 키
일부 정책의 경우 추가 컨텍스트가 있어야 보거나 수정할 수 있습니다. 예를 들면 다음과 같습니다.
- 애플리케이션의 정책을 수정하려면 어떤 애플리케이션을 사용할지 지정해야 합니다.
key="app_id"
을(를) 채웁니다. - 조직 단위의 프린터 설정 정책을 수정하려면 다음을 수행해야 합니다.
key="printer_id"
을(를) 입력하여 프린터를 지정할 수 있습니다.
이러한 정책 스키마에는 다음을 설명하는 additionalTargetKeyNames
섹션이 포함되어 있습니다.
API 요청에 전달할 키와 값입니다.
자세한 내용은 다음을 참고하세요. 코드 샘플
예 보기
{ "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" }
앱 정책
위의 네임스페이스 중 일부는 앱 정책용입니다(예: 사용자 앱, 키오스크 앱,
관리 게스트 세션 앱, 키오스크 앱 구성 정책 앱 정책에는
app_id
app_id
는 앱 유형과 앱 식별자를 결합하여 형성됩니다. 예를 들면 다음과 같습니다.
chrome:mkaakpdehdafacodkgkpghoibnmamcme
는 'Google 드로잉'을 나타냅니다. Chrome 앱android:com.google.android.calendar
는 'Google Calendar'를 나타냅니다. Android 앱web:https://canvas.apps.chrome
는 '캔버스'를 나타냅니다. 웹 앱
다중 값 필드
LABEL_REPEATED
라벨이 있는 필드는 목록과 같이 다중 값 필드를 나타냅니다.
사용할 수 있습니다 이 필드에는 여러 값을 지정할 수 있습니다. 자세한 내용은
코드 샘플
정책 스키마 상태
모든 정책에는 현재 상태를 나타내는 policyApiLifecycle
객체가 있습니다.
이 객체에는 정책의 세부정보가 있는 다음 필드가 포함됩니다.
상태:
policyApiLifecycleStage
필드는 다음 중 어떤 단계를 보여줍니다. 표는 정책의 현재 상태를 가장 잘 설명합니다.description
필드는 이 정책의 현재 상태에 대한 세부정보를 제공합니다.endSupport
필드에는 정책의 최종 지원일이 표시됩니다(있는 경우). 정의할 수 있습니다deprecatedInFavorOf
는 policyApiLifecycleStage가 다음과 같은 경우에만 설정할 수 있습니다. API_DEPRECATED가 지원됩니다. 새 정책의 정규화된 네임스페이스가 표시됩니다. 현재 정책이 지원 중단됩니다scheduledToDeprecatePolicies
필드는 다음에 해당합니다. 지원 중단된 InFavorOf입니다. 이전 포드의 정규화된 네임스페이스를 표시합니다. 정책의 도입으로 지원이 중단될 예정입니다.
수명 주기 단계
단계 | 설명 |
---|---|
API_UNSPECIFIED |
정책의 현재 상태를 알 수 없습니다. 예약되어 있으므로 사용하지 마세요. |
API_PREVIEW |
정책이 아직 작동하지 않습니다. 이 단계는 API_CURRENT 또는 API_DEVELOPMENT 에게 이전할 수 있습니다. |
API_DEVELOPMENT |
정책이 아직 확정되지 않았으며 브레이킹 체인지가 적용될 수 있습니다. 이 단계는 API_CURRENT 또는 API_DEPRECATED 에게 이전할 수 있습니다. |
API_CURRENT |
정책은 공식적인 형식이지만 브레이킹 체인지가 아닌 변경사항이 도입될 수 있습니다. 이 단계는 API_DEPRECATED 님에게 이전할 수 있습니다. |
API_DEPRECATED |
이 정책은 지원 중단되었으며 향후 삭제될 수 있습니다. 관리자는 이 정책 사용을 중지해야 합니다. |
예 보기
{ "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" } }
정책 스키마 알림
일부 정책에는 acknowledgement_required
이(가) 있는 notices
이(가) 연결되어 있습니다.
특정 정책 필드의 특정 값에 대해 true
로 설정 이러한 정책의 경우
특수 확인 필드를 true
로 설정해야
값으로 사용됩니다.
자세한 내용은 코드 샘플을 참고하세요.
지원되는 플랫폼
supportedPlatforms
는 정책이 적용된다는 것을 나타내는 목록입니다.
이러한 플랫폼의 기기 또는 사용자에게
광고를 게재할 수 있습니다 지원되는 모든 플랫폼은
다음 표를 참조하세요.
지원되는 플랫폼
플랫폼 | 설명 |
---|---|
PLATFORM_UNSPECIFIED |
플랫폼이 지정되지 않았습니다. 예약되어 있으므로 사용하지 마세요. |
CHROME_OS |
ChromeOS |
CHROME_BROWSER |
macOS/Windows/Linux용 Chrome 브라우저 |
CHROME_BROWSER_FOR_ANDROID |
Android용 Chrome 브라우저 |
CHROME_BROWSER_FOR_IOS |
iOS용 Chrome 브라우저 |