Перейти к содержанию

realty

Источник API: Аналитикапонедвижимости.json, Краткосрочнаяаренда.json.

Enum

Пакет realty.

RealtyAnalyticsReport dataclass

RealtyAnalyticsReport(
    transport: Transport,
    item_id: int | str | None = None,
    user_id: int | str | None = None,
)

Bases: DomainObject

Доменный объект аналитики по недвижимости.

get_market_price_correspondence

get_market_price_correspondence(
    *, item_id: int | str | None = None, price: int | str
) -> RealtyMarketPriceInfo

Выполняет публичную операцию RealtyAnalyticsReport.get_market_price_correspondence и возвращает типизированную SDK-модель.

Пустой результат возвращается как пустая коллекция или None согласно аннотации метода.

Raises: AvitoError с полями operation, status, request_id, attempt, method и endpoint.

get_report_for_classified

get_report_for_classified(
    *, item_id: int | str | None = None
) -> RealtyAnalyticsInfo

Выполняет публичную операцию RealtyAnalyticsReport.get_report_for_classified и возвращает типизированную SDK-модель.

Пустой результат возвращается как пустая коллекция или None согласно аннотации метода.

Raises: AvitoError с полями operation, status, request_id, attempt, method и endpoint.

RealtyBooking dataclass

RealtyBooking(
    transport: Transport,
    item_id: int | str | None = None,
    user_id: int | str | None = None,
)

Bases: DomainObject

Доменный объект бронирований недвижимости.

update_bookings_info

update_bookings_info(
    *,
    blocked_dates: list[str],
    user_id: int | str | None = None,
    item_id: int | str | None = None,
) -> RealtyActionResult

Выполняет публичную операцию RealtyBooking.update_bookings_info и возвращает типизированную SDK-модель.

Пустой результат возвращается как пустая коллекция или None согласно аннотации метода.

Raises: AvitoError с полями operation, status, request_id, attempt, method и endpoint.

list_realty_bookings

list_realty_bookings(
    *,
    date_start: str,
    date_end: str,
    with_unpaid: bool | None = None,
    user_id: int | str | None = None,
    item_id: int | str | None = None,
) -> RealtyBookingsResult

Выполняет публичную операцию RealtyBooking.list_realty_bookings и возвращает типизированную SDK-модель.

Пустой результат возвращается как пустая коллекция или None согласно аннотации метода.

Raises: AvitoError с полями operation, status, request_id, attempt, method и endpoint.

RealtyListing dataclass

RealtyListing(
    transport: Transport,
    item_id: int | str | None = None,
    user_id: int | str | None = None,
)

Bases: DomainObject

Доменный объект объявления краткосрочной аренды.

get_intervals

get_intervals(
    *,
    intervals: list[RealtyInterval],
    item_id: int | None = None,
) -> RealtyActionResult

Выполняет публичную операцию RealtyListing.get_intervals и возвращает типизированную SDK-модель.

Пустой результат возвращается как пустая коллекция или None согласно аннотации метода.

Raises: AvitoError с полями operation, status, request_id, attempt, method и endpoint.

update_base_params

update_base_params(
    *, min_stay_days: int, item_id: int | str | None = None
) -> RealtyActionResult

Выполняет публичную операцию RealtyListing.update_base_params и возвращает типизированную SDK-модель.

Пустой результат возвращается как пустая коллекция или None согласно аннотации метода.

Raises: AvitoError с полями operation, status, request_id, attempt, method и endpoint.

RealtyPricing dataclass

RealtyPricing(
    transport: Transport,
    item_id: int | str | None = None,
    user_id: int | str | None = None,
)

Bases: DomainObject

Доменный объект цен краткосрочной аренды.

update_realty_prices

update_realty_prices(
    *,
    periods: list[RealtyPricePeriod],
    user_id: int | str | None = None,
    item_id: int | str | None = None,
) -> RealtyActionResult

Выполняет публичную операцию RealtyPricing.update_realty_prices и возвращает типизированную SDK-модель.

Пустой результат возвращается как пустая коллекция или None согласно аннотации метода.

Raises: AvitoError с полями operation, status, request_id, attempt, method и endpoint.

RealtyStatus

Bases: str, Enum

Статус сущности realty.

RealtyActionResult dataclass

RealtyActionResult(
    success: bool, status: RealtyStatus | None = None
)

Bases: SerializableModel

Результат mutation-операции по недвижимости.

RealtyAnalyticsInfo dataclass

RealtyAnalyticsInfo(
    success: bool,
    report_link: str | None = None,
    error_message: str | None = None,
)

Bases: SerializableModel

Информация об аналитическом отчете по недвижимости.

RealtyBaseParamsUpdateRequest dataclass

RealtyBaseParamsUpdateRequest(min_stay_days: int)

Запрос обновления базовых параметров объекта.

to_payload

to_payload() -> dict[str, object]

Сериализует JSON payload запроса базовых параметров.

RealtyBookingInfo dataclass

RealtyBookingInfo(
    booking_id: int | None,
    base_price: int | None,
    check_in: str | None,
    check_out: str | None,
    contact: RealtyBookingContact | None,
    guest_count: int | None,
    nights: int | None,
    safe_deposit: RealtyBookingSafeDeposit | None,
    status: RealtyStatus | None,
)

Bases: SerializableModel

Информация о бронировании объекта недвижимости.

RealtyBookingsQuery dataclass

RealtyBookingsQuery(
    date_start: str,
    date_end: str,
    with_unpaid: bool | None = None,
)

Query-параметры запроса бронирований.

to_params

to_params() -> dict[str, str]

Сериализует query-параметры запроса бронирований.

RealtyBookingsResult dataclass

RealtyBookingsResult(items: list[RealtyBookingInfo])

Bases: SerializableModel

Список бронирований по объявлению.

RealtyBookingsUpdateRequest dataclass

RealtyBookingsUpdateRequest(blocked_dates: list[str])

Запрос обновления занятости по объекту.

to_payload

to_payload() -> dict[str, object]

Сериализует JSON payload запроса бронирований.

RealtyInterval dataclass

RealtyInterval(date: str, available: bool)

Интервал доступности объекта.

to_payload

to_payload() -> dict[str, object]

Сериализует интервал доступности.

RealtyIntervalsRequest dataclass

RealtyIntervalsRequest(
    item_id: int, intervals: list[RealtyInterval]
)

Запрос заполнения интервалов доступности.

to_payload

to_payload() -> dict[str, object]

Сериализует JSON payload запроса интервалов.

RealtyMarketPriceInfo dataclass

RealtyMarketPriceInfo(
    correspondence: str | None,
    error_message: str | None = None,
)

Bases: SerializableModel

Соответствие цены рыночной стоимости.

RealtyPricePeriod dataclass

RealtyPricePeriod(date_from: str, price: int)

Период с ценой в запросе обновления цен.

to_payload

to_payload() -> dict[str, object]

Сериализует период с ценой.

RealtyPricesUpdateRequest dataclass

RealtyPricesUpdateRequest(periods: list[RealtyPricePeriod])

Запрос обновления цен по объекту.

to_payload

to_payload() -> dict[str, object]

Сериализует JSON payload запроса цен.