Method: customers.policies.orgunits.batchInherit
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Modificar vários valores de política aplicados a uma unidade organizacional específica para que agora eles herdem o valor de uma organização mãe (se aplicável). Todos os destinos precisam ter o mesmo formato. Isso significa que elas precisam apontar para o mesmo recurso de destino e ter as mesmas chaves especificadas em additionalTargetKeyNames, embora os valores dessas chaves possam ser diferentes. Em caso de falha, a solicitação retornará os detalhes do erro como parte do google.rpc.Status.
Solicitação HTTP
POST https://chromepolicy.googleapis.com/v1/{customer=customers/*}/policies/orgunits:batchInherit
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
| Parâmetros |
customer |
string
ID da conta do G Suite ou literal "my_customer" para o cliente associado à solicitação.
|
Corpo da solicitação
O corpo da solicitação contém dados com a seguinte estrutura:
| Campos |
requests[] |
object (InheritOrgUnitPolicyRequest)
Lista de políticas que precisam herdar valores, conforme definido por requests. Todas as solicitações da lista precisam seguir estas restrições:
- Todos os esquemas da lista precisam ter o mesmo namespace raiz.
- Todos os valores de "policyTargetKey.targetResource" precisam apontar para uma unidade organizacional.
recurso.
- Todos os valores de "policyTargetKey" devem ter os mesmos nomes de chave no
" additionalTargetKeys". Isso também significa que, se um dos
os destinos têm um mapa "additionalTargetKeys" vazio, todos os
destinos precisam ter um mapa "additionalTargetKeys" vazio.
- Duas solicitações de modificação não podem fazer referência ao mesmo "policySchema" +
"policyTargetKey".
|
Corpo da resposta
Se a solicitação for concluída, o corpo da resposta estará vazio.
Escopos de autorização
Requer o seguinte escopo OAuth:
https://www.googleapis.com/auth/chrome.management.policy
InheritOrgUnitPolicyRequest
Parâmetros de solicitação para herdar o valor da política de um destino de unidade organizacional específica do valor da política da unidade organizacional mãe.
| Representação JSON |
{
"policyTargetKey": {
object (PolicyTargetKey)
},
"policySchema": string
} |
| Campos |
policyTargetKey |
object (PolicyTargetKey)
Obrigatório. A chave do destino para o qual queremos modificar uma política. O recurso de destino precisa apontar para uma unidade organizacional.
|
policySchema |
string
O nome totalmente qualificado do esquema de política que está sendo herdado.
|
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-25 UTC.
[null,null,["Última atualização 2025-07-25 UTC."],[[["\u003cp\u003eAllows modifying multiple policy values applied to a specific organizational unit to inherit from a parent.\u003c/p\u003e\n"],["\u003cp\u003eRequires all target resources to have the same format, including keys specified in \u003ccode\u003eadditionalTargetKeyNames\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eUses a \u003ccode\u003ePOST\u003c/code\u003e request to \u003ccode\u003ehttps://chromepolicy.googleapis.com/v1/{customer=customers/*}/policies/orgunits:batchInherit\u003c/code\u003e with necessary path and request body parameters.\u003c/p\u003e\n"],["\u003cp\u003eDemands authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/chrome.management.policy\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eReturns an empty response body upon successful execution, and error details within \u003ccode\u003egoogle.rpc.Status\u003c/code\u003e on failure.\u003c/p\u003e\n"]]],[],null,["# Method: customers.policies.orgunits.batchInherit\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- [InheritOrgUnitPolicyRequest](#InheritOrgUnitPolicyRequest)\n - [JSON representation](#InheritOrgUnitPolicyRequest.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nModify multiple policy values that are applied to a specific org unit so that they now inherit the value from a parent (if applicable). 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:batchInherit`\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/batchInherit#InheritOrgUnitPolicyRequest) } ] } ``` |\n\n| Fields ||\n|--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `requests[]` | `object (`[InheritOrgUnitPolicyRequest](/chrome/policy/reference/rest/v1/customers.policies.orgunits/batchInherit#InheritOrgUnitPolicyRequest)`)` List of policies that have to inherit their values 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\nInheritOrgUnitPolicyRequest\n---------------------------\n\nRequest parameters for inheriting policy value of a specific org unit target from the policy value of its parent org unit.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------|\n| ``` { \"policyTargetKey\": { object (/chrome/policy/reference/rest/v1/PolicyTargetKey) }, \"policySchema\": 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| `policySchema` | `string` The fully qualified name of the policy schema that is being inherited. |"]]
