Method: inventory.partners.merchants.status.list
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Répertorie tous les MerchantStatus
d'un partenaire qui remplissent les conditions de filtre.
Requête HTTP
GET https://mapsbooking.googleapis.com/v1alpha/inventory/{parent=partners/*/merchants}/status
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres |
parent |
string
Obligatoire. Élément parent qui possède cette collection d'états de marchand. Format : partners/{partner_id}/merchants
|
Paramètres de requête
Paramètres |
pageSize |
integer
Obligatoire. Le nombre maximum d'éléments à renvoyer. Notez que le serveur peut réduire la taille de la page.
|
pageToken |
string
Facultatif. Valeur nextPageToken renvoyée par une réponse ListMerchantStatusResponse précédente, le cas échéant.
|
bookingInventoryStatusRestrict |
enum (BookingInventoryStatus )
Facultatif. Limite facultative appliquée au filtrage des résultats en fonction de l'état de l'inventaire de réservations.
|
waitlistInventoryStatusRestrict |
enum (WaitlistInventoryStatus )
Facultatif. Restriction facultative permettant de filtrer les résultats par état de l'inventaire sur liste d'attente.
|
geoMatchRestrict |
enum (GeoMatchingStatus )
Facultatif. Restriction facultative permettant de filtrer les résultats par état de correspondance géographique.
|
Corps de la requête
Le corps de la requête doit être vide.
Corps de la réponse
Réponse à la liste MerchantStatus
.
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
Représentation JSON |
{
"merchantStatuses": [
{
object (MerchantStatus )
}
],
"nextPageToken": string
} |
Champs |
merchantStatuses[] |
object (MerchantStatus )
Liste des états des marchands qui répondent aux conditions de filtrage.
|
nextPageToken |
string
Jeton permettant de récupérer la page de résultats suivante. Si aucune valeur n'est définie, cela signifie que la liste ne contient plus de résultats.
|
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/mapsbooking
BookingInventoryStatus
État de l'inventaire des réservations de bout en bout.
Enums |
BOOKING_INVENTORY_STATUS_UNSPECIFIED |
Non spécifié. |
NO_VALID_FUTURE_INVENTORY |
Le marchand ne dispose d'aucun inventaire de réservation pour les 30 prochains jours. |
HAS_VALID_FUTURE_INVENTORY |
Le marchand dispose d'un inventaire de réservations pour les 30 prochains jours. |
WaitlistInventoryStatus
État de l'inventaire de la liste d'attente de bout en bout.
Enums |
WAITLIST_INVENTORY_STATUS_UNSPECIFIED |
Non spécifié. |
NO_VALID_WAITLIST_SERVICE |
Le marchand ne dispose pas d'un service prenant en charge la liste d'attente. |
HAS_VALID_WAITLIST_SERVICE |
Le marchand propose un service compatible avec les listes d'attente. |
GeoMatchingStatus
État de la mise en correspondance géographique des marchands.
Enums |
GEO_MATCHING_STATUS_UNSPECIFIED |
Non spécifié. |
GEO_UNMATCHED |
Aucune correspondance géographique n'est établie pour le marchand. |
GEO_MATCHED |
Le marchand fait l'objet d'une correspondance géographique. |
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/24 (UTC).
[null,null,["Dernière mise à jour le 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. |"]]