Method: customers.policies.groups.listGroupPriorityOrdering
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Récupérer un ordre de priorité de groupe pour une application L'application cible doit être fournie dans additionalTargetKeyNames dans PolicyTargetKey. En cas d'échec, la requête renvoie les détails de l'erreur dans le champ google.rpc.Status.
Requête HTTP
POST https://chromepolicy.googleapis.com/v1/{customer=customers/*}/policies/groups:listGroupPriorityOrdering
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
| Paramètres |
customer |
string
Obligatoire. ID du compte Google Workspace ou littéral "my_customer" pour le client associé à la demande.
|
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
| Représentation JSON |
{
"policyTargetKey": {
object (PolicyTargetKey)
},
"policyNamespace": string,
"policySchema": string
} |
| Champs |
policyTargetKey |
object (PolicyTargetKey)
Obligatoire. Clé de la cible pour laquelle nous voulons récupérer l'ordre de priorité du groupe. La ressource cible doit pointer vers une application.
|
policyNamespace |
string
Espace de noms du type de règle pour la requête.
|
policySchema |
string
Nom de schéma de la stratégie pour la requête.
|
Corps de la réponse
Message de réponse pour lister l'ordre de priorité des groupes d'une application.
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
| Représentation JSON |
{
"policyTargetKey": {
object (PolicyTargetKey)
},
"policyNamespace": string,
"policySchema": string,
"groupIds": [
string
]
} |
| Champs |
policyTargetKey |
object (PolicyTargetKey)
Uniquement en sortie. Ressource cible pour laquelle l'ordre de priorité du groupe a été récupéré.
|
policyNamespace |
string
Uniquement en sortie. Espace de noms du type de règle des ID de groupe.
|
policySchema |
string
Uniquement en sortie. Nom de schéma de la stratégie pour les ID de groupe.
|
groupIds[] |
string
Uniquement en sortie. ID des groupes, par ordre de priorité.
|
Champs d'application des autorisations
Nécessite l'un des champs d'application OAuth suivants :
https://www.googleapis.com/auth/chrome.management.policy.readonlyhttps://www.googleapis.com/auth/chrome.management.policy
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 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`"]]
