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 商家已與地理位置比對成功。