Method: inventory.partners.feeds.status.list
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
אחזור Status
של מספר פידים של מוכרים, שירותים או זמינות שהועלו בעבר על ידי אתר האגרגטור שצוין, ומחזיר אותם.
בקשת HTTP
GET https://mapsbooking.googleapis.com/v1alpha/inventory/{name=partners/*/feeds/*}/status
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים |
name |
string
שם משאב הפיד, בפורמט
partners/{partner_id}/feeds/merchants
partners/{partner_id}/feeds/services
partners/{partner_id}/feeds/availability
|
פרמטרים של שאילתה
פרמטרים |
pageSize |
integer
מספר הפריטים המקסימלי להחזרה.
|
pageToken |
string
הערך 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
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-24 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-24 (שעון UTC)."],[[["\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`"]]