amazon-creatorsapi-python-sdk 1.0.0__py3-none-any.whl

creatorsapi_python_sdk/models/__init__.py

@@ -0,0 +1,110 @@
+# coding: utf-8
+
+# flake8: noqa
+"""
+Copyright 2025 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+
+Licensed under the Apache License, Version 2.0 (the "License").
+You may not use this file except in compliance with the License.
+A copy of the License is located at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+or in the "license" file accompanying this file. This file is distributed
+on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
+express or implied. See the License for the specific language governing
+permissions and limitations under the License.
+
+"""  # noqa: E501
+
+
+# import models into model package
+from creatorsapi_python_sdk.models.access_denied_exception_response_content import AccessDeniedExceptionResponseContent
+from creatorsapi_python_sdk.models.access_denied_reason import AccessDeniedReason
+from creatorsapi_python_sdk.models.availability import Availability
+from creatorsapi_python_sdk.models.browse_node import BrowseNode
+from creatorsapi_python_sdk.models.browse_node_ancestor import BrowseNodeAncestor
+from creatorsapi_python_sdk.models.browse_node_child import BrowseNodeChild
+from creatorsapi_python_sdk.models.browse_node_info import BrowseNodeInfo
+from creatorsapi_python_sdk.models.browse_nodes_result import BrowseNodesResult
+from creatorsapi_python_sdk.models.by_line_info import ByLineInfo
+from creatorsapi_python_sdk.models.classifications import Classifications
+from creatorsapi_python_sdk.models.condition import Condition
+from creatorsapi_python_sdk.models.content_info import ContentInfo
+from creatorsapi_python_sdk.models.content_rating import ContentRating
+from creatorsapi_python_sdk.models.contributor import Contributor
+from creatorsapi_python_sdk.models.customer_reviews import CustomerReviews
+from creatorsapi_python_sdk.models.deal_details import DealDetails
+from creatorsapi_python_sdk.models.delivery_flag import DeliveryFlag
+from creatorsapi_python_sdk.models.dimension_based_attribute import DimensionBasedAttribute
+from creatorsapi_python_sdk.models.error_data import ErrorData
+from creatorsapi_python_sdk.models.external_ids import ExternalIds
+from creatorsapi_python_sdk.models.feed import Feed
+from creatorsapi_python_sdk.models.get_browse_nodes_request_content import GetBrowseNodesRequestContent
+from creatorsapi_python_sdk.models.get_browse_nodes_resource import GetBrowseNodesResource
+from creatorsapi_python_sdk.models.get_browse_nodes_response_content import GetBrowseNodesResponseContent
+from creatorsapi_python_sdk.models.get_feed_request_content import GetFeedRequestContent
+from creatorsapi_python_sdk.models.get_feed_response_content import GetFeedResponseContent
+from creatorsapi_python_sdk.models.get_items_request_content import GetItemsRequestContent
+from creatorsapi_python_sdk.models.get_items_resource import GetItemsResource
+from creatorsapi_python_sdk.models.get_items_response_content import GetItemsResponseContent
+from creatorsapi_python_sdk.models.get_report_request_content import GetReportRequestContent
+from creatorsapi_python_sdk.models.get_report_response_content import GetReportResponseContent
+from creatorsapi_python_sdk.models.get_variations_request_content import GetVariationsRequestContent
+from creatorsapi_python_sdk.models.get_variations_resource import GetVariationsResource
+from creatorsapi_python_sdk.models.get_variations_response_content import GetVariationsResponseContent
+from creatorsapi_python_sdk.models.image_size import ImageSize
+from creatorsapi_python_sdk.models.image_type import ImageType
+from creatorsapi_python_sdk.models.images import Images
+from creatorsapi_python_sdk.models.internal_server_exception_response_content import InternalServerExceptionResponseContent
+from creatorsapi_python_sdk.models.item import Item
+from creatorsapi_python_sdk.models.item_info import ItemInfo
+from creatorsapi_python_sdk.models.items_result import ItemsResult
+from creatorsapi_python_sdk.models.language_type import LanguageType
+from creatorsapi_python_sdk.models.languages import Languages
+from creatorsapi_python_sdk.models.list_feeds_response_content import ListFeedsResponseContent
+from creatorsapi_python_sdk.models.list_reports_response_content import ListReportsResponseContent
+from creatorsapi_python_sdk.models.manufacture_info import ManufactureInfo
+from creatorsapi_python_sdk.models.money import Money
+from creatorsapi_python_sdk.models.multi_valued_attribute import MultiValuedAttribute
+from creatorsapi_python_sdk.models.offer_availability_v2 import OfferAvailabilityV2
+from creatorsapi_python_sdk.models.offer_condition_v2 import OfferConditionV2
+from creatorsapi_python_sdk.models.offer_listing_v2 import OfferListingV2
+from creatorsapi_python_sdk.models.offer_loyalty_points_v2 import OfferLoyaltyPointsV2
+from creatorsapi_python_sdk.models.offer_merchant_info_v2 import OfferMerchantInfoV2
+from creatorsapi_python_sdk.models.offer_price_v2 import OfferPriceV2
+from creatorsapi_python_sdk.models.offer_saving_basis import OfferSavingBasis
+from creatorsapi_python_sdk.models.offer_savings import OfferSavings
+from creatorsapi_python_sdk.models.offer_type import OfferType
+from creatorsapi_python_sdk.models.offers_v2 import OffersV2
+from creatorsapi_python_sdk.models.product_info import ProductInfo
+from creatorsapi_python_sdk.models.rating import Rating
+from creatorsapi_python_sdk.models.refinement import Refinement
+from creatorsapi_python_sdk.models.refinement_bin import RefinementBin
+from creatorsapi_python_sdk.models.report_metadata import ReportMetadata
+from creatorsapi_python_sdk.models.resource_not_found_exception_response_content import ResourceNotFoundExceptionResponseContent
+from creatorsapi_python_sdk.models.saving_basis_type import SavingBasisType
+from creatorsapi_python_sdk.models.search_items_request_content import SearchItemsRequestContent
+from creatorsapi_python_sdk.models.search_items_resource import SearchItemsResource
+from creatorsapi_python_sdk.models.search_items_response_content import SearchItemsResponseContent
+from creatorsapi_python_sdk.models.search_refinements import SearchRefinements
+from creatorsapi_python_sdk.models.search_result import SearchResult
+from creatorsapi_python_sdk.models.single_boolean_valued_attribute import SingleBooleanValuedAttribute
+from creatorsapi_python_sdk.models.single_integer_valued_attribute import SingleIntegerValuedAttribute
+from creatorsapi_python_sdk.models.single_string_valued_attribute import SingleStringValuedAttribute
+from creatorsapi_python_sdk.models.sort_by import SortBy
+from creatorsapi_python_sdk.models.technical_info import TechnicalInfo
+from creatorsapi_python_sdk.models.throttle_exception_response_content import ThrottleExceptionResponseContent
+from creatorsapi_python_sdk.models.trade_in_info import TradeInInfo
+from creatorsapi_python_sdk.models.trade_in_price import TradeInPrice
+from creatorsapi_python_sdk.models.unauthorized_exception_reason import UnauthorizedExceptionReason
+from creatorsapi_python_sdk.models.unauthorized_exception_response_content import UnauthorizedExceptionResponseContent
+from creatorsapi_python_sdk.models.unit_based_attribute import UnitBasedAttribute
+from creatorsapi_python_sdk.models.validation_exception_field import ValidationExceptionField
+from creatorsapi_python_sdk.models.validation_exception_reason import ValidationExceptionReason
+from creatorsapi_python_sdk.models.validation_exception_response_content import ValidationExceptionResponseContent
+from creatorsapi_python_sdk.models.variation_attribute import VariationAttribute
+from creatorsapi_python_sdk.models.variation_dimension import VariationDimension
+from creatorsapi_python_sdk.models.variation_summary import VariationSummary
+from creatorsapi_python_sdk.models.variations_result import VariationsResult
+from creatorsapi_python_sdk.models.website_sales_rank import WebsiteSalesRank

creatorsapi_python_sdk/models/access_denied_exception_response_content.py

@@ -0,0 +1,97 @@
+# coding: utf-8
+
+"""
+Copyright 2025 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+
+Licensed under the Apache License, Version 2.0 (the "License").
+You may not use this file except in compliance with the License.
+A copy of the License is located at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+or in the "license" file accompanying this file. This file is distributed
+on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
+express or implied. See the License for the specific language governing
+permissions and limitations under the License.
+
+"""  # noqa: E501
+
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field, StrictStr
+from typing import Any, ClassVar, Dict, List, Optional
+from creatorsapi_python_sdk.models.access_denied_reason import AccessDeniedReason
+from typing import Optional, Set
+from typing_extensions import Self
+
+class AccessDeniedExceptionResponseContent(BaseModel):
+    """
+    User does not have sufficient access to perform this action.
+    """ # noqa: E501
+    type: Optional[StrictStr] = Field(default=None, description="The exception type identifier for clients to programmatically identify the exception")
+    message: StrictStr
+    reason: AccessDeniedReason
+    __properties: ClassVar[List[str]] = ["type", "message", "reason"]
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        return self.model_dump_json(by_alias=True, exclude_unset=True)
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of AccessDeniedExceptionResponseContent from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of AccessDeniedExceptionResponseContent from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "type": obj.get("type"),
+            "message": obj.get("message"),
+            "reason": obj.get("reason")
+        })
+        return _obj
+
+

creatorsapi_python_sdk/models/access_denied_reason.py

@@ -0,0 +1,45 @@
+# coding: utf-8
+
+"""
+Copyright 2025 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+
+Licensed under the Apache License, Version 2.0 (the "License").
+You may not use this file except in compliance with the License.
+A copy of the License is located at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+or in the "license" file accompanying this file. This file is distributed
+on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
+express or implied. See the License for the specific language governing
+permissions and limitations under the License.
+
+"""  # noqa: E501
+
+
+
+from __future__ import annotations
+import json
+from enum import Enum
+from typing_extensions import Self
+
+
+class AccessDeniedReason(str, Enum):
+    """
+    Possible reasons for access denial
+    """
+
+    """
+    allowed enum values
+    """
+    ASSOCIATENOTELIGIBLE = 'AssociateNotEligible'
+    AUTHORIZATIONFAILED = 'AuthorizationFailed'
+    OTHER = 'Other'
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Self:
+        """Create an instance of AccessDeniedReason from a JSON string"""
+        return cls(json.loads(json_str))
+
+
+

creatorsapi_python_sdk/models/availability.py

@@ -0,0 +1,44 @@
+# coding: utf-8
+
+"""
+Copyright 2025 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+
+Licensed under the Apache License, Version 2.0 (the "License").
+You may not use this file except in compliance with the License.
+A copy of the License is located at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+or in the "license" file accompanying this file. This file is distributed
+on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
+express or implied. See the License for the specific language governing
+permissions and limitations under the License.
+
+"""  # noqa: E501
+
+
+
+from __future__ import annotations
+import json
+from enum import Enum
+from typing_extensions import Self
+
+
+class Availability(str, Enum):
+    """
+    The availability parameter filters available items on Amazon.
+    """
+
+    """
+    allowed enum values
+    """
+    AVAILABLE = 'Available'
+    INCLUDEOUTOFSTOCK = 'IncludeOutOfStock'
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Self:
+        """Create an instance of Availability from a JSON string"""
+        return cls(json.loads(json_str))
+
+
+

creatorsapi_python_sdk/models/browse_node.py

@@ -0,0 +1,116 @@
+# coding: utf-8
+
+"""
+Copyright 2025 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+
+Licensed under the Apache License, Version 2.0 (the "License").
+You may not use this file except in compliance with the License.
+A copy of the License is located at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+or in the "license" file accompanying this file. This file is distributed
+on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
+express or implied. See the License for the specific language governing
+permissions and limitations under the License.
+
+"""  # noqa: E501
+
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field, StrictBool, StrictFloat, StrictInt, StrictStr
+from typing import Any, ClassVar, Dict, List, Optional, Union
+from creatorsapi_python_sdk.models.browse_node_ancestor import BrowseNodeAncestor
+from creatorsapi_python_sdk.models.browse_node_child import BrowseNodeChild
+from typing import Optional, Set
+from typing_extensions import Self
+
+class BrowseNode(BaseModel):
+    """
+    Container for BrowseNode information which includes BrowseNodeId, DisplayName, ContextFreeName, IsRoot, Ancestor, Children, SalesRank associated, etc.
+    """ # noqa: E501
+    ancestor: Optional[BrowseNodeAncestor] = None
+    children: Optional[List[BrowseNodeChild]] = Field(default=None, description="List of BrowseNode Children for a particular BrowseNode.")
+    context_free_name: Optional[StrictStr] = Field(default=None, description="Indicates a displayable name for a BrowseNode that is fully context free. For e.g. DisplayName of BrowseNodeId: 3060 in US marketplace is 'Orphans & Foster Homes'. One can not infer which root category this browse node belongs to unless we have the ancestry ladder for this browse node i.e. it requires a 'context' for being intuitive. However, the ContextFreeName of this browse node is 'Children's Orphans & Foster Homes Books'. Note that, for a BrowseNode whose DisplayName is already context free will have the same ContextFreeName as DisplayName.", alias="contextFreeName")
+    display_name: Optional[StrictStr] = Field(default=None, description="The display name of the BrowseNode as visible on the Amazon retail website.", alias="displayName")
+    id: Optional[StrictStr] = Field(default=None, description="Indicates the unique identifier of the BrowseNode")
+    is_root: Optional[StrictBool] = Field(default=None, description="Indicates if the current BrowseNode is a root category.", alias="isRoot")
+    sales_rank: Optional[Union[StrictFloat, StrictInt]] = Field(default=None, alias="salesRank")
+    __properties: ClassVar[List[str]] = ["ancestor", "children", "contextFreeName", "displayName", "id", "isRoot", "salesRank"]
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        return self.model_dump_json(by_alias=True, exclude_unset=True)
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of BrowseNode from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        # override the default output from pydantic by calling `to_dict()` of ancestor
+        if self.ancestor:
+            _dict['ancestor'] = self.ancestor.to_dict()
+        # override the default output from pydantic by calling `to_dict()` of each item in children (list)
+        _items = []
+        if self.children:
+            for _item_children in self.children:
+                if _item_children:
+                    _items.append(_item_children.to_dict())
+            _dict['children'] = _items
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of BrowseNode from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "ancestor": BrowseNodeAncestor.from_dict(obj["ancestor"]) if obj.get("ancestor") is not None else None,
+            "children": [BrowseNodeChild.from_dict(_item) for _item in obj["children"]] if obj.get("children") is not None else None,
+            "contextFreeName": obj.get("contextFreeName"),
+            "displayName": obj.get("displayName"),
+            "id": obj.get("id"),
+            "isRoot": obj.get("isRoot"),
+            "salesRank": obj.get("salesRank")
+        })
+        return _obj
+
+

creatorsapi_python_sdk/models/browse_node_ancestor.py

@@ -0,0 +1,103 @@
+# coding: utf-8
+
+"""
+Copyright 2025 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+
+Licensed under the Apache License, Version 2.0 (the "License").
+You may not use this file except in compliance with the License.
+A copy of the License is located at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+or in the "license" file accompanying this file. This file is distributed
+on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
+express or implied. See the License for the specific language governing
+permissions and limitations under the License.
+
+"""  # noqa: E501
+
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field, StrictStr
+from typing import Any, ClassVar, Dict, List, Optional
+from typing import Optional, Set
+from typing_extensions import Self
+
+class BrowseNodeAncestor(BaseModel):
+    """
+    Container for BrowseNode Ancestor information which includes BrowseNodeId, DisplayName, ContextFreeName and Ancestor information if one exists. The container is a ladder containing ancestor information up-to root browse node. That is, the last node in the ladder will be Root Node. Note that a root BrowseNode will not have any ancestor.
+    """ # noqa: E501
+    ancestor: Optional[BrowseNodeAncestor] = None
+    context_free_name: Optional[StrictStr] = Field(default=None, alias="contextFreeName")
+    display_name: Optional[StrictStr] = Field(default=None, alias="displayName")
+    id: Optional[StrictStr] = None
+    __properties: ClassVar[List[str]] = ["ancestor", "contextFreeName", "displayName", "id"]
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        return self.model_dump_json(by_alias=True, exclude_unset=True)
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of BrowseNodeAncestor from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        # override the default output from pydantic by calling `to_dict()` of ancestor
+        if self.ancestor:
+            _dict['ancestor'] = self.ancestor.to_dict()
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of BrowseNodeAncestor from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "ancestor": BrowseNodeAncestor.from_dict(obj["ancestor"]) if obj.get("ancestor") is not None else None,
+            "contextFreeName": obj.get("contextFreeName"),
+            "displayName": obj.get("displayName"),
+            "id": obj.get("id")
+        })
+        return _obj
+
+# TODO: Rewrite to not use raise_errors
+BrowseNodeAncestor.model_rebuild(raise_errors=False)
+

creatorsapi_python_sdk/models/browse_node_child.py

@@ -0,0 +1,96 @@
+# coding: utf-8
+
+"""
+Copyright 2025 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+
+Licensed under the Apache License, Version 2.0 (the "License").
+You may not use this file except in compliance with the License.
+A copy of the License is located at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+or in the "license" file accompanying this file. This file is distributed
+on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
+express or implied. See the License for the specific language governing
+permissions and limitations under the License.
+
+"""  # noqa: E501
+
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field, StrictStr
+from typing import Any, ClassVar, Dict, List, Optional
+from typing import Optional, Set
+from typing_extensions import Self
+
+class BrowseNodeChild(BaseModel):
+    """
+    Container for BrowseNode Child information which contains BrowseNodeId, DisplayName and ContextFreeName information associated with the BrowseNode Child.
+    """ # noqa: E501
+    context_free_name: Optional[StrictStr] = Field(default=None, alias="contextFreeName")
+    display_name: Optional[StrictStr] = Field(default=None, alias="displayName")
+    id: Optional[StrictStr] = None
+    __properties: ClassVar[List[str]] = ["contextFreeName", "displayName", "id"]
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        return self.model_dump_json(by_alias=True, exclude_unset=True)
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of BrowseNodeChild from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of BrowseNodeChild from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "contextFreeName": obj.get("contextFreeName"),
+            "displayName": obj.get("displayName"),
+            "id": obj.get("id")
+        })
+        return _obj
+
+