Method: inventory.partners.merchants.status.list

列出符合篩選條件的合作夥伴所有 MerchantStatus。

HTTP 要求

GET https://mapsbooking.googleapis.com/v1alpha/inventory/{parent=partners/*/merchants}/status

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
parent

string

必要欄位。擁有此商家狀態集合的父項資源。格式：partners/{partner_id}/merchants

查詢參數

參數
pageSize

integer

必要欄位。傳回的項目數量上限。請注意，伺服器可能會縮減網頁大小。
pageToken

string

選用設定。先前的 ListMerchantStatusResponse (如果有的話) 傳回的 nextPageToken 值。
bookingInventoryStatusRestrict

enum (BookingInventoryStatus)

選用設定。選用的限制條件，可根據預訂商品目錄狀態篩選結果。
waitlistInventoryStatusRestrict

enum (WaitlistInventoryStatus)

選用設定。選用的限制條件，可根據候補名單商品目錄狀態篩選結果。
geoMatchRestrict

enum (GeoMatchingStatus)

選用設定。選用的限制條件，可根據地理比對狀態篩選結果。

要求主體

要求主體必須為空白。

回應主體

清單 MerchantStatus 的回應。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "merchantStatuses": [
    {
      object (MerchantStatus)
    }
  ],
  "nextPageToken": string
}
欄位
merchantStatuses[]

object (MerchantStatus)

符合篩選條件的商家狀態清單。
nextPageToken

string

用於擷取下一頁結果的符記。如果此欄位留白，清單中不會有其他結果。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/mapsbooking

BookingInventoryStatus

端對端預訂的廣告空間狀態。

列舉
BOOKING_INVENTORY_STATUS_UNSPECIFIED 不指定。
NO_VALID_FUTURE_INVENTORY 商家在未來 30 天內沒有可預訂的房源。
HAS_VALID_FUTURE_INVENTORY 商家在未來 30 天內有預訂的廣告空間。

WaitlistInventoryStatus

端對端等候名單廣告空間狀態。

列舉
WAITLIST_INVENTORY_STATUS_UNSPECIFIED 不指定。
NO_VALID_WAITLIST_SERVICE 商家沒有支援候位服務。
HAS_VALID_WAITLIST_SERVICE 商家提供的服務支援等候名單。

GeoMatchingStatus

商家地理比對狀態。

列舉
GEO_MATCHING_STATUS_UNSPECIFIED 不指定。
GEO_UNMATCHED 商家未進行地理比對。
GEO_MATCHED 商家已與地理位置比對成功。