Mensagem de solicitação para o método ListQuotaGroups.
Campos
parent
string
Obrigatório. A conta do comerciante proprietária da coleta de cotas de método. Formato: accounts/{account}
page_size
int32
Opcional. O número máximo de cotas a serem retornadas na resposta, usado para paginação. O padrão é 500. Valores acima de 1.000 serão convertidos para 1.000.
page_token
string
Opcional. Token (se fornecido) para recuperar a página seguinte. Todos os outros parâmetros precisam corresponder à chamada original que forneceu o token da página.
ListQuotaGroupsResponse
Mensagem de resposta para o método ListMethodGroups.
Os métodos, o uso atual da cota e os limites de cada grupo. A cota é compartilhada entre todos os métodos do grupo. Os grupos são classificados em ordem decrescente com base em quota_usage.
next_page_token
string
Um token, que pode ser enviado como page_token para recuperar a próxima página. Se esse campo for omitido, não haverá páginas subsequentes.
MethodDetails
Os detalhes do método na API Merchant.
Campos
method
string
Apenas saída. O nome do método, por exemplo, products.list.
version
string
Apenas saída. A versão da API à qual o método pertence.
subapi
string
Apenas saída. A sub-API à qual o método pertence.
path
string
Apenas saída. O caminho do método, como products/v1/productInputs.insert
QuotaGroup
As informações do grupo para métodos na API Merchant. A cota é compartilhada entre todos os métodos do grupo. Mesmo que nenhum dos métodos no grupo tenha uso, as informações do grupo serão retornadas.
Campos
name
string
Identificador. O nome do recurso do grupo de cotas. Formato: accounts/{account}/quotas/{group} Observação: não há garantia sobre o formato de {group}
quota_usage
int64
Apenas saída. O uso atual da cota, ou seja, o número de chamadas já feitas em um determinado dia para os métodos no grupo. Os limites diários de cota são redefinidos às 12h (UTC).
quota_limit
int64
Apenas saída. O número máximo de chamadas permitidas por dia para o grupo.
quota_minute_limit
int64
Apenas saída. O número máximo de chamadas permitidas por minuto para o grupo.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-01-23 UTC."],[[["\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. |"]]