# Chrome Policy API . customers . policies . groups

## Instance Methods

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.

Modify 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.

Close httplib2 connections.

Retrieve a group priority ordering for an app. The target app must be supplied in `additionalTargetKeyNames` in the PolicyTargetKey. On failure the request will return the error details as part of the google.rpc.Status.

Update a group priority ordering for an app. The target app must be supplied in `additionalTargetKeyNames` in the PolicyTargetKey. On failure the request will return the error details as part of the google.rpc.Status.

### Method Details

`batchDelete(customer, body=None, x__xgafv=None)`

    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.

    Args:
      customer: string, ID of the Google Workspace account or literal "my_customer" for the customer associated to the request. (required)
      body: object, The request body.
        The object takes the form of:

    { # Request message for specifying that multiple policy values will be deleted.
      "requests": [ # 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 `app_id` key name in the `additionalTargetKeys`. 4. No two modification requests can reference the same `policySchema` + ` policyTargetKey` pair.
        { # Request parameters for deleting the policy value of a specific group target.
          "policySchema": "A String", # The fully qualified name of the policy schema that is being inherited.
          "policyTargetKey": { # The key used to identify the target on which the policy will be applied. # Required. The key of the target for which we want to modify a policy. The target resource must point to a Group.
            "additionalTargetKeys": { # Map containing the additional target key name and value pairs used to further identify the target of the policy.
              "a_key": "A String",
            },
            "targetResource": "A String", # The target resource on which this policy is applied. The following resources are supported: * Organizational Unit ("orgunits/{orgunit_id}") * Group ("groups/{group_id}")
          },
        },
      ],
    }

      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }
    }

`batchModify(customer, body=None, x__xgafv=None)`

    Modify 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.

    Args:
      customer: string, ID of the Google Workspace account or literal "my_customer" for the customer associated to the request. (required)
      body: object, The request body.
        The object takes the form of:

    { # Request message for modifying multiple policy values for a specific group-based target.
      "requests": [ # 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 a group resource. 3. All `policyTargetKey` values must have the same `app_id` key name in the `additionalTargetKeys`. 4. No two modification requests can reference the same `policySchema` + ` policyTargetKey` pair.
        { # Request parameters for modifying a policy value for a specific group target.
          "policyTargetKey": { # The key used to identify the target on which the policy will be applied. # Required. The key of the target for which we want to modify a policy. The target resource must point to a Group.
            "additionalTargetKeys": { # Map containing the additional target key name and value pairs used to further identify the target of the policy.
              "a_key": "A String",
            },
            "targetResource": "A String", # The target resource on which this policy is applied. The following resources are supported: * Organizational Unit ("orgunits/{orgunit_id}") * Group ("groups/{group_id}")
          },
          "policyValue": { # A particular value for a policy managed by the service. # The new value for the policy.
            "policySchema": "A String", # The fully qualified name of the policy schema associated with this policy.
            "value": { # The value of the policy that is compatible with the schema that it is associated with.
              "a_key": "", # Properties of the object.
            },
          },
          "updateMask": "A String", # Required. Policy fields to update. Only fields in this mask will be updated; other fields in `policy_value` will be ignored (even if they have values). If a field is in this list it must have a value in 'policy_value'.
        },
      ],
    }

      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }
    }

`close()`

    Close httplib2 connections.

`listGroupPriorityOrdering(customer, body=None, x__xgafv=None)`

    Retrieve a group priority ordering for an app. The target app must be supplied in `additionalTargetKeyNames` in the PolicyTargetKey. On failure the request will return the error details as part of the google.rpc.Status.

    Args:
      customer: string, Required. ID of the Google Workspace account or literal "my_customer" for the customer associated to the request. (required)
      body: object, The request body.
        The object takes the form of:

    { # Request message for listing the group priority ordering of an app.
      "policyNamespace": "A String", # Required. The namespace of the policy type for the request.
      "policyTargetKey": { # The key used to identify the target on which the policy will be applied. # Required. The key of the target for which we want to retrieve the group priority ordering. The target resource must point to an app.
        "additionalTargetKeys": { # Map containing the additional target key name and value pairs used to further identify the target of the policy.
          "a_key": "A String",
        },
        "targetResource": "A String", # The target resource on which this policy is applied. The following resources are supported: * Organizational Unit ("orgunits/{orgunit_id}") * Group ("groups/{group_id}")
      },
    }

      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # Response message for listing the group priority ordering of an app.
      "groupIds": [ # Output only. The group IDs, in priority ordering.
        "A String",
      ],
      "policyNamespace": "A String", # Output only. The namespace of the policy type of the group IDs.
      "policyTargetKey": { # The key used to identify the target on which the policy will be applied. # Output only. The target resource for which the group priority ordering has been retrieved.
        "additionalTargetKeys": { # Map containing the additional target key name and value pairs used to further identify the target of the policy.
          "a_key": "A String",
        },
        "targetResource": "A String", # The target resource on which this policy is applied. The following resources are supported: * Organizational Unit ("orgunits/{orgunit_id}") * Group ("groups/{group_id}")
      },
    }

`updateGroupPriorityOrdering(customer, body=None, x__xgafv=None)`

    Update a group priority ordering for an app. The target app must be supplied in `additionalTargetKeyNames` in the PolicyTargetKey. On failure the request will return the error details as part of the google.rpc.Status.

    Args:
      customer: string, Required. ID of the Google Workspace account or literal "my_customer" for the customer associated to the request. (required)
      body: object, The request body.
        The object takes the form of:

    { # Request message for updating the group priority ordering of an app.
      "groupIds": [ # Required. The group IDs, in desired priority ordering.
        "A String",
      ],
      "policyNamespace": "A String", # Required. The namespace of the policy type for the request.
      "policyTargetKey": { # The key used to identify the target on which the policy will be applied. # Required. The key of the target for which we want to update the group priority ordering. The target resource must point to an app.
        "additionalTargetKeys": { # Map containing the additional target key name and value pairs used to further identify the target of the policy.
          "a_key": "A String",
        },
        "targetResource": "A String", # The target resource on which this policy is applied. The following resources are supported: * Organizational Unit ("orgunits/{orgunit_id}") * Group ("groups/{group_id}")
      },
    }

      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }
    }