Method: accounts.quotas.list
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
سهمیه تماس روزانه و استفاده در هر گروه را برای حساب Merchant Center شما فهرست می کند.
درخواست HTTP
GET https://merchantapi.googleapis.com/quota/v1beta/{parent=accounts/*}/quotas
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها |
|---|
parent | string مورد نیاز. حساب تاجری که مجموعه سهمیه‌های روش را در اختیار دارد قالب: حساب‌ها/{حساب} |
پارامترهای پرس و جو
| پارامترها |
|---|
page Size | integer اختیاری. حداکثر تعداد سهمیه برای بازگشت در پاسخ، استفاده شده برای صفحه بندی. پیش فرض تا 500; مقادیر بالای 1000 به 1000 اجباری می شود. |
page Token | string اختیاری. رمز (در صورت ارائه) برای بازیابی صفحه بعدی. همه پارامترهای دیگر باید با فراخوانی اصلی که توکن صفحه را ارائه کرده است، مطابقت داشته باشند. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
پیام پاسخ برای متد ListMethodGroups.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
| نمایندگی JSON |
|---|
{
"quotaGroups": [
{
object (QuotaGroup)
}
],
"nextPageToken": string
} |
| فیلدها |
|---|
quota Groups[] | object ( QuotaGroup ) روش‌ها، استفاده از سهمیه فعلی و محدودیت‌های هر گروه. سهمیه بین همه روش های گروه به اشتراک گذاشته می شود. گروه ها بر اساس quotaUsage به ترتیب نزولی مرتب شده اند. |
next Page Token | string یک نشانه، که می تواند به عنوان pageToken برای بازیابی صفحه بعدی ارسال شود. اگر این قسمت حذف شود، هیچ صفحه بعدی وجود ندارد. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/content
برای اطلاعات بیشتر، بهOAuth 2.0 Overview .
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-01-23 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-01-23 بهوقت ساعت هماهنگ جهانی."],[[["\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)."]]
