Method: customers.policies.groups.listGroupPriorityOrdering
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Truy xuất thứ tự ưu tiên nhóm cho ứng dụng. Ứng dụng mục tiêu phải được cung cấp trong additionalTargetKeyNames theo PolicyTargetKey. Khi không thành công, yêu cầu sẽ trả về thông tin chi tiết về lỗi như một phần của google.rpc.Status.
Yêu cầu HTTP
POST https://chromepolicy.googleapis.com/v1/{customer=customers/*}/policies/groups:listGroupPriorityOrdering
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
| Tham số |
customer |
string
Bắt buộc. Mã tài khoản Google Workspace hoặc giá trị cố định "my_customer" cho khách hàng có liên quan đến yêu cầu.
|
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:
| Biểu diễn dưới dạng JSON |
{
"policyTargetKey": {
object (PolicyTargetKey)
},
"policyNamespace": string,
"policySchema": string
} |
| Trường |
policyTargetKey |
object (PolicyTargetKey)
Bắt buộc. Khoá của mục tiêu mà chúng ta muốn truy xuất thứ tự ưu tiên của nhóm. Tài nguyên mục tiêu phải trỏ đến một ứng dụng.
|
policyNamespace |
string
Không gian tên của loại chính sách cho yêu cầu.
|
policySchema |
string
Tên giản đồ của chính sách cho yêu cầu.
|
Nội dung phản hồi
Thông báo phản hồi để liệt kê thứ tự ưu tiên theo nhóm của một ứng dụng.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
| Biểu diễn dưới dạng JSON |
{
"policyTargetKey": {
object (PolicyTargetKey)
},
"policyNamespace": string,
"policySchema": string,
"groupIds": [
string
]
} |
| Trường |
policyTargetKey |
object (PolicyTargetKey)
Chỉ có đầu ra. Tài nguyên mục tiêu mà thứ tự ưu tiên của nhóm được truy xuất.
|
policyNamespace |
string
Chỉ có đầu ra. Không gian tên cho loại chính sách của mã nhóm.
|
policySchema |
string
Chỉ có đầu ra. Tên giản đồ của chính sách cho các mã nhóm.
|
groupIds[] |
string
Chỉ có đầu ra. Các mã nhóm, theo thứ tự ưu tiên.
|
Phạm vi uỷ quyền
Yêu cầu một trong các phạm vi OAuth sau:
https://www.googleapis.com/auth/chrome.management.policy.readonlyhttps://www.googleapis.com/auth/chrome.management.policy
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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`"]]
