Merchant API v1beta 已于 2026 年 2 月 28 日停用并关停。如需了解迁移到最新稳定版的步骤,请参阅
从 v1beta 迁移到 v1。
Method: accounts.products.localInventories.list
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
列出商家账号中指定商品的 LocalInventory 资源。响应中包含的项目数量可能少于 pageSize 指定的数量。如果上一个请求中返回了 pageToken,则可以使用它来获取更多结果。
系统会按给定账号中的每种产品列出 LocalInventory 资源。
HTTP 请求
GET https://merchantapi.googleapis.com/inventories/v1beta/{parent=accounts/*/products/*}/localInventories
网址采用 gRPC 转码语法。
路径参数
| 参数 |
parent |
string
必需。要为其列出本地商品目录的父级商品的 name。格式:accounts/{account}/products/{product}
|
查询参数
| 参数 |
pageSize |
integer
要返回的指定商品的 LocalInventory 资源的数量上限。如果指定商品的商品目录数量少于 pageSize,则该服务返回的数量会少于此值。默认值为 25,000。最大值为 25, 000;如果指定的值高于上限,则 pageSize 将默认为上限
|
pageToken |
string
从之前的 localInventories.list 调用接收的页面令牌。提供页面令牌以检索后续页面。 进行分页时,提供给 localInventories.list 的所有其他参数必须与提供页面令牌的调用相一致。在对上一个请求的响应中作为 nextPageToken 返回的令牌。
|
响应正文
localInventories.list 方法的响应消息。
如果成功,响应正文将包含结构如下的数据:
| JSON 表示法 |
{
"localInventories": [
{
object (LocalInventory)
}
],
"nextPageToken": string
} |
| 字段 |
localInventories[] |
object (LocalInventory)
指定账号中指定商品的 LocalInventory 资源。
|
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。"],[],["This content outlines how to retrieve `LocalInventory` resources for a specific product within a merchant account. A `GET` request is sent to the specified URL, using the product's `name` in the `parent` path parameter. Optional `pageSize` and `pageToken` query parameters manage result pagination. The request body is empty, while the response body returns a list of `LocalInventory` objects, and a `nextPageToken` for further pages. Access requires the `https://www.googleapis.com/auth/content` OAuth scope.\n"]]