Method: accounts.quotas.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يعرض هذا القسم الحصة اليومية للمكالمات ومعدل الاستخدام لكل مجموعة في حسابك على Merchant Center.
طلب HTTP
GET https://merchantapi.googleapis.com/quota/v1beta/{parent=accounts/*}/quotas
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
parent |
string
مطلوب. حساب التاجر الذي يملك مجموعة الحصص المخصّصة للطريقة. التنسيق: accounts/{account}
|
مَعلمات طلب البحث
| المعلمات |
pageSize |
integer
اختيارية: الحد الأقصى لعدد الحصص التي سيتم عرضها في الاستجابة، ويُستخدَم هذا العدد لعرض الصفحات. القيمة التلقائية هي 500، وسيتم تحويل القيم التي تزيد عن 1000 إلى 1000.
|
pageToken |
string
اختيارية: الرمز المميّز (إذا تم توفيره) لاسترداد الصفحة اللاحقة يجب أن تتطابق جميع المَعلمات الأخرى مع الطلب الأصلي الذي قدّم رمز تعريف الصفحة.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
رسالة الاستجابة لطريقة ListMethodGroups
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل JSON |
{
"quotaGroups": [
{
object (QuotaGroup)
}
],
"nextPageToken": string
} |
| الحقول |
quotaGroups[] |
object (QuotaGroup)
الطرق واستخدام الحصة الحالية والحدود لكل مجموعة تتم مشاركة الحصة بين جميع الطرق في المجموعة. يتم ترتيب المجموعات تنازليًا استنادًا إلى quotaUsage.
|
nextPageToken |
string
رمز مميّز يمكن إرساله على شكل pageToken لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.
|
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/content
لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة 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)."]]
