Method: customers.policies.groups.listGroupPriorityOrdering
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
بازیابی سفارش اولویت گروهی برای یک برنامه. برنامه هدف باید به additionalTargetKeyNames در PolicyTargetKey ارائه شود. در صورت شکست، درخواست جزئیات خطا را به عنوان بخشی از google.rpc.Status برمی گرداند.
درخواست HTTP
POST https://chromepolicy.googleapis.com/v1/{customer=customers/*}/policies/groups:listGroupPriorityOrdering
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها |
|---|
customer | string مورد نیاز. شناسه حساب Google Workspace یا «my_customer» برای مشتری مرتبط با درخواست. |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
| نمایندگی JSON |
|---|
{
"policyTargetKey": {
object (PolicyTargetKey)
},
"policyNamespace": string,
"policySchema": string
} |
| فیلدها |
|---|
policyTargetKey | object ( PolicyTargetKey ) مورد نیاز. کلید هدفی که می خواهیم ترتیب اولویت گروهی را برای آن بازیابی کنیم. منبع هدف باید به یک برنامه اشاره کند. |
policyNamespace | string فضای نام نوع خط مشی برای درخواست. |
policySchema | string نام طرح خط مشی برای درخواست. |
بدن پاسخگو
پیام پاسخ برای فهرست بندی ترتیب اولویت گروهی یک برنامه.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
| نمایندگی JSON |
|---|
{
"policyTargetKey": {
object (PolicyTargetKey)
},
"policyNamespace": string,
"policySchema": string,
"groupIds": [
string
]
} |
| فیلدها |
|---|
policyTargetKey | object ( PolicyTargetKey ) فقط خروجی منبع هدفی که ترتیب اولویت گروهی برای آن بازیابی شده است. |
policyNamespace | string فقط خروجی فضای نام نوع خط مشی شناسه های گروه. |
policySchema | string فقط خروجی نام طرح خط مشی برای شناسه های گروه. |
groupIds[] | string فقط خروجی شناسه های گروه به ترتیب اولویت. |
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/chrome.management.policy.readonly -
https://www.googleapis.com/auth/chrome.management.policy
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\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`"]]
