---
title: "POST /v1/customers/{customersId}/policies/groups:listGroupPriorityOrdering"
method: POST
path: "/v1/customers/{customersId}/policies/groups:listGroupPriorityOrdering"
tags: ["customers"]
---

# POST /v1/customers/{customersId}/policies/groups:listGroupPriorityOrdering

`POST /v1/customers/{customersId}/policies/groups:listGroupPriorityOrdering`

## Request

- Base URL: `https://chromepolicy.googleapis.com`
- URL: `https://chromepolicy.googleapis.com/v1/customers/{customersId}/policies/groups:listGroupPriorityOrdering`
- Auth: one of:
  - OAuth 2 and OAuth 2
    - Implicit: `https://accounts.google.com/o/oauth2/auth`
    - Scopes: `https://www.googleapis.com/auth/chrome.management.policy`
    - Authorization code: `https://accounts.google.com/o/oauth2/auth`
    - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/chrome.management.policy`
  - OAuth 2 and OAuth 2
    - Implicit: `https://accounts.google.com/o/oauth2/auth`
    - Scopes: `https://www.googleapis.com/auth/chrome.management.policy.readonly`
    - Authorization code: `https://accounts.google.com/o/oauth2/auth`
    - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/chrome.management.policy.readonly`
- TypeScript: <https://skmtc.dev/google/apis/chromepolicy/docs/v1/customers/:customersId/policies/groups:listGroupPriorityOrdering/post.ts> (a function with typed inputs; its response is checked against the schema)

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.

## Path parameters

- `customersId` string, required

## Request body

- GoogleChromePolicyVersionsV1ListGroupPriorityOrderingRequest: Request message for listing the group priority ordering of an app.
  - `policyNamespace` string: The namespace of the policy type for the request.
  - `policySchema` string: The schema name of the policy for the request.
  - `policyTargetKey` GoogleChromePolicyVersionsV1PolicyTargetKey: The key used to identify the target on which the policy will be applied.
    - `additionalTargetKeys` object: Map containing the additional target key name and value pairs used to further identify the target of the policy.
    - `targetResource` string: The target resource on which this policy is applied. The following resources are supported: * Organizational Unit ("orgunits/{orgunit_id}") * Group ("groups/{group_id}")

## Response `200`

Successful response

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

---

[API](https://skmtc.dev/google/apis/chromepolicy.md) - [All operations](https://skmtc.dev/google/apis/chromepolicy/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/chromepolicy/revisions/c9f2e6e8732d?raw)
