Marketing API
Версия API Graph

Product Catalog Home Listings

Чтение

Нельзя выполнить эту операцию в этой конечной точке.

Создание

Вы можете сделать запрос POST к границе home_listings из этих местоположений:
При размещении публикации на этой границе создается a HomeListing.

Параметры

ПараметрОписание
address
Object

The address of the home listing

Обязательно
city
string

Обязательно
country
string

Обязательно
latitude
float

Обязательно
longitude
float

Обязательно
neighborhoods
list<string>

postal_code
string

region
string

Обязательно
street_address
string

Обязательно
availability
string

The availability of the home listing

Обязательно
currency
ISO 4217 Currency Code

Currency for the listing

Обязательно
description
string

Description of the home listing

home_listing_id
string

ID of the home listing

Обязательно
images
list<Object>

Links to home listing images. Please note that carousel format utilizes a square 1:1 aspect ratio images (recommended size - 600x600px) while single hotel ad uses 1.91:1 aspect ratio image(recommended size - 1200x630px). Please provide at least one image.

Обязательно
image_url
URL

Обязательно
tags
list<string>

listing_type
string

Listing type of the property

name
string

Name of the home listing

Обязательно
num_baths
float

Number of baths for the home listing

num_beds
float

Number of beds for the home listing

num_units
float

Number of units for the home listing

price
float

The price for this home listing

Обязательно
property_type
string

Property type of the home listing

url
URL

Link to the external site where you can view the listing

Обязательно
year_built
int64

Year built

Обязательно

Тип возврата

Эта конечная точка поддерживаетчтение после записи и будет считывать узел, представленный id в типе возврата.
Struct {
id: numeric string,
}

Error Codes

ОшибкаОписание
100Invalid parameter

Обновление

Нельзя выполнить эту операцию в этой конечной точке.

Удаление

Нельзя выполнить эту операцию в этой конечной точке.