مطلوب. حساب التاجر الذي يملك مجموعة الحصص المخصّصة للطريقة. التنسيق: accounts/{account}
page_size
int32
اختيارية: الحد الأقصى لعدد الحصص التي سيتم عرضها في الاستجابة، ويُستخدَم هذا العدد لعرض الصفحات. القيمة التلقائية هي 500، وسيتم تحويل القيم التي تزيد عن 1000 إلى 1000.
page_token
string
اختيارية: الرمز المميّز (إذا تم توفيره) لاسترداد الصفحة اللاحقة يجب أن تتطابق جميع المَعلمات الأخرى مع الطلب الأصلي الذي قدّم رمز تعريف الصفحة.
الطرق واستخدام الحصة الحالية والحدود لكل مجموعة تتم مشاركة الحصة بين جميع الطرق في المجموعة. يتم ترتيب المجموعات تنازليًا استنادًا إلى quota_usage.
next_page_token
string
رمز مميّز يمكن إرساله على شكل page_token لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.
MethodDetails
تفاصيل الطريقة لكل طريقة في Merchant API
الحقول
method
string
النتائج فقط. اسم الطريقة، على سبيل المثال products.list.
version
string
النتائج فقط. إصدار واجهة برمجة التطبيقات التي تنتمي إليها الطريقة.
subapi
string
النتائج فقط. واجهة برمجة التطبيقات الفرعية التي تنتمي إليها الطريقة
path
string
النتائج فقط. مسار الطريقة، مثل products/v1/productInputs.insert
QuotaGroup
معلومات المجموعة للطُرق في Merchant API تتم مشاركة الحصة بين جميع الطرق في المجموعة. يتم عرض معلومات المجموعة حتى إذا لم يتم استخدام أيّ من الطرق ضمن المجموعة.
الحقول
name
string
المعرّف اسم المورد لمجموعة الحصة التنسيق: accounts/{account}/quotas/{group} ملاحظة: لا يمكن ضمان تنسيق {group}.
quota_usage
int64
النتائج فقط. استخدام الحصة الحالية، أي عدد المكالمات التي تم إجراؤها في يوم معيّن إلى الطرق في المجموعة. تتم إعادة ضبط حدود الحصة اليومية في الساعة 12:00 ظهرًا بالتوقيت العالمي المنسّق.
quota_limit
int64
النتائج فقط. الحد الأقصى لعدد المكالمات المسموح به في اليوم للمجموعة
quota_minute_limit
int64
النتائج فقط. الحد الأقصى لعدد المكالمات المسموح به في الدقيقة للمجموعة.
تاريخ التعديل الأخير: 2025-01-23 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-01-23 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe QuotaService API allows you to retrieve method call quota information for your Merchant Center account.\u003c/p\u003e\n"],["\u003cp\u003eYou can use the \u003ccode\u003eListQuotaGroups\u003c/code\u003e method to view the daily call quota and usage for each method group, including details such as quota limits and usage.\u003c/p\u003e\n"],["\u003cp\u003eQuotaGroups represent a collection of methods with shared quota, providing insights into the maximum number of calls allowed per day and per minute for those methods.\u003c/p\u003e\n"],["\u003cp\u003eMethodDetails provide specific information about each method within a QuotaGroup, including its name, API version, sub-API, and path.\u003c/p\u003e\n"],["\u003cp\u003eThe provided API endpoints and message structures enable developers to programmatically manage and monitor quota usage within their Merchant Center integrations.\u003c/p\u003e\n"]]],["The `QuotaService` allows retrieval of daily call quota and usage for Merchant Center accounts via the `ListQuotaGroups` method. This method requires the `content` OAuth scope. The `ListQuotaGroupsRequest` specifies the target merchant account, page size, and token. The response, `ListQuotaGroupsResponse`, includes an array of `QuotaGroup` objects detailing quota usage, limits per day and per minute, and associated `MethodDetails`. Each group represents a set of related methods.\n"],null,["# Package google.shopping.merchant.quota.v1beta\n\nIndex\n-----\n\n- [QuotaService](/merchant/api/reference/rpc/google.shopping.merchant.quota.v1beta#google.shopping.merchant.quota.v1beta.QuotaService) (interface)\n- [ListQuotaGroupsRequest](/merchant/api/reference/rpc/google.shopping.merchant.quota.v1beta#google.shopping.merchant.quota.v1beta.ListQuotaGroupsRequest) (message)\n- [ListQuotaGroupsResponse](/merchant/api/reference/rpc/google.shopping.merchant.quota.v1beta#google.shopping.merchant.quota.v1beta.ListQuotaGroupsResponse) (message)\n- [MethodDetails](/merchant/api/reference/rpc/google.shopping.merchant.quota.v1beta#google.shopping.merchant.quota.v1beta.MethodDetails) (message)\n- [QuotaGroup](/merchant/api/reference/rpc/google.shopping.merchant.quota.v1beta#google.shopping.merchant.quota.v1beta.QuotaGroup) (message)\n\nQuotaService\n------------\n\nService to get method call quota information per Merchant API method.\n\n| ListQuotaGroups |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ` rpc ListQuotaGroups(`[ListQuotaGroupsRequest](/merchant/api/reference/rpc/google.shopping.merchant.quota.v1beta#google.shopping.merchant.quota.v1beta.ListQuotaGroupsRequest)`) returns (`[ListQuotaGroupsResponse](/merchant/api/reference/rpc/google.shopping.merchant.quota.v1beta#google.shopping.merchant.quota.v1beta.ListQuotaGroupsResponse)`) ` Lists the daily call quota and usage per group for your Merchant Center account. Authorization scopes : Requires the following OAuth scope: - `https://www.googleapis.com/auth/content` For more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2). |\n\nListQuotaGroupsRequest\n----------------------\n\nRequest message for the ListQuotaGroups method.\n\n| Fields ||\n|--------------|---------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The merchant account who owns the collection of method quotas Format: accounts/{account} |\n| `page_size` | `int32` 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| `page_token` | `string` Optional. Token (if provided) to retrieve the subsequent page. All other parameters must match the original call that provided the page token. |\n\nListQuotaGroupsResponse\n-----------------------\n\nResponse message for the ListMethodGroups method.\n\n| Fields ||\n|-------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `quota_groups[]` | [QuotaGroup](/merchant/api/reference/rpc/google.shopping.merchant.quota.v1beta#google.shopping.merchant.quota.v1beta.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 [quota_usage](/merchant/api/reference/rpc/google.shopping.merchant.quota.v1beta#google.shopping.merchant.quota.v1beta.QuotaGroup.FIELDS.int64.google.shopping.merchant.quota.v1beta.QuotaGroup.quota_usage). |\n| `next_page_token` | `string` A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages. |\n\nMethodDetails\n-------------\n\nThe method details per method in the Merchant API.\n\n| Fields ||\n|-----------|------------------------------------------------------------------------------------------|\n| `method` | `string` Output only. The name of the method for example `products.list`. |\n| `version` | `string` Output only. The API version that the method belongs to. |\n| `subapi` | `string` Output only. The sub-API that the method belongs to. |\n| `path` | `string` Output only. The path for the method such as `products/v1/productInputs.insert` |\n\nQuotaGroup\n----------\n\nThe group information for methods in the Merchant API. The quota is shared between all methods in the group. Even if none of the methods within the group have usage the information for the group is returned.\n\n| Fields ||\n|----------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Identifier. The resource name of the quota group. Format: accounts/{account}/quotas/{group} Note: There is no guarantee on the format of {group} |\n| `quota_usage` | `int64` Output only. The current quota usage, meaning the number of calls already made on a given day to the methods in the group. The daily quota limits reset at at 12:00 PM midday UTC. |\n| `quota_limit` | `int64` Output only. The maximum number of calls allowed per day for the group. |\n| `quota_minute_limit` | `int64` Output only. The maximum number of calls allowed per minute for the group. |\n| `method_details[]` | [MethodDetails](/merchant/api/reference/rpc/google.shopping.merchant.quota.v1beta#google.shopping.merchant.quota.v1beta.MethodDetails) Output only. List of all methods group quota applies to. |"]]
