REST Resource: accounts.priceAccuracyViews

资源:PriceAccuracyView

价格准确性视图。涵盖预先发布的 v3.0 API 版本中的价格准确性报告功能。如需了解详情,请参阅价格准确性报告

JSON 表示法
{
  "name": string,
  "results": [
    {
      object (PriceAccuracyRow)
    }
  ]
}
字段
name

string

资源名称应采用 accounts/{account_id}/priceAccuracyViews/{report_date} 格式。

results[]

object (PriceAccuracyRow)

与查询匹配的行列表。

PriceAccuracyRow

价格准确性行。

JSON 表示法
{
  "hotel": string,
  "checkinDate": {
    object (Date)
  },
  "lengthOfStayDays": integer,
  "fetchedPriceRecord": {
    object (PriceRecord)
  },
  "cachedPriceRecord": {
    object (PriceRecord)
  },
  "correctionTime": string,
  "url": string,
  "rateRuleId": string,
  "hotelCountryCode": string,
  "deviceType": enum (Device),
  "finalDomain": string,
  "mismatchReason": enum (MismatchReason),
  "affectsScore": boolean,
  "signalSource": enum (SignalSource),
  "userRegionCode": string,
  "adultOccupancy": integer,
  "childOccupancy": integer
}
字段
hotel

string

合作伙伴定义的酒店 ID。

checkinDate

object (Date)

入住日期。

lengthOfStayDays

integer

住宿晚数。

fetchedPriceRecord

object (PriceRecord)

从合作伙伴网站读取的价格。

cachedPriceRecord

object (PriceRecord)

广告中显示的价格。

correctionTime

string (Timestamp format)

将不正确的价格更新为正确价格的时间。

采用 RFC 3339 标准,生成的输出将始终进行 Z 规范化(即转换为 UTC 零时区格式并在末尾附加 Z),并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z""2014-10-02T15:01:23+05:30"

url

string

在合作伙伴网站上访问的初始网址。

rateRuleId

string

非公开价格的广告价格的费率规则。

hotelCountryCode

string

酒店所在的国家/地区(基于地址)。

deviceType

enum (Device)

用户的设备类型。

finalDomain

string

从中读取价格的最终页面的网域。

mismatchReason

enum (MismatchReason)

提取的价格与缓存的价格不一致的原因。

affectsScore

boolean

如果此行会影响总体价格准确性得分,则为 true。

signalSource

enum (SignalSource)

价格准确性信号的来源。

userRegionCode

string

用户的区域。

adultOccupancy

integer

验证查询的入住详情中的成人人数。注意:由于技术限制,此字段可能无法始终填充。如果缺失,合作伙伴应假定默认值为 2 位成人。

childOccupancy

integer

验证查询的入住详情中的儿童人数。注意:此字段可能无法始终填充。如果缺失,合作伙伴应假定默认值为 0 位儿童。

PriceRecord

价格记录。

JSON 表示法
{
  "basePrice": number,
  "taxesAndFees": number,
  "currencyCode": string,
  "time": string
}
字段
basePrice

number

底价。

taxesAndFees

number

税费及其他费用。

currencyCode

string

ISO 4217 货币代码。

time

string (Timestamp format)

此价格记录的时间戳。

采用 RFC 3339 标准,生成的输出将始终进行 Z 规范化(即转换为 UTC 零时区格式并在末尾附加 Z),并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z""2014-10-02T15:01:23+05:30"

Device

列举了支持的设备。

枚举
DEVICE_UNSPECIFIED 未指定。
DEVICE_UNKNOWN 此版本中的值未知。
DESKTOP 计算机。
MOBILE 配备完善的网络浏览功能的移动设备。
TABLET 配备完善的网络浏览功能的平板电脑。

MismatchReason

列举了不匹配的原因。

枚举
MISMATCH_REASON_UNSPECIFIED 未指定。
MISMATCH_REASON_UNKNOWN 此版本中的值未知。
TAX_MISMATCH 税费不一致。
ROOM_UNAVAILABLE 房间不可用。
SITE_ERROR 网站错误。
PRICE_FEED_DELAYED 价格 Feed 延迟。
DISCOUNT_MISSING 缺少折扣。
INCORRECT_DISCOUNT_VALUE 折扣值不正确。
WRONG_ITINERARY 行程错误。

SignalSource

列举了价格准确性支持的信号传递方法。

枚举
SIGNAL_SOURCE_UNSPECIFIED 未指定。
SIGNAL_SOURCE_UNKNOWN 此版本中的值未知。
FETCHED 价格直接从合作伙伴的网站读取。
PIXEL 价格由合作伙伴通过价格准确性像素提供。

方法

get

返回请求的价格准确性视图的完整详细信息。

list

列出可用的价格准确性视图。

summarize

返回价格准确性摘要。