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/merchantspartners/{partner_id}/feeds/servicespartners/{partner_id}/feeds/availability
|
معامِلات طلب البحث
| المعلمات |
pageSize |
integer
الحد الأقصى لعدد العناصر التي سيتم عرضها
|
pageToken |
string
قيمة NextPageToken التي يتم عرضها من طلب قائمة سابق، إن وجد.
|
stateRestrict |
enum (State)
إجراء اختياري لفلترة النتائج حسب حالة الخلاصة
|
timeRangeRestrict |
object (TimeRange)
تقييد اختياري لفلترة النتائج حسب الحدّ الأقصى والحدّ الأدنى في حال عدم ضبط وقت البدء، سيتم ضبط وقت البدء تلقائيًا على بداية وقت يونكس. إذا لم يتم ضبط 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 (حسب التوقيت العالمي المتفَّق عليه)
[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`"]]
