rocket
Meet
Merchant API
- the official successor to Content API for Shopping.
update
Get the latest
on new Merchant API features, bug fixes, and updates.
add_alert
Note: Content API for Shopping will be sunset on August 18, 2026.
Method: quotas.list
Stay organized with collections
Save and categorize content based on your preferences.
Lists the daily call quota and usage per method for your Merchant Center account.
HTTP request
GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/quotas
Path parameters
Parameters |
merchantId |
string (int64 format)
Required. The ID of the account that has quota. This account must be an admin.
|
Query parameters
Parameters |
pageSize |
integer
The maximum number of quotas to return in the response, used for paging. Defaults to 500; values above 1000 will be coerced to 1000.
|
pageToken |
string
Token (if provided) to retrieve the subsequent page. All other parameters must match the original call that provided the page token.
|
Request body
The request body must be empty.
Response body
Response message for the quotas.list method.
If successful, the response body contains data with the following structure:
JSON representation |
{
"methodQuotas": [
{
object (MethodQuota )
}
],
"nextPageToken": string
} |
Fields |
methodQuotas[] |
object (MethodQuota )
The current quota usage and limits per each method.
|
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.
|
Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/content
For more information, see the OAuth 2.0 Overview.
MethodQuota
The quota information per method in the Content API.
JSON representation |
{
"method": string,
"quotaUsage": string,
"quotaLimit": string,
"quotaMinuteLimit": string
} |
Fields |
method |
string
Output only. The method name, for example products.list . Method name does not contain version because quota can be shared between different API versions of the same method.
|
quotaUsage |
string (int64 format)
Output only. The current quota usage, meaning the number of calls already made to the method per day. Usage is reset every day at 12 PM midday UTC.
|
quotaLimit |
string (int64 format)
Output only. The maximum number of calls allowed per day for the method.
|
quotaMinuteLimit |
string (int64 format)
Output only. The maximum number of calls allowed per minute for the method.
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-02-25 UTC.
[null,null,["Last updated 2025-02-25 UTC."],[[["\u003cp\u003eLists the daily call quota and usage per method for a given Merchant Center account.\u003c/p\u003e\n"],["\u003cp\u003eUses the \u003ccode\u003eGET\u003c/code\u003e HTTP request method and requires the Merchant Center account ID.\u003c/p\u003e\n"],["\u003cp\u003eSupports pagination for retrieving large result sets.\u003c/p\u003e\n"],["\u003cp\u003eResponse includes quota usage, limits, and method details.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/content\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This document details how to retrieve daily call quota and usage information for a Merchant Center account's methods. To obtain this data, send a `GET` request to `https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/quotas`, using the merchant ID as a path parameter. The request body should be empty. Optional query parameters include `pageSize` and `pageToken`. The response, which represents `MethodQuota` contains details for each method including its name, daily quota usage, daily limit, and per-minute limit.\n"],null,["# Method: 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.ListMethodQuotasResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [MethodQuota](#MethodQuota)\n - [JSON representation](#MethodQuota.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nLists the daily call quota and usage per method for your Merchant Center account.\n\n### HTTP request\n\n`GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/quotas`\n\n### Path parameters\n\n| Parameters ||\n|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `merchantId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the account that has quota. This account must be an admin. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` 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` 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 quotas.list method.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"methodQuotas\": [ { object (/shopping-content/reference/rest/v2.1/quotas/list#MethodQuota) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|------------------|-----------------------------------------------------------------------------------------------------------------------------------------------|\n| `methodQuotas[]` | `object (`[MethodQuota](/shopping-content/reference/rest/v2.1/quotas/list#MethodQuota)`)` The current quota usage and limits per each method. |\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 one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/content`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2).\n\nMethodQuota\n-----------\n\nThe quota information per method in the Content API.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------|\n| ``` { \"method\": string, \"quotaUsage\": string, \"quotaLimit\": string, \"quotaMinuteLimit\": string } ``` |\n\n| Fields ||\n|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `method` | `string` Output only. The method name, for example `products.list`. Method name does not contain version because quota can be shared between different API versions of the same method. |\n| `quotaUsage` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. The current quota usage, meaning the number of calls already made to the method per day. Usage is reset every day at 12 PM midday UTC. |\n| `quotaLimit` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. The maximum number of calls allowed per day for the method. |\n| `quotaMinuteLimit` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. The maximum number of calls allowed per minute for the method. |"]]