REST Resource: accounts.listings

  • The ParsedListing resource represents a parsed listing with fields for attributes, localized names and descriptions, categories, reviews, data issues, images, service eligibility, partner list ID, brand, region code, location, and location accuracy.

  • The LatLng object represents a latitude/longitude pair in degrees using the WGS84 standard with defined ranges for latitude and longitude.

  • The Review object details a single review for a listing including ratings, language, type, link, title, body, author, and timestamps for the review and visit.

  • The Rating object describes a rating for a listing with a type, score, and the maximum possible rating scale.

  • The Image object provides information about a single image associated with a listing, including localized gallery URLs, localized titles, and a direct URI to the image content.

Resource: ParsedListing

A parsed listing

JSON representation 
{
  "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
}
Fields
unitAttributes

map (key: string, value: string)

VR List attribute.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
listingName[]

object (LocalizedText)

List of localized names.
description[]

object (LocalizedText)

Description of the property.
category[]

object (LocalizedText)

The partner provided category (accommodation type) of the property.
review[]

object (Review)

Reviews associated with this listing. Each review has a single language attached to it.
dataIssueDetail[]

object (DataIssueDetail)

Data issues about this listing
image[]

object (Image)

Images associated with this listing, localized.
isServed

boolean

Whether the listing can be served based on non image data alone.
partnerListId

string

The list ID on partner LEC feed, provided by partner.
brand

string

If not empty, it indicates that this listing belongs to a brand of the feed.
regionCode

string

The country code where the listing is located.
location

object (LatLng)

Location of listing using latitude and longitude (degrees).
imprecisionRadiusMeters

integer

Represents the accuracy of the location. The listing can be anywhere within the defined circular area.

LatLng

An object that represents a latitude/longitude pair. This is expressed as a pair of doubles to represent degrees latitude and degrees longitude. Unless specified otherwise, this object must conform to the WGS84 standard. Values must be within normalized ranges.

JSON representation 
{
  "latitude": number,
  "longitude": number
}
Fields
latitude

number

The latitude in degrees. It must be in the range [-90.0, +90.0].
longitude

number

The longitude in degrees. It must be in the range [-180.0, +180.0].

Review

A single review in a VR Listing.

NEXT ID: 10

JSON representation 
{
  "rating": [
    {
      object (Rating)
    }
  ],
  "languageCode": string,
  "type": enum (Type),
  "link": string,
  "title": string,
  "body": string,
  "author": string,
  "reviewTime": string,
  "visitTime": string
}
Fields
rating[]

object (Rating)

Any ratings associated with this review. This is repeated because reviews can include ratings on different aspects of a listing, e.g. location, cleanliness, etc.
languageCode

string

Language of the review in ISO639 format, such as "en", "de", etc.
type

enum (Type)

The type of the review.
title

string

The title of the review, for example: Great three bedrooms.
body

string

The body of the review.
author

string

The author of the review.
reviewTime

string (Timestamp format)

Unix timestamp (in seconds) of the review, in UTC+0.

Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
visitTime

string (Timestamp format)

Unix timestamp (in seconds) of when the stay was, in UTC+0.

Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".

Type

Enum for review type.

Enums
UNKNOWN Review type is unknown.
EDITORIAL Review is of editorial type.
USER Review is of user type.

Rating

A rating for a vacation rentals listing.

NEXT ID: 4

JSON representation 
{
  "type": enum (Type),
  "score": number,
  "ratingScale": integer
}
Fields
type

enum (Type)

The type of the rating.
score

number

The rating score. (e.g. 8.5)
ratingScale

integer

Maximum rating possible.

Type

The type of a vacation rentals listing rating.

Enums
TYPE_UNSPECIFIED Rating type is unspecified.
OVERALL Rating is of overall type.

Image

A single image in a VR Listing. Title and gallery URL are stored per locale.

NEXT ID: 4

JSON representation 
{
  "galleryUri": [
    {
      object (LocalizedText)
    }
  ],
  "title": [
    {
      object (LocalizedText)
    }
  ],
  "uri": string
}
Fields
galleryUri[]

object (LocalizedText)

URL that is deeplink to the image in a gallery (or a webpage).
title[]

object (LocalizedText)

Title of the image.
uri

string

URL that points to the binary image content directly.

Methods

verify

 Returns verified listings with data issues and serving eligibilities for VR partners only.