REST Resource: accounts.listings

资源:ParsedListing

已解析的商品详情

JSON 表示法
{
  "unitAttributes": {
    string: string,
    ...
  },
  "listingName": [
    {
      object (LocalizedText)
    }
  ],
  "description": [
    {
      object (LocalizedText)
    }
  ],
  "category": [
    {
      object (LocalizedText)
    }
  ],
  "review": [
    {
      object (Review)
    }
  ],
  "dataIssueDetail": [
    {
      object (DataIssueDetail)
    }
  ],
  "image": [
    {
      object (Image)
    }
  ],
  "isServed": boolean,
  "partnerListId": string,
  "brand": string,
  "regionCode": string,
  "location": {
    object (LatLng)
  },
  "imprecisionRadiusMeters": integer
}
字段
unitAttributes

map (key: string, value: string)

VR List 属性。

包含一系列 "key": value 对的对象。示例:{ "name": "wrench", "mass": "1.3kg", "count": "3" }

listingName[]

object (LocalizedText)

本地化名称列表。

description[]

object (LocalizedText)

房源说明。

category[]

object (LocalizedText)

合作伙伴提供的房源类别(住宿类型)。

review[]

object (Review)

与相应商家信息关联的评价。每条评价都关联着一种语言。

dataIssueDetail[]

object (DataIssueDetail)

此房源的数据问题

image[]

object (Image)

与相应商家信息关联的本地化图片。

isServed

boolean

是否可以仅根据非图片数据投放相应房源。

partnerListId

string

合作伙伴 LEC Feed 中的列表 ID,由合作伙伴提供。

brand

string

如果不为空,则表示相应商品详情属于相应 Feed 的品牌。

regionCode

string

房源所在国家/地区的国家/地区代码。

location

object (LatLng)

使用纬度和经度(以度为单位)表示的商家信息位置。

imprecisionRadiusMeters

integer

表示位置信息的精确度。房源可以在定义的圆形区域内的任何位置。

LatLng

表示纬度/经度对的对象。该对象以一对双精度数表示,分别代表纬度度数和经度度数。除非另有说明,否则该对象必须符合 WGS84 标准。值必须介于标准化范围内。

JSON 表示法
{
  "latitude": number,
  "longitude": number
}
字段
latitude

number

纬度(以度为单位)。它必须在 [-90.0, +90.0] 范围内。

longitude

number

经度(以度为单位)。它必须在 [-180.0, +180.0] 范围内。

查看

VR 商家信息中的单条评价。

下一个 ID:10

JSON 表示法
{
  "rating": [
    {
      object (Rating)
    }
  ],
  "languageCode": string,
  "type": enum (Type),
  "link": string,
  "title": string,
  "body": string,
  "author": string,
  "reviewTime": string,
  "visitTime": string
}
字段
rating[]

object (Rating)

与相应评价关联的任何评分。之所以重复,是因为评价可以包含对房源不同方面的评分,例如位置、清洁度等。

languageCode

string

评价的语言,采用 ISO639 格式,例如“en”“de”等。

type

enum (Type)

评价的类型。

title

string

评价的标题,例如:很棒的三居室。

body

string

评论的正文。

author

string

评论者。

reviewTime

string (Timestamp format)

相应评价的 Unix 时间戳(以秒为单位,采用 UTC+0 时区)。

采用 RFC 3339 标准,生成的输出将始终在末尾带 Z,并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z""2014-10-02T15:01:23+05:30"

visitTime

string (Timestamp format)

住宿的 Unix 时间戳(以秒为单位,采用 UTC+0)。

采用 RFC 3339 标准,生成的输出将始终在末尾带 Z,并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z""2014-10-02T15:01:23+05:30"

类型

用于表示评价类型的枚举。

枚举
UNKNOWN 评价类型未知。
EDITORIAL 评价属于编辑类型。
USER 评价属于用户类型。

评分

民宿商家信息的评分。

下一个 ID:4

JSON 表示法
{
  "type": enum (Type),
  "score": number,
  "ratingScale": integer
}
字段
type

enum (Type)

评分类型。

score

number

评分。(例如 8.5)

ratingScale

integer

最高评分。

类型

民宿商家信息评分的类型。

枚举
TYPE_UNSPECIFIED 未指定评分类型。
OVERALL 评分属于总体类型。

图片

VR 商品详情中的单张图片。标题和图库网址按语言区域存储。

下一个 ID:4

JSON 表示法
{
  "galleryUri": [
    {
      object (LocalizedText)
    }
  ],
  "title": [
    {
      object (LocalizedText)
    }
  ],
  "uri": string
}
字段
galleryUri[]

object (LocalizedText)

指向图库(或网页)中图片的深层链接网址。

title[]

object (LocalizedText)

图片的标题。

uri

string

直接指向二进制图片内容的网址。

方法

verify

仅针对 VR 合作伙伴,返回存在数据问题且符合投放条件的已验证商品详情。