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 商家已进行地理位置匹配。