Method: accounts.products.regionalInventories.list
列出商家账号中指定商品的 RegionalInventory
资源。响应中包含的项目数量可能少于 pageSize
指定的数量。如果上一个请求中返回了 pageToken
,则可以使用它来获取更多结果。
系统会按给定账号中的每种产品列出 RegionalInventory
资源。
HTTP 请求
GET https://merchantapi.googleapis.com/inventories/v1beta/{parent=accounts/*/products/*}/regionalInventories
网址采用 gRPC 转码语法。
路径参数
参数 |
parent |
string
必需。要为其列出 RegionalInventory 资源的父级商品的 name 。格式:accounts/{account}/products/{product}
|
查询参数
参数 |
pageSize |
integer
要返回的指定商品的 RegionalInventory 资源的数量上限。如果指定商品的商品目录数量少于 pageSize ,则该服务返回的数量会少于此值。默认值为 25,000。最大值为 100000;如果指定的值高于上限,则 pageSize 将默认为上限。
|
pageToken |
string
从之前的 regionalInventories.list 调用接收的页面令牌。提供页面令牌以检索后续页面。 进行分页时,提供给 regionalInventories.list 的所有其他参数必须与提供页面令牌的调用相一致。在对上一个请求的响应中作为 nextPageToken 返回的令牌。
|
响应正文
regionalInventories.list
方法的响应消息。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
{
"regionalInventories": [
{
object (RegionalInventory )
}
],
"nextPageToken": string
} |
字段 |
regionalInventories[] |
object (RegionalInventory )
指定账号中指定商品的 RegionalInventory 资源。
|
nextPageToken |
string
可作为 pageToken 发送并用于检索下一页的令牌。如果省略此字段,则不存在后续页面。
|
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/content
如需了解详情,请参阅 OAuth 2.0 Overview。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-01-23。
[null,null,["最后更新时间 (UTC):2025-01-23。"],[[["Lists `RegionalInventory` resources for a given product within a specified merchant account, offering pagination for large result sets."],["Allows filtering by product using the `parent` path parameter in the format `accounts/{account}/products/{product}`."],["Enables control over the number of results and pagination using `pageSize` and `pageToken` query parameters."],["Returns an array of `RegionalInventory` objects and a `nextPageToken` for accessing further results in the response."],["Requires authorization with the `https://www.googleapis.com/auth/content` OAuth scope."]]],[]]