Method: inventory.partners.merchants.status.list
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Filtre koşullarını karşılayan bir iş ortağının tüm MerchantStatus
öğelerini listeleyin.
HTTP isteği
GET https://mapsbooking.googleapis.com/v1alpha/inventory/{parent=partners/*/merchants}/status
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler |
parent |
string
Zorunlu. Bu satıcı durumu koleksiyonunun sahibi olan üst öğe. Biçim: partners/{partner_id}/merchants
|
Sorgu parametreleri
Parametreler |
pageSize |
integer
Zorunlu. Döndürülecek maksimum öğe sayısı. Sunucunun sayfa boyutunu küçültebileceğini unutmayın.
|
pageToken |
string
İsteğe bağlı. Önceki bir ListMerchantStatusResponse'ten döndürülen nextPageToken değeri (varsa).
|
bookingInventoryStatusRestrict |
enum (BookingInventoryStatus )
İsteğe bağlı. Sonuçları rezervasyon envanteri durumuna göre filtrelemek için isteğe bağlı kısıtlama.
|
waitlistInventoryStatusRestrict |
enum (WaitlistInventoryStatus )
İsteğe bağlı. Sonuçları bekleme listesi envanter durumuna göre filtrelemek için isteğe bağlı kısıtlama.
|
geoMatchRestrict |
enum (GeoMatchingStatus )
İsteğe bağlı. Sonuçları coğrafi eşleşme durumuna göre filtrelemek için isteğe bağlı kısıtlama.
|
İstek içeriği
İstek metni boş olmalıdır.
Yanıt gövdesi
MerchantStatus
listeleme yanıtı.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
{
"merchantStatuses": [
{
object (MerchantStatus )
}
],
"nextPageToken": string
} |
Alanlar |
merchantStatuses[] |
object (MerchantStatus )
Filtre koşullarını karşılayan satıcı durumlarının listesi.
|
nextPageToken |
string
Sonuçların sonraki sayfasını almak için kullanılan jeton. Liste boşsa başka sonuç yoktur.
|
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamını gerektirir:
https://www.googleapis.com/auth/mapsbooking
BookingInventoryStatus
Uçtan uca rezervasyon envanteri durumu.
Sıralamalar |
BOOKING_INVENTORY_STATUS_UNSPECIFIED |
Belirtilmedi. |
NO_VALID_FUTURE_INVENTORY |
Satıcı, önümüzdeki 30 gün için rezervasyon envanterine sahip değil. |
HAS_VALID_FUTURE_INVENTORY |
Satıcı, önümüzdeki 30 gün içinde rezervasyon envanterine sahip. |
WaitlistInventoryStatus
Uçtan uca bekleme listesi envanter durumu.
Sıralamalar |
WAITLIST_INVENTORY_STATUS_UNSPECIFIED |
Belirtilmedi. |
NO_VALID_WAITLIST_SERVICE |
Satıcı, bekleme listesini destekleyen bir hizmete sahip değil. |
HAS_VALID_WAITLIST_SERVICE |
Satıcının destekleyici hizmet bekleme listesi var. |
GeoMatchingStatus
Satıcı coğrafi eşleşme durumu.
Sıralamalar |
GEO_MATCHING_STATUS_UNSPECIFIED |
Belirtilmedi. |
GEO_UNMATCHED |
Satıcı coğrafi olarak eşleşmedi. |
GEO_MATCHED |
Satıcı coğrafi olarak eşleşiyor. |
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-24 UTC.
[null,null,["Son güncelleme tarihi: 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. |"]]