Method: customers.policies.groups.listGroupPriorityOrdering
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Recupera un orden de prioridad de grupo para una app. La app de destino debe suministrarse en additionalTargetKeyNames en PolicyTargetKey. En caso de error, la solicitud devolverá los detalles del error como parte de google.rpc.Status.
Solicitud HTTP
POST https://chromepolicy.googleapis.com/v1/{customer=customers/*}/policies/groups:listGroupPriorityOrdering
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
| Parámetros |
customer |
string
Obligatorio. ID de la cuenta de Google Workspace o literal de “my_customer” para el cliente asociado a la solicitud.
|
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
| Representación JSON |
{
"policyTargetKey": {
object (PolicyTargetKey)
},
"policyNamespace": string,
"policySchema": string
} |
| Campos |
policyTargetKey |
object (PolicyTargetKey)
Obligatorio. La clave del destino para el que queremos recuperar el orden de prioridad de grupo. El recurso de destino debe apuntar a una app.
|
policyNamespace |
string
El espacio de nombres del tipo de política para la solicitud.
|
policySchema |
string
El nombre del esquema de la política para la solicitud.
|
Cuerpo de la respuesta
Mensaje de respuesta para enumerar el orden de prioridad de grupo de una app.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
| Representación JSON |
{
"policyTargetKey": {
object (PolicyTargetKey)
},
"policyNamespace": string,
"policySchema": string,
"groupIds": [
string
]
} |
| Campos |
policyTargetKey |
object (PolicyTargetKey)
Solo salida. El recurso de destino para el que se recuperó el orden de prioridad del grupo.
|
policyNamespace |
string
Solo salida. El espacio de nombres del tipo de política de los IDs de grupo.
|
policySchema |
string
Solo salida. El nombre de esquema de la política para los IDs de grupo.
|
groupIds[] |
string
Solo salida. Los IDs de los grupos, en orden de prioridad.
|
Alcances de autorización
Se necesita uno de los siguientes permisos de OAuth:
https://www.googleapis.com/auth/chrome.management.policy.readonlyhttps://www.googleapis.com/auth/chrome.management.policy
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 2025-07-25 (UTC)"],[[["\u003cp\u003eRetrieve the group priority ordering for an app within a Google Workspace account using this API endpoint.\u003c/p\u003e\n"],["\u003cp\u003eThe request body requires specifying the target app, policy namespace, and policy schema.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful responses provide the target resource, policy details, and a list of group IDs in priority order.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires specific OAuth scopes for Chrome management policies.\u003c/p\u003e\n"]]],[],null,["# Method: customers.policies.groups.listGroupPriorityOrdering\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 - [JSON representation](#body.ListGroupPriorityOrderingResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nRetrieve 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.\n\n### HTTP request\n\n`POST https://chromepolicy.googleapis.com/v1/{customer=customers/*}/policies/groups:listGroupPriorityOrdering`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------|----------------------------------------------------------------------------------------------------------------------------|\n| `customer` | `string` Required. ID of the Google Workspace 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| ``` { \"policyTargetKey\": { object (/chrome/policy/reference/rest/v1/PolicyTargetKey) }, \"policyNamespace\": string, \"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 retrieve the group priority ordering. The target resource must point to an app. |\n| `policyNamespace` | `string` The namespace of the policy type for the request. |\n| `policySchema` | `string` The schema name of the policy for the request. |\n\n### Response body\n\nResponse message for listing the group priority ordering of an app.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"policyTargetKey\": { object (/chrome/policy/reference/rest/v1/PolicyTargetKey) }, \"policyNamespace\": string, \"policySchema\": string, \"groupIds\": [ string ] } ``` |\n\n| Fields ||\n|-------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `policyTargetKey` | `object (`[PolicyTargetKey](/chrome/policy/reference/rest/v1/PolicyTargetKey)`)` Output only. The target resource for which the group priority ordering has been retrieved. |\n| `policyNamespace` | `string` Output only. The namespace of the policy type of the group IDs. |\n| `policySchema` | `string` Output only. The schema name of the policy for the group IDs. |\n| `groupIds[]` | `string` Output only. The group IDs, in priority ordering. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/chrome.management.policy.readonly`\n- `https://www.googleapis.com/auth/chrome.management.policy`"]]
