methods ¶

async def list_attributes(
        self,
        iter_: bool = True,
        limit: int = 1000,
        dir_="DESC",
        **kwargs: Unpack[ListAttributesFilter],
) -> list[Product]:
    """
    Получить список аттрибутов товара.
    # Аргументы:
    * dir_ (по умолчанию "desc") - направление сортировки
    * iter_ (по умолчанию True) - необходимо ли получать все объекты,
    итерируясь по страницам
    * limit (по умолчанию 1000) - максимальное количество объектов, которое будет
    получено за один запрос
    * offer_id (опционально) - Фильтр по параметру offer_id.
    Можно передавать список значений.
    * product_id (опционально) - Фильтр по параметру product_id.
    Можно передавать список значений.
    * visibility (опционально - Фильтр по видимости товара
    ([Visibility](enums.md#ozon.product.enums.Visibility)

    # Возвращает: list[[Product](product.md)]
    """

    raw_products = []

    async def make_request(last_id=None):
        resp, decoded_resp = await self.client.post(
            API_PATH["list_product_attributes"],
            data={
                     "limit": limit,
                     "sort_dir": dir_,
                     "filter": kwargs,
                 }
                 | ({"last_id": last_id} if last_id else {}),
        )
        nonlocal raw_products
        raw_products += decoded_resp["result"]
        return resp, decoded_resp

    _, data = await make_request()
    while iter_ and data["last_id"]:
        _, data = await make_request(data["last_id"])

    return [Product.from_dict(raw_product) for raw_product in raw_products]

async def list_info(
        self,
        offer_id: list[str] | None = None,
        product_id: list[int] | None = None,
        sku: list[int] | None = None,
) -> list[Product]:
    """
    Получить список информации о товарах.
    # Аргументы:
    * offer_id - (опционально) список offer_id, по которым требуется получить
    информацию (list[str])
    * product_id - (опционально)  список product_id, по которым требуется получить
    информацию (list[int])
    * sku - (опционально) список sku,  по которым требуется получить информацию
    (list[int])

    # Возвращает: list[[Product](product.md)]
    """
    _, data = await self.client.post(
        API_PATH["list_product_info"],
        data={
            "offer_id": offer_id,
            "product_id": product_id,
            "sku": sku,
        },
    )
    return [
        Product.from_dict(raw_product) for raw_product in data["result"]["items"]
    ]