Method: inventory.partners.feeds.status.list
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
检索指定的集合商家之前上传的多个商家 Feed、服务 Feed 或可用性 Feed 的 Status
,并将其返回。
HTTP 请求
GET https://mapsbooking.googleapis.com/v1alpha/inventory/{name=partners/*/feeds/*}/status
网址采用 gRPC 转码语法。
路径参数
参数 |
name |
string
Feed 资源的名称,格式为
partners/{partner_id}/feeds/merchants
partners/{partner_id}/feeds/services
partners/{partner_id}/feeds/availability
|
查询参数
参数 |
pageSize |
integer
需要返回的最大项数。
|
pageToken |
string
从上一个 List 请求返回的 nextPageToken 值(如果有)。
|
stateRestrict |
enum (State )
按 Feed 状态过滤结果的可选限制条件。
|
timeRangeRestrict |
object (TimeRange )
按上限和下限过滤结果的可选限制条件。如果未设置 startTime,则默认以 UNIX 时间为开始时间。如果未设置 endTime,则默认以当下为结束时间。
|
响应正文
用于检索集合商家平台上传的多个 Feed 的 Status
的请求。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
{
"status": [
{
object (FeedStatus )
}
],
"nextPageToken": string
} |
字段 |
status[] |
object (FeedStatus )
按时间倒序排列的已上传 Feed 的状态列表。返回的最大项数取决于请求中的 pageSize 字段。
|
nextPageToken |
string
用于检索下一页结果的令牌。如果为空,则列表中无其他结果。
|
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/mapsbooking
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-24。
[null,null,["最后更新时间 (UTC):2025-07-24。"],[[["\u003cp\u003eRetrieves the status of multiple merchant, service, or availability feeds uploaded by an aggregator.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering results by feed state and a specified time range.\u003c/p\u003e\n"],["\u003cp\u003eUses a GET request with path and query parameters to specify the feed resource and filtering options.\u003c/p\u003e\n"],["\u003cp\u003eReturns a list of feed statuses with a token for pagination if more results are available.\u003c/p\u003e\n"],["\u003cp\u003eRequires the \u003ccode\u003ehttps://www.googleapis.com/auth/mapsbooking\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"]]],[],null,["# Method: inventory.partners.feeds.status.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.ListStatusResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n\nRetrieves the [Status](/maps-booking/reference/maps-booking-api/rest/v1alpha/FeedStatus) of multiple previously uploaded merchant, service, or availability feeds by the specified aggregator, and returns them.\n\n### HTTP request\n\n`GET https://mapsbooking.googleapis.com/v1alpha/inventory/{name=partners/*/feeds/*}/status`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` The feed resource name, which has the format of - `partners/{partner_id}/feeds/merchants` - `partners/{partner_id}/feeds/services` - `partners/{partner_id}/feeds/availability` |\n\n### Query parameters\n\n| Parameters ||\n|-------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `page``Size` | `integer` The maximum number of items to return. |\n| `page``Token` | `string` The nextPageToken value returned from a previous List request, if any. |\n| `state``Restrict` | `enum (`[State](/maps-booking/reference/maps-booking-api/rest/v1alpha/State)`)` Optional restrict to filter results by feed state. |\n| `time``Range``Restrict` | `object (`[TimeRange](/maps-booking/reference/maps-booking-api/rest/v1alpha/TimeRange)`)` Optional restrict to filter results by upper and lower bound. If startTime is unset, it will default to beginning of unix time. If endTime is unset, it will default to now. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nThe request to retrieve the [Status](/maps-booking/reference/maps-booking-api/rest/v1alpha/FeedStatus) for multiple feeds uploaded by the aggregator's platform.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"status\": [ { object (/maps-booking/reference/maps-booking-api/rest/v1alpha/FeedStatus) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|---------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `status[]` | `object (`[FeedStatus](/maps-booking/reference/maps-booking-api/rest/v1alpha/FeedStatus)`)` Reverse chronological list of statuses for uploaded feeds. The maximum number of items returned is based on the pageSize field in the request. |\n| `next``Page``Token` | `string` Token to retrieve the next page of results. There are no more results in the list if empty. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/mapsbooking`"]]