realty

Публичный доменный пакет SDK: realty.

Enum

• RealtyBookingStatus
• RealtyOperationStatus
• RealtyStatus

Bases: DomainObject

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

get_market_price_correspondence

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

Возвращает соответствие цены объявления рынку недвижимости.

Аргументы

item_id: идентифицирует объявление Авито. price: передает цену для аналитического расчета. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

RealtyMarketPriceInfo с типизированными данными ответа API.

Поведение

timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

get_report_for_classified

get_report_for_classified(
    *,
    item_id: int | str | None = None,
    idempotency_key: str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> RealtyAnalyticsInfo

Возвращает аналитический отчет по объявлению недвижимости.

Аргументы

item_id: идентифицирует объявление Авито. idempotency_key: задает ключ идемпотентности для безопасного повтора write-операции. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

RealtyAnalyticsInfo с типизированными данными ответа API.

Поведение

Без idempotency_key write-вызов не повторяется при сетевых ошибках. timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

Bases: DomainObject

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

update_bookings_info

update_bookings_info(
    *,
    blocked_dates: list[DateInput],
    user_id: int | str | None = None,
    item_id: int | str | None = None,
    idempotency_key: str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> RealtyActionResult

Обновляет информацию о бронированиях недвижимости.

Аргументы

blocked_dates: передает заблокированные даты бронирования. user_id: идентифицирует пользователя или аккаунт Авито. item_id: идентифицирует объявление Авито. idempotency_key: задает ключ идемпотентности для безопасного повтора write-операции. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

RealtyActionResult со статусом выполнения операции.

Поведение

Без idempotency_key write-вызов не повторяется при сетевых ошибках. timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

list_realty_bookings

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

Возвращает список realty bookings для бронирований недвижимости.

Аргументы

date_start: задает начальную дату периода бронирований. date_end: задает конечную дату периода бронирований. with_unpaid: включает неоплаченные бронирования в результат. user_id: идентифицирует пользователя или аккаунт Авито. item_id: идентифицирует объявление Авито. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

RealtyBookingsResult с типизированными данными ответа API.

Поведение

timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

Bases: DomainObject

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

get_intervals

get_intervals(
    *,
    intervals: list[RealtyInterval],
    item_id: int | None = None,
    idempotency_key: str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> RealtyActionResult

Возвращает intervals для посутчной аренды.

Аргументы

intervals: передает интервалы доступности объявления. item_id: идентифицирует объявление Авито. idempotency_key: задает ключ идемпотентности для безопасного повтора write-операции. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

RealtyActionResult со статусом выполнения операции.

Поведение

Без idempotency_key write-вызов не повторяется при сетевых ошибках. timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

update_base_params

update_base_params(
    *,
    min_stay_days: int,
    item_id: int | str | None = None,
    idempotency_key: str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> RealtyActionResult

Обновляет base params для посутчной аренды.

Аргументы

min_stay_days: задает минимальное число дней проживания. item_id: идентифицирует объявление Авито. idempotency_key: задает ключ идемпотентности для безопасного повтора write-операции. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

RealtyActionResult со статусом выполнения операции.

Поведение

Без idempotency_key write-вызов не повторяется при сетевых ошибках. timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

Bases: DomainObject

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

update_realty_prices

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

Обновляет realty prices для цен недвижимости.

Аргументы

periods: передает периоды цен. user_id: идентифицирует пользователя или аккаунт Авито. item_id: идентифицирует объявление Авито. idempotency_key: задает ключ идемпотентности для безопасного повтора write-операции. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

RealtyActionResult со статусом выполнения операции.

Поведение

Без idempotency_key write-вызов не повторяется при сетевых ошибках. timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

Bases: AsyncDomainObject

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

get_market_price_correspondence async

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

Возвращает соответствие цены объявления рынку недвижимости асинхронно.

Аргументы

item_id: идентифицирует объявление Авито. price: передает цену для аналитического расчета. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

RealtyMarketPriceInfo с типизированными данными ответа API.

Поведение

timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

get_report_for_classified async

get_report_for_classified(
    *,
    item_id: int | str | None = None,
    idempotency_key: str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> RealtyAnalyticsInfo

Возвращает аналитический отчет по объявлению недвижимости асинхронно.

Аргументы

item_id: идентифицирует объявление Авито. idempotency_key: задает ключ идемпотентности для безопасного повтора write-операции. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

RealtyAnalyticsInfo с типизированными данными ответа API.

Поведение

Без idempotency_key write-вызов не повторяется при сетевых ошибках. timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

Bases: AsyncDomainObject

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

update_bookings_info async

update_bookings_info(
    *,
    blocked_dates: list[DateInput],
    user_id: int | str | None = None,
    item_id: int | str | None = None,
    idempotency_key: str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> RealtyActionResult

Обновляет информацию о бронированиях недвижимости асинхронно.

Аргументы

blocked_dates: передает заблокированные даты бронирования. user_id: идентифицирует пользователя или аккаунт Авито. item_id: идентифицирует объявление Авито. idempotency_key: задает ключ идемпотентности для безопасного повтора write-операции. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

RealtyActionResult со статусом выполнения операции.

Поведение

Без idempotency_key write-вызов не повторяется при сетевых ошибках. timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

list_realty_bookings async

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

Возвращает список realty bookings для бронирований недвижимости асинхронно.

Аргументы

date_start: задает начальную дату периода бронирований. date_end: задает конечную дату периода бронирований. with_unpaid: включает неоплаченные бронирования в результат. user_id: идентифицирует пользователя или аккаунт Авито. item_id: идентифицирует объявление Авито. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

RealtyBookingsResult с типизированными данными ответа API.

Поведение

timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

Bases: AsyncDomainObject

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

get_intervals async

get_intervals(
    *,
    intervals: list[RealtyInterval],
    item_id: int | None = None,
    idempotency_key: str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> RealtyActionResult

Возвращает intervals для посутчной аренды асинхронно.

Аргументы

intervals: передает интервалы доступности объявления. item_id: идентифицирует объявление Авито. idempotency_key: задает ключ идемпотентности для безопасного повтора write-операции. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

RealtyActionResult со статусом выполнения операции.

Поведение

Без idempotency_key write-вызов не повторяется при сетевых ошибках. timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

update_base_params async

update_base_params(
    *,
    min_stay_days: int,
    item_id: int | str | None = None,
    idempotency_key: str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> RealtyActionResult

Обновляет base params для посутчной аренды асинхронно.

Аргументы

min_stay_days: задает минимальное число дней проживания. item_id: идентифицирует объявление Авито. idempotency_key: задает ключ идемпотентности для безопасного повтора write-операции. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

RealtyActionResult со статусом выполнения операции.

Поведение

Без idempotency_key write-вызов не повторяется при сетевых ошибках. timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

Bases: AsyncDomainObject

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

update_realty_prices async

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

Обновляет realty prices для цен недвижимости асинхронно.

Аргументы

periods: передает периоды цен. user_id: идентифицирует пользователя или аккаунт Авито. item_id: идентифицирует объявление Авито. idempotency_key: задает ключ идемпотентности для безопасного повтора write-операции. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

RealtyActionResult со статусом выполнения операции.

Поведение

Без idempotency_key write-вызов не повторяется при сетевых ошибках. timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.