Method: inventory.partners.feeds.status.list
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
擷取並傳回由指定集結網站先前上傳的多個商家、服務或供應情形動態饋給的 Status。
HTTP 要求
GET https://mapsbooking.googleapis.com/v1alpha/inventory/{name=partners/*/feeds/*}/status
這個網址使用 gRPC 轉碼語法。
路徑參數
| 參數 |
name |
string
此為動態饋給資源名稱，格式如下
partners/{partner_id}/feeds/merchantspartners/{partner_id}/feeds/servicespartners/{partner_id}/feeds/availability
|
查詢參數
| 參數 |
pageSize |
integer
傳回的項目數量上限。
|
pageToken |
string
先前的 List 要求 (如果有的話) 傳回的 nextPageToken 值。
|
stateRestrict |
enum (State)
選用限制，按動態饋給狀態篩選結果。
|
timeRangeRestrict |
object (TimeRange)
選用的限制，可根據上限和下限篩選結果。若沒有設定 startTime，系統會將這個時間預設為 Unix 時間一開始時；如果未設定 endTime，系統會將該時間預設為現在。
|
回應主體
要求擷取由集結網站平台上傳的多個動態饋給的 Status。
如果成功，回應主體會含有以下結構的資料：
| JSON 表示法 |
{
"status": [
{
object (FeedStatus)
}
],
"nextPageToken": string
} |
| 欄位 |
status[] |
object (FeedStatus)
已上傳的動態饋給狀態清單，依時間前後反向排序。傳回項目的數量上限取決於要求中的 pageSize 欄位。
|
nextPageToken |
string
用於擷取下一頁結果的符記。如果空白，清單中沒有其他結果。
|
授權範圍
需要下列 OAuth 範圍：
https://www.googleapis.com/auth/mapsbooking
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-24 (世界標準時間)。
[null,null,["上次更新時間：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`"]]
