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