Method: customers.policies.groups.batchDelete

  • This document outlines how to delete multiple policy values applied to a specific group using a batch delete operation.

  • All targets within a batch delete request must have the same target format, pointing to the same target resource and having consistent key names in additionalTargetKeyNames.

  • The request uses an HTTP POST method to the specified URL with the customer ID in the path parameters.

  • The request body includes a list of DeleteGroupPolicyRequest objects, each specifying the policyTargetKey and policySchema for the policy to be deleted.

  • A successful response to the batch delete operation is empty.

Delete multiple policy values that are applied to a specific group. 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.

HTTP request

POST https://chromepolicy.googleapis.com/v1/{customer=customers/*}/policies/groups:batchDelete

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
customer

string

ID of the Google Workspace account or literal "my_customer" for the customer associated to the request.

Request body

The request body contains data with the following structure:

JSON representation 
{
  "requests": [
    {
      object (DeleteGroupPolicyRequest)
    }
  ]
}
Fields
requests[]

object (DeleteGroupPolicyRequest)

List of policies that will be deleted 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 a group resource.
  3. All `policyTargetKey` values must have the same `appId` key name in the `additionalTargetKeys`.
  4. No two modification requests can reference the same `policySchema` + ` policyTargetKey` pair.

Response body

If successful, the response body is empty.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/chrome.management.policy

DeleteGroupPolicyRequest

Request parameters for deleting the policy value of a specific group target.

JSON representation 
{
  "policyTargetKey": {
    object (PolicyTargetKey)
  },
  "policySchema": string
}
Fields
policyTargetKey

object (PolicyTargetKey)

Required. The key of the target for which we want to modify a policy. The target resource must point to a group.
policySchema

string

The fully qualified name of the policy schema that is being inherited.