Method: customers.policies.orgunits.batchModify
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
특정 조직 단위에 적용되는 여러 정책 값을 수정합니다. 모든 타겟은 타겟 형식이 동일해야 합니다. 즉, 동일한 타겟 리소스를 가리켜야 하고 additionalTargetKeyNames에 지정된 동일한 키를 보유해야 하지만 키의 값은 다를 수 있습니다. 실패 시 요청은 google.rpc.Status의 일부로 오류 세부정보를 반환합니다.
HTTP 요청
POST https://chromepolicy.googleapis.com/v1/{customer=customers/*}/policies/orgunits:batchModify
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
| 매개변수 |
customer |
string
G Suite 계정의 ID 또는 문자 그대로의 'my_customer'입니다. '요청'과 관련된 고객 ID입니다.
|
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
| 필드 |
requests[] |
object (ModifyOrgUnitPolicyRequest)
requests에서 정의한 대로 수정할 정책 목록입니다. 목록의 모든 요청은 다음 제한사항을 따라야 합니다.
- 목록의 모든 스키마는 루트 네임스페이스가 동일해야 합니다.
- 모든 'policyTargetKey.targetResource' 값이 조직 단위를 가리켜야 합니다.
리소스도 제공합니다
- 모든 `policyTargetKey` 값은
` additionalTargetKeys`로 설정합니다. 또한 이는
타겟에 빈 `additionalTargetKeys` 맵이 있고,
대상에는 빈 `additionalTargetKeys` 맵이 있어야 합니다.
- 두 개의 수정 요청은 동일한 `policySchema` +
` policyTargetKey` 쌍입니다.
|
응답 본문
성공한 경우 응답 본문은 비어 있습니다.
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/chrome.management.policy
ModifyOrgUnitPolicyRequest
특정 조직 단위 대상의 정책 값을 수정하기 위한 요청 매개변수입니다.
| 필드 |
policyTargetKey |
object (PolicyTargetKey)
필수 항목입니다. 정책을 수정할 대상의 키입니다. 대상 리소스가 조직 단위를 가리켜야 합니다.
|
policyValue |
object (PolicyValue)
정책의 새 값입니다.
|
updateMask |
string (FieldMask format)
필수 항목입니다. 업데이트할 정책 필드입니다. 이 마스크의 필드만 업데이트됩니다. policyValue의 다른 필드는 값이 있는 경우에도 무시됩니다. 이 목록에 있는 필드는 'policyValue'에 값이 있어야 합니다. 정규화된 필드 이름의 쉼표로 구분된 목록입니다. 예: "user.displayName,photo"
|
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003eModify multiple policies applied to a specific organizational unit using the \u003ccode\u003ebatchModify\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eAll policy modification requests within a single batch operation must adhere to specific schema, target resource, and key restrictions.\u003c/p\u003e\n"],["\u003cp\u003eThe request body structure includes a list of \u003ccode\u003eModifyOrgUnitPolicyRequest\u003c/code\u003e objects, each defining the policy target, desired value, and fields to update.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful requests result in an empty response body, while failures return error details in the \u003ccode\u003egoogle.rpc.Status\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/chrome.management.policy\u003c/code\u003e scope.\u003c/p\u003e\n"]]],[],null,["# Method: customers.policies.orgunits.batchModify\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [ModifyOrgUnitPolicyRequest](#ModifyOrgUnitPolicyRequest)\n - [JSON representation](#ModifyOrgUnitPolicyRequest.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nModify multiple policy values that are applied to a specific org unit. All targets must have the same target format. That is to say that they must point to the same target resource and must have the same keys specified in `additionalTargetKeyNames`, though the values for those keys may be different. On failure the request will return the error details as part of the google.rpc.Status.\n\n### HTTP request\n\n`POST https://chromepolicy.googleapis.com/v1/{customer=customers/*}/policies/orgunits:batchModify`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------|---------------------------------------------------------------------------------------------------------|\n| `customer` | `string` ID of the G Suite account or literal \"my_customer\" for the customer associated to the request. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"requests\": [ { object (/chrome/policy/reference/rest/v1/customers.policies.orgunits/batchModify#ModifyOrgUnitPolicyRequest) } ] } ``` |\n\n| Fields ||\n|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `requests[]` | `object (`[ModifyOrgUnitPolicyRequest](/chrome/policy/reference/rest/v1/customers.policies.orgunits/batchModify#ModifyOrgUnitPolicyRequest)`)` List of policies to modify as defined by the `requests`. All requests in the list must follow these restrictions: 1. All schemas in the list must have the same root namespace. 2. All \\`policyTargetKey.targetResource\\` values must point to an org unit resource. 3. All \\`policyTargetKey\\` values must have the same key names in the \\` additionalTargetKeys\\`. This also means if one of the targets has an empty \\`additionalTargetKeys\\` map, all of the targets must have an empty \\`additionalTargetKeys\\` map. 4. No two modification requests can reference the same \\`policySchema\\` + \\` policyTargetKey\\` pair. |\n\n### Response body\n\nIf successful, the response body is empty.\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/chrome.management.policy`\n\nModifyOrgUnitPolicyRequest\n--------------------------\n\nRequest parameters for modifying a policy value for a specific org unit target.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"policyTargetKey\": { object (/chrome/policy/reference/rest/v1/PolicyTargetKey) }, \"policyValue\": { object (/chrome/policy/reference/rest/v1/PolicyValue) }, \"updateMask\": string } ``` |\n\n| Fields ||\n|-------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `policyTargetKey` | `object (`[PolicyTargetKey](/chrome/policy/reference/rest/v1/PolicyTargetKey)`)` Required. The key of the target for which we want to modify a policy. The target resource must point to an Org Unit. |\n| `policyValue` | `object (`[PolicyValue](/chrome/policy/reference/rest/v1/PolicyValue)`)` The new value for the policy. |\n| `updateMask` | `string (`[FieldMask](https://protobuf.dev/reference/protobuf/google.protobuf/#field-mask)` format)` Required. Policy fields to update. Only fields in this mask will be updated; other fields in `policyValue` will be ignored (even if they have values). If a field is in this list it must have a value in 'policyValue'. This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |"]]
