Method: inventory.partners.merchants.status.list
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Listet alle MerchantStatus
eines Partners auf, die die Filterbedingungen erfüllen.
HTTP-Anfrage
GET https://mapsbooking.googleapis.com/v1alpha/inventory/{parent=partners/*/merchants}/status
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter |
parent |
string
Erforderlich. Das übergeordnete Element, das dieser Sammlung von Händlerstatus zugewiesen ist. Format: partners/{partner_id}/merchants
|
Suchparameter
Parameter |
pageSize |
integer
Erforderlich. Die maximale Anzahl der Elemente, die zurückzugeben sind. Beachten Sie, dass die Seitengröße durch den Server reduziert wird.
|
pageToken |
string
Optional. Der Wert nextPageToken wurde gegebenenfalls von einer vorherigen ListMerchantStatusResponse zurückgegeben.
|
bookingInventoryStatusRestrict |
enum (BookingInventoryStatus )
Optional. Optionale Einschränkung, um Ergebnisse nach Buchungsinventarstatus zu filtern.
|
waitlistInventoryStatusRestrict |
enum (WaitlistInventoryStatus )
Optional. Optionale Einschränkung zum Filtern der Ergebnisse nach dem Status des Wartelisteninventars.
|
geoMatchRestrict |
enum (GeoMatchingStatus )
Optional. Optionale Einschränkung zum Filtern von Ergebnissen nach dem Status des geografischen Abgleichs.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Die Antwort auf die Liste MerchantStatus
.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
{
"merchantStatuses": [
{
object (MerchantStatus )
}
],
"nextPageToken": string
} |
Felder |
merchantStatuses[] |
object (MerchantStatus )
Liste der Händlerstatus, die die Filterbedingungen erfüllen.
|
nextPageToken |
string
Token zum Abrufen der nächsten Seite mit Ergebnissen. Ist die Liste leer, gibt es keine Ergebnisse mehr.
|
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/mapsbooking
BookingInventoryStatus
End-to-End-Status des Buchungsinventars.
Enums |
BOOKING_INVENTORY_STATUS_UNSPECIFIED |
Nicht angegeben. |
NO_VALID_FUTURE_INVENTORY |
Der Händler hat für die nächsten 30 Tage kein Buchungsinventar. |
HAS_VALID_FUTURE_INVENTORY |
Der Händler hat Buchungsinventar für die nächsten 30 Tage. |
WaitlistInventoryStatus
End-to-End-Inventarstatus der Warteliste.
Enums |
WAITLIST_INVENTORY_STATUS_UNSPECIFIED |
Nicht angegeben. |
NO_VALID_WAITLIST_SERVICE |
Für den Händler gibt es keine Warteliste, die einen Dienst unterstützt. |
HAS_VALID_WAITLIST_SERVICE |
Der Händler bietet einen Dienst an, der Wartelisten unterstützt. |
GeoMatchingStatus
Status des geografischen Abgleichs des Händlers.
Enums |
GEO_MATCHING_STATUS_UNSPECIFIED |
Nicht angegeben. |
GEO_UNMATCHED |
Der Händler wurde nicht geografisch zugeordnet. |
GEO_MATCHED |
Der Händler hat eine geografische Übereinstimmung. |
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-24 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-24 (UTC)."],[[["\u003cp\u003eLists all MerchantStatus of a partner that satisfy filter conditions such as booking inventory status, waitlist inventory status, or geo matching status.\u003c/p\u003e\n"],["\u003cp\u003eUses a \u003ccode\u003eGET\u003c/code\u003e request to the endpoint \u003ccode\u003ehttps://mapsbooking.googleapis.com/v1alpha/inventory/{parent=partners/*/merchants}/status\u003c/code\u003e, with required path parameter \u003ccode\u003eparent\u003c/code\u003e and optional query parameters for filtering and pagination.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/mapsbooking\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eThe response body contains a list of MerchantStatus objects and a token for pagination if there are more results.\u003c/p\u003e\n"],["\u003cp\u003eProvides enums for BookingInventoryStatus, WaitlistInventoryStatus, and GeoMatchingStatus for filtering purposes.\u003c/p\u003e\n"]]],[],null,["# Method: inventory.partners.merchants.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.ListMerchantStatusesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [BookingInventoryStatus](#BookingInventoryStatus)\n- [WaitlistInventoryStatus](#WaitlistInventoryStatus)\n- [GeoMatchingStatus](#GeoMatchingStatus)\n\nList all [MerchantStatus](/maps-booking/reference/maps-booking-api/rest/v1alpha/MerchantStatus) of a partner that satisfy the filter conditions.\n\n### HTTP request\n\n`GET https://mapsbooking.googleapis.com/v1alpha/inventory/{parent=partners/*/merchants}/status`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The parent, which owns this collection of merchant status. Format: `partners/{partner_id}/merchants` |\n\n### Query parameters\n\n| Parameters ||\n|-----------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `page``Size` | `integer` Required. The maximum number of items to return. Note that the server may reduce the page size. |\n| `page``Token` | `string` Optional. The nextPageToken value returned from a previous ListMerchantStatusResponse, if any. |\n| `booking``Inventory``Status``Restrict` | `enum (`[BookingInventoryStatus](/maps-booking/reference/maps-booking-api/rest/v1alpha/inventory.partners.merchants.status/list#BookingInventoryStatus)`)` Optional. Optional restriction to filter results by booking inventory status. |\n| `waitlist``Inventory``Status``Restrict` | `enum (`[WaitlistInventoryStatus](/maps-booking/reference/maps-booking-api/rest/v1alpha/inventory.partners.merchants.status/list#WaitlistInventoryStatus)`)` Optional. Optional restriction to filter results by waitlist inventory status. |\n| `geo``Match``Restrict` | `enum (`[GeoMatchingStatus](/maps-booking/reference/maps-booking-api/rest/v1alpha/inventory.partners.merchants.status/list#GeoMatchingStatus)`)` Optional. Optional restriction to filter results by Geo matching status. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nThe response to list [MerchantStatus](/maps-booking/reference/maps-booking-api/rest/v1alpha/MerchantStatus).\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"merchantStatuses\": [ { object (/maps-booking/reference/maps-booking-api/rest/v1alpha/MerchantStatus) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `merchant``Statuses[]` | `object (`[MerchantStatus](/maps-booking/reference/maps-booking-api/rest/v1alpha/MerchantStatus)`)` List of merchant statuses that satisfy the filter conditions. |\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`\n\nBookingInventoryStatus\n----------------------\n\nEnd-to-end booking inventory status.\n\n| Enums ||\n|----------------------------------------|-------------------------------------------------------------|\n| `BOOKING_INVENTORY_STATUS_UNSPECIFIED` | Not specified. |\n| `NO_VALID_FUTURE_INVENTORY` | Merchant doesn't have booking inventory in the next 30 day. |\n| `HAS_VALID_FUTURE_INVENTORY` | Merchant has booking inventory in the next 30 day. |\n\nWaitlistInventoryStatus\n-----------------------\n\nEnd-to-end waitlist inventory status.\n\n| Enums ||\n|-----------------------------------------|----------------------------------------------------|\n| `WAITLIST_INVENTORY_STATUS_UNSPECIFIED` | Not specified. |\n| `NO_VALID_WAITLIST_SERVICE` | Merchant doesn't have service supporting waitlist. |\n| `HAS_VALID_WAITLIST_SERVICE` | Merchant has service supporting waitlist. |\n\nGeoMatchingStatus\n-----------------\n\nMerchant geo matching status.\n\n| Enums ||\n|-----------------------------------|------------------------------|\n| `GEO_MATCHING_STATUS_UNSPECIFIED` | Not specified. |\n| `GEO_UNMATCHED` | Merchant is not geo matched. |\n| `GEO_MATCHED` | Merchant is geo matched. |"]]