Method: accounts.hotelViews.list

返回酒店视图列表。

HTTP 请求

GET https://travelpartner.googleapis.com/v3/{parent=accounts/*}/hotelViews

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

所查询账号的资源名称。格式为 accounts/{account_id}

查询参数

参数
pageSize

integer

要在单个页面中检索的元素数量。

pageToken

string

要检索的页面的令牌。

filter

string

可选。用于过滤 HotelView 的条件(字段和表达式)。该语法要求在 in 运算符前后添加空格。否则,可以省略空格。

无法联接条件。

您可以使用 hotelId 字段选择特定酒店。

liveOnGoogle 字段可以选择 Google 显示的房源,也可以选择 Google 搜索结果中省略的房源。值为“TRUE”时,表示包含有条件处于有效状态的属性,例如 LIVE_ON_GOOGLE_STATUS_ACTIVE_OUTSIDE_DSA_REGION。

matchStatus 字段可用于过滤为相应账号返回的 HotelViews 列表。

以下是有效条件及其语法的示例:

  • hotelId = 'hotel_ABC'
  • hotelId in ('hotel_ABC', 'hotel_XYZ')
  • liveOnGoogle = 'TRUE'
  • liveOnGoogle = 'FALSE'
  • matchStatus = 'NOT_MATCHED'
  • matchStatus in ('NOT_MATCHED', 'MATCHED', 'MAP_OVERLAP')

请求正文

请求正文必须为空。

响应正文

HotelViewService.ListHotelViews 的响应消息。

如果成功,响应正文将包含结构如下的数据:

JSON 表示法
{
  "hotelViews": [
    {
      object (HotelView)
    }
  ],
  "nextPageToken": string
}
字段
hotelViews[]

object (HotelView)

与查询匹配的行列表。

nextPageToken

string

用于检索下一页结果的分页令牌。

授权范围

需要以下 OAuth 范围:

  • https://www.googleapis.com/auth/travelpartner

如需了解详情,请参阅 OAuth 2.0 Overview