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