Method: accounts.quotas.list
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.
Liệt kê hạn mức cuộc gọi hằng ngày và mức sử dụng theo nhóm cho tài khoản Merchant Center của bạn.
Yêu cầu HTTP
GET https://merchantapi.googleapis.com/quota/v1beta/{parent=accounts/*}/quotas
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Thông số |
parent |
string
Bắt buộc. Tài khoản người bán sở hữu tập hợp hạn mức phương thức Định dạng: accounts/{account}
|
Tham số truy vấn
Thông số |
pageSize |
integer
Không bắt buộc. Số lượng hạn mức tối đa cần trả về trong phản hồi, dùng để phân trang. Mặc định là 500; các giá trị trên 1000 sẽ được ép thành 1000.
|
pageToken |
string
Không bắt buộc. Mã thông báo (nếu có) để truy xuất trang tiếp theo. Tất cả các thông số khác phải khớp với lệnh gọi ban đầu đã cung cấp mã thông báo trang.
|
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
Thông báo phản hồi cho phương thức ListMethodGroups.
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 |
{
"quotaGroups": [
{
object (QuotaGroup )
}
],
"nextPageToken": string
} |
Trường |
quotaGroups[] |
object (QuotaGroup )
Phương thức, mức sử dụng hạn mức hiện tại và giới hạn cho mỗi nhóm. Hạn mức được chia sẻ giữa tất cả các phương thức trong nhóm. Các nhóm được sắp xếp theo thứ tự giảm dần dựa trên quotaUsage .
|
nextPageToken |
string
Mã thông báo có thể được gửi dưới dạng pageToken để truy xuất trang tiếp theo. Nếu bạn bỏ qua trường này, thì sẽ không có trang tiếp theo.
|
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/content
Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.
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-01-23 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-01-23 UTC."],[[["\u003cp\u003eLists the daily call quota and usage per group for a given Merchant Center account.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/content\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eUses a \u003ccode\u003eGET\u003c/code\u003e request to the \u003ccode\u003ehttps://merchantapi.googleapis.com/quota/v1beta/{parent=accounts/*}/quotas\u003c/code\u003e endpoint.\u003c/p\u003e\n"],["\u003cp\u003eAccepts optional query parameters for pagination: \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eReturns a response body containing quota groups, their usage, and a token for retrieving subsequent pages.\u003c/p\u003e\n"]]],["This document outlines how to retrieve daily call quota and usage per group for a Merchant Center account using the `GET` request: `https://merchantapi.googleapis.com/quota/v1beta/{parent=accounts/*}/quotas`. The `parent` path parameter specifies the account. Optional query parameters `pageSize` (default 500, max 1000) and `pageToken` handle pagination. The request body must be empty. The response, formatted as JSON, includes `quotaGroups` with usage data and `nextPageToken` for further pages. Authorization requires the `https://www.googleapis.com/auth/content` OAuth scope.\n"],null,["# Method: accounts.quotas.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListQuotaGroupsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists the daily call quota and usage per group for your Merchant Center account.\n\n### HTTP request\n\n`GET https://merchantapi.googleapis.com/quota/v1beta/{parent=accounts/*}/quotas`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The merchant account who owns the collection of method quotas Format: accounts/{account} |\n\n### Query parameters\n\n| Parameters ||\n|-------------|----------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` Optional. The maximum number of quotas to return in the response, used for paging. Defaults to 500; values above 1000 will be coerced to 1000. |\n| `pageToken` | `string` Optional. Token (if provided) to retrieve the subsequent page. All other parameters must match the original call that provided the page token. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for the ListMethodGroups method.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"quotaGroups\": [ { object (/merchant/api/reference/rest/quota_v1beta/accounts.quotas#QuotaGroup) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `quotaGroups[]` | `object (`[QuotaGroup](/merchant/api/reference/rest/quota_v1beta/accounts.quotas#QuotaGroup)`)` The methods, current quota usage and limits per each group. The quota is shared between all methods in the group. The groups are sorted in descending order based on [quotaUsage](/merchant/api/reference/rest/quota_v1beta/accounts.quotas#QuotaGroup.FIELDS.quota_usage). |\n| `nextPageToken` | `string` A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted, there are no subsequent pages. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/content`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]