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