住客点评
在您的消费体验中，展示由经过 Expedia Group 验证的旅客提供的书面住客点评，帮助推动实现转化。
概述
Expedia Group 要求最近完成住宿的旅客对住宿进行评分，并分享他们体验的书面点评。借助 Rapid 的住客点评 API，您可以访问数以千万计的书面住客点评，从而能够在您的网站、平台和 App 上向旅客展示这些评论。
其他旅客的真实经历可以帮助您的客户做出合适的旅行预订决策，并对住宿抱有合理的预期。
如何操作
在住客点评 API 请求中包含住宿 ID 和语言，以确保针对正确的住宿并使用旅客首选的语言返回点评。然后，我们会从 Expedia Group 用户生成内容的库存中返回多达 100 条针对该住宿的点评。
住客点评 API 响应包括：
- 总评分、点评标题和正文以及点评用户姓名
- 旅客住宿的年份和月份以及提交点评的日期
- 任何旅行同伴的信息 - 类别包括
self、partner、family_with_children、family、friends和pet - 相关旅行类型或
trip_reason，包括business、leisure、business_and_leisure或friends_and_family - 住宿对特定旅客点评的任何书面响应以及响应日期
响应示例
{
"verified": {
"recent": [
{
"verification_source": "Expedia verified Review",
"title": "Definitely staying again",
"date_submitted": "2019-02-11T18:19:40Z",
"rating": "5",
"reviewer_name": "Bill",
"stay_date": "2019-02",
"trip_reason": "leisure",
"travel_companion": "self",
"text": "Staff very helpful and friendly. Pool was 18 meters deep, very strange."
},
{
"verification_source": "Expedia verified Review",
"title": "Pool much too deep",
"date_submitted": "2019-02-10T11:15:01Z",
"rating": "2",
"reviewer_name": "Gregory",
"stay_date": "2019-01",
"trip_reason": "friends_and_family",
"travel_companion": "family_with_children",
"text": "Bottom of the 18 meter pool was too scary. Staff were nice though.",
"management_responses": [
{
"text": "Dear Guest, Thank you for your feedback. I hope we have the opportunity to welcome you back in the near future. Best regards, Kara (General Manager)",
"date": "2019-02-11T14:36:54Z"
}
]
}
]
}
}实时调用后，点评可以缓存长达 48 小时，以帮助提高显示速度。
筛选住客点评 API 请求
有几种方法可以调整您的住客点评 API 请求，以便在响应接收最相关的旅客点评。这可以帮助您定制网站或平台上的点评，使其最适合您的旅客受众。
例如，您可以在请求中指定是否只接收来自商务旅客的点评、使用指定语言撰写的点评，或来自带宠物旅行的住客的评论。
示例请求
curl -X GET "https://test.ean.com/v3/properties/12345/guest-reviews\
?language=fr-FR\
&filter=language\
&trip_reason=business" \
-H "accept: application/json"\
-H "accept-encoding: gzip"\
-H "authorization: EAN apikey=abcd1234,signature=090a77e7ddd7779980231,timestamp=1719329586"\
-H "user-agent: TravelNow/3.30.112"上线要求
要在您的住宿选购和预订环境中访问和显示 Expedia Group 已验证的点评，您必须遵守上线要求。
要进一步了解 Rapid 住客点评 API，请联系您的 Expedia 代表。