ozonapi-async 0.7.4__tar.gz → 0.8.0__tar.gz

{ozonapi_async-0.7.4 → ozonapi_async-0.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ozonapi-async
-Version: 0.7.4
+Version: 0.8.0
 Summary: Асинхронный клиент для работы с API маркетплейса Ozon
 Author: Alexander Ulianov
 License: MIT
@@ -260,7 +260,7 @@ pytest --cov=ozonapi --cov-report=html
 | ✓ | `/v1/description-category/attribute/values/search` | Поиск по справочным значениям характеристики | `description_category_attribute_values_search()` |
 </details>
 <details>
-<summary>Загрузка и обновление товаров (16)</summary>
+<summary>Загрузка и обновление товаров (17)</summary>
 
 | ✓ | Адрес метода Ozon | Описание метода | Python-метод |
 |---|---|---|---|
@@ -268,7 +268,7 @@ pytest --cov=ozonapi --cov-report=html
 | ✓ | `/v1/product/import/info` | Узнать статус добавления или обновления товара | `product_import_info()` |
 | ✓ | `/v1/product/import-by-sku` | Создать товар по SKU | `product_import_by_sku()` |
 | ✓ | `/v1/product/attributes/update` | Обновить характеристики товара | `product_attributes_update()` |
-| ☐ | `/v1/product/pictures/import` | Загрузить или обновить изображения товара | `product_pictures_import()` |
+| ✓ | `/v1/product/pictures/import` | Загрузить или обновить изображения товара | `product_pictures_import()` |
 | ✓ | `/v3/product/list` | Список товаров | `product_list()` |
 | ✓ | `/v1/product/rating-by-sku` | Получить контент-рейтинг товаров по SKU | `product_rating_by_sku()` |
 | ✓ | `/v3/product/info/list` | Получить информацию о товарах по идентификаторам | `product_info_list()` |

{ozonapi_async-0.7.4 → ozonapi_async-0.8.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ozonapi-async"
-version = "0.7.4"
+version = "0.8.0"
 description = "Асинхронный клиент для работы с API маркетплейса Ozon"
 readme = "readme.md"
 keywords = ["ozon", "api", "async", "ecommerce", "seller", "client"]

{ozonapi_async-0.7.4 → ozonapi_async-0.8.0}/readme.md

@@ -218,7 +218,7 @@ pytest --cov=ozonapi --cov-report=html
 | ✓ | `/v1/description-category/attribute/values/search` | Поиск по справочным значениям характеристики | `description_category_attribute_values_search()` |
 </details>
 <details>
-<summary>Загрузка и обновление товаров (16)</summary>
+<summary>Загрузка и обновление товаров (17)</summary>
 
 | ✓ | Адрес метода Ozon | Описание метода | Python-метод |
 |---|---|---|---|
@@ -226,7 +226,7 @@ pytest --cov=ozonapi --cov-report=html
 | ✓ | `/v1/product/import/info` | Узнать статус добавления или обновления товара | `product_import_info()` |
 | ✓ | `/v1/product/import-by-sku` | Создать товар по SKU | `product_import_by_sku()` |
 | ✓ | `/v1/product/attributes/update` | Обновить характеристики товара | `product_attributes_update()` |
-| ☐ | `/v1/product/pictures/import` | Загрузить или обновить изображения товара | `product_pictures_import()` |
+| ✓ | `/v1/product/pictures/import` | Загрузить или обновить изображения товара | `product_pictures_import()` |
 | ✓ | `/v3/product/list` | Список товаров | `product_list()` |
 | ✓ | `/v1/product/rating-by-sku` | Получить контент-рейтинг товаров по SKU | `product_rating_by_sku()` |
 | ✓ | `/v3/product/info/list` | Получить информацию о товарах по идентификаторам | `product_info_list()` |

{ozonapi_async-0.7.4 → ozonapi_async-0.8.0}/src/ozonapi/__init__.py

@@ -2,7 +2,7 @@
 Асинхронный интерфейс для взаимодействия с API маркетплейса Ozon.
 """
 
-__version__ = "0.7.4"
+__version__ = "0.8.0"
 __author__ = "Alexander Ulianov"
 __repository__ = "https://github.com/a-ulianov/OzonAPI"
 __docs__ = "https://github.com/a-ulianov/OzonAPI#readme"

{ozonapi_async-0.7.4 → ozonapi_async-0.8.0}/src/ozonapi/seller/methods/products.py

@@ -6,7 +6,8 @@ from ..schemas.products import ProductArchiveResponse, ProductArchiveRequest, Pr
     ProductInfoAttributesResponse, ProductInfoListRequest, ProductInfoListResponse, ProductInfoSubscriptionRequest, \
     ProductInfoSubscriptionResponse, ProductListRequest, ProductListResponse, ProductPicturesInfoRequest, \
     ProductPicturesInfoResponse, ProductRatingBySkuRequest, ProductRatingBySkuResponse, ProductRelatedSkuGetRequest, \
-    ProductRelatedSkuGetResponse, ProductUpdateOfferIdRequest, ProductUpdateOfferIdResponse
+    ProductRelatedSkuGetResponse, ProductUpdateOfferIdRequest, ProductUpdateOfferIdResponse, \
+    ProductPicturesImportResponse, ProductPicturesImportRequest
 
 
 class SellerProductAPI(APIManager):
@@ -670,4 +671,65 @@ class SellerProductAPI(APIManager):
             endpoint="product/update/offer-id",
             json=request.model_dump(),
         )
-        return ProductUpdateOfferIdResponse(**response)
+        return ProductUpdateOfferIdResponse(**response)
+
+    async def product_pictures_import(
+        self: "SellerProductAPI", request: ProductPicturesImportRequest
+    ) -> ProductPicturesImportResponse:
+        """Загружает или обновляет изображения товара.
+
+        Notes:
+            • При каждом вызове метода передавайте все изображения, которые должны быть на карточке товара.
+              Например, если вы вызвали метод и загрузили 10 изображений, а затем вызвали метод второй раз
+              и загрузили ещё одно, то все 10 предыдущих сотрутся.
+            • Для загрузки передайте адрес ссылки на изображение в общедоступном облачном хранилище.
+              Формат изображения по ссылке — JPG или PNG.
+            • Изображения в массиве `images` располагайте в соответствии с желаемым порядком на сайте.
+              Главным будет первое изображение в массиве.
+            • Для каждого товара вы можете загрузить до `30` изображений.
+            • Для загрузки изображений 360 используйте поле `images360`, для загрузки маркетингового цвета — `color_image`.
+            • Если вы хотите изменить состав или порядок изображений, получите информацию с помощью метода
+              `product_info_list()` — в нём отображается текущий порядок и состав изображений. Скопируйте
+              данные полей `images`, `images360`, `color_image`, измените и дополните состав или порядок
+              в соответствии с необходимостью.
+            • В ответе метода всегда будет статус `imported` — картинка не обработана. Чтобы посмотреть
+              финальный статус, примерно через 10 секунд вызовите метод `product_pictures_info()`.
+              `* Примечание: Видимо, артефакт в документации, т.к. по факту метод product_pictures_info() не возвращает статусы.`
+            • Финальные статусы загрузки изображений:
+                - `uploaded` — изображение загружено;
+                - `pending` — при загрузке изображения возникла ошибка. Повторите попытку позже.
+
+        References:
+            https://docs.ozon.ru/api/seller/?__rr=1#operation/ProductAPI_ProductImportPictures
+
+        Args:
+            request: Данные для загрузки изображений товара по схеме `ProductPicturesImportRequest`.
+
+        Returns:
+            Результат загрузки изображений с временными статусами по схеме `ProductPicturesImportResponse`.
+
+        Example:
+            async with SellerAPI(client_id, api_key) as api:
+                result = await api.product_pictures_import(
+                    ProductPicturesImportRequest(
+                        product_id=123456789,
+                        color_image="https://example.com/color.jpg",
+                        images=[
+                            "https://example.com/image1.jpg",
+                            "https://example.com/image2.jpg",
+                            "https://example.com/image3.jpg",
+                        ],
+                        images360=[
+                            "https://example.com/360_1.jpg",
+                            "https://example.com/360_2.jpg",
+                        ]
+                    )
+                )
+        """
+        response = await self._request(
+            method="post",
+            api_version="v1",
+            endpoint="product/pictures/import",
+            json=request.model_dump(),
+        )
+        return ProductPicturesImportResponse(**response)

{ozonapi_async-0.7.4 → ozonapi_async-0.8.0}/src/ozonapi/seller/schemas/products/__init__.py

@@ -57,6 +57,8 @@ __all__ = [
     "ProductListResponseItem",
     "ProductListResponseResult",
     "ProductListQuants",
+    "ProductPicturesImportRequest",
+    "ProductPicturesImportResponse",
     "ProductPicturesInfoRequest",
     "ProductPicturesInfoResponse",
     "ProductPicturesInfoItem",
@@ -104,6 +106,7 @@ from .v1__product_info_subscription import (
     ProductInfoSubscriptionRequest,
     ProductInfoSubscriptionItem,
 )
+from .v1__product_pictures_import import ProductPicturesImportResponse, ProductPicturesImportRequest
 from .v1__product_rating_by_sku import (
     ProductRatingBySkuResponse, 
     ProductRatingBySkuRequest,

ozonapi_async-0.8.0/src/ozonapi/seller/schemas/products/v1__product_pictures_import.py

@@ -0,0 +1,85 @@
+"""https://docs.ozon.ru/api/seller/?__rr=1#operation/ProductAPI_ProductImportPictures"""
+from typing import Optional
+
+from pydantic import BaseModel, Field
+
+
+class ProductPicturesImportRequest(BaseModel):
+    """Описывает схему запроса на добавление или обновление изображений в товарной карточке.
+
+    Attributes:
+        color_image: Маркетинговый цвет (опционально)
+        images: Массив ссылок на изображения (опционально, до 30 штук; изображения в массиве расположены в порядке их расположения на сайте; первое изображение в массиве будет главным)
+        images360: Массив изображений 360 (опционально, до 70 штук)
+        product_id: Идентификатор товара в системе продавца — product_id
+    """
+    color_image: Optional[str] = Field(
+        None, description="Маркетинговый цвет."
+    )
+    images: Optional[list[str]] = Field(
+        default_factory=list, description="""
+        Массив ссылок на изображения (до 30 штук; изображения в массиве расположены в порядке их 
+        расположения на сайте; первое изображение в массиве будет главным).
+        """,
+        max_length=30,
+    )
+    images360: Optional[list[str]] = Field(
+        default_factory=list, description="Массив изображений 360 (до 70 штук)",
+        max_length=70,
+    )
+    product_id: int = Field(
+        ..., description="Идентификатор товара в системе продавца."
+    )
+
+
+class ProductPicturesImportPicture(BaseModel):
+    """Описывает схему результата добавления изображения.
+
+    Attributes:
+          is_360: Признак, что картинка — изображение 360
+          is_color: Признак, что картинка — образец цвета
+          is_primary: Признак, что картинка — главное изображение
+          product_id: Идентификатор товара в системе продавца
+          state: Статус загрузки изображения
+          url: Адрес ссылки на изображение в общедоступном облачном хранилище (формат изображения по ссылке — JPG или PNG)
+    """
+    is_360: Optional[bool] = Field(
+        None, description="Признак, что картинка — изображение 360."
+    )
+    is_color: Optional[bool] = Field(
+        None, description="Признак, что картинка — образец цвета."
+    )
+    is_primary: Optional[bool] = Field(
+        None, description="Признак, что картинка — главное изображение."
+    )
+    product_id: int = Field(
+        ..., description="Идентификатор товара в системе продавца."
+    )
+    state: str = Field(
+        ..., description="Статус загрузки изображения."
+    )
+    url: Optional[str] = Field(
+        None, description="Адрес ссылки на изображение в общедоступном облачном хранилище (формат изображения по ссылке — JPG или PNG)."
+    )
+
+
+class ProductPicturesImportResult(BaseModel):
+    """Описывает схему результата добавление изображений.
+
+    Attributes:
+        pictures: Массив признаков загруженного контента, статусов и ссылок на изображения
+    """
+    pictures: list[ProductPicturesImportPicture] = Field(
+        default_factory=list, description="Массив признаков загруженного контента, статусов и ссылок на изображения."
+    )
+
+
+class ProductPicturesImportResponse(BaseModel):
+    """Описывает схему ответа на запрос на добавление или обновление изображений в товарной карточке.
+
+    Attributes:
+        result: Результат работы метода
+    """
+    result: ProductPicturesImportResult = Field(
+        ..., description="Результат работы метода."
+    )

{ozonapi_async-0.7.4 → ozonapi_async-0.8.0}/src/ozonapi_async.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ozonapi-async
-Version: 0.7.4
+Version: 0.8.0
 Summary: Асинхронный клиент для работы с API маркетплейса Ozon
 Author: Alexander Ulianov
 License: MIT
@@ -260,7 +260,7 @@ pytest --cov=ozonapi --cov-report=html
 | ✓ | `/v1/description-category/attribute/values/search` | Поиск по справочным значениям характеристики | `description_category_attribute_values_search()` |
 </details>
 <details>
-<summary>Загрузка и обновление товаров (16)</summary>
+<summary>Загрузка и обновление товаров (17)</summary>
 
 | ✓ | Адрес метода Ozon | Описание метода | Python-метод |
 |---|---|---|---|
@@ -268,7 +268,7 @@ pytest --cov=ozonapi --cov-report=html
 | ✓ | `/v1/product/import/info` | Узнать статус добавления или обновления товара | `product_import_info()` |
 | ✓ | `/v1/product/import-by-sku` | Создать товар по SKU | `product_import_by_sku()` |
 | ✓ | `/v1/product/attributes/update` | Обновить характеристики товара | `product_attributes_update()` |
-| ☐ | `/v1/product/pictures/import` | Загрузить или обновить изображения товара | `product_pictures_import()` |
+| ✓ | `/v1/product/pictures/import` | Загрузить или обновить изображения товара | `product_pictures_import()` |
 | ✓ | `/v3/product/list` | Список товаров | `product_list()` |
 | ✓ | `/v1/product/rating-by-sku` | Получить контент-рейтинг товаров по SKU | `product_rating_by_sku()` |
 | ✓ | `/v3/product/info/list` | Получить информацию о товарах по идентификаторам | `product_info_list()` |

{ozonapi_async-0.7.4 → ozonapi_async-0.8.0}/src/ozonapi_async.egg-info/SOURCES.txt

@@ -80,6 +80,7 @@ src/ozonapi/seller/schemas/products/v1__product_attributes_update.py
 src/ozonapi/seller/schemas/products/v1__product_import_by_sku.py
 src/ozonapi/seller/schemas/products/v1__product_import_info.py
 src/ozonapi/seller/schemas/products/v1__product_info_subscription.py
+src/ozonapi/seller/schemas/products/v1__product_pictures_import.py
 src/ozonapi/seller/schemas/products/v1__product_rating_by_sku.py
 src/ozonapi/seller/schemas/products/v1__product_related_sku_get.py
 src/ozonapi/seller/schemas/products/v1__product_unarchive.py