Unified-python-sdk 0.57.40__tar.gz → 0.57.42__tar.gz

{unified_python_sdk-0.57.40 → unified_python_sdk-0.57.42}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Unified-python-sdk
-Version: 0.57.40
+Version: 0.57.42
 Summary: Python Client SDK for Unified.to
 License-File: LICENSE.md
 Author: Unified API Inc.
@@ -331,6 +331,8 @@ asyncio.run(main())
 * [get_ads_group](https://github.com/unified-to/unified-python-sdk/blob/master/./docs/sdks/ads/README.md#get_ads_group) - Retrieve a group
 * [get_ads_insertionorder](https://github.com/unified-to/unified-python-sdk/blob/master/./docs/sdks/ads/README.md#get_ads_insertionorder) - Retrieve an insertionorder
 * [get_ads_organization](https://github.com/unified-to/unified-python-sdk/blob/master/./docs/sdks/ads/README.md#get_ads_organization) - Retrieve an organization
+* [get_ads_promoted](https://github.com/unified-to/unified-python-sdk/blob/master/./docs/sdks/ads/README.md#get_ads_promoted) - Retrieve a promoted
+* [get_ads_target](https://github.com/unified-to/unified-python-sdk/blob/master/./docs/sdks/ads/README.md#get_ads_target) - Retrieve a target
 * [list_ads_ads](https://github.com/unified-to/unified-python-sdk/blob/master/./docs/sdks/ads/README.md#list_ads_ads) - List all ads
 * [list_ads_campaigns](https://github.com/unified-to/unified-python-sdk/blob/master/./docs/sdks/ads/README.md#list_ads_campaigns) - List all campaigns
 * [list_ads_creatives](https://github.com/unified-to/unified-python-sdk/blob/master/./docs/sdks/ads/README.md#list_ads_creatives) - List all creatives
@@ -1462,6 +1464,7 @@ asyncio.run(main())
 
 ### [Promoted](https://github.com/unified-to/unified-python-sdk/blob/master/./docs/sdks/promoted/README.md)
 
+* [get_ads_promoted](https://github.com/unified-to/unified-python-sdk/blob/master/./docs/sdks/promoted/README.md#get_ads_promoted) - Retrieve a promoted
 * [list_ads_promoteds](https://github.com/unified-to/unified-python-sdk/blob/master/./docs/sdks/promoted/README.md#list_ads_promoteds) - List all promoteds
 
 ### [Prompt](https://github.com/unified-to/unified-python-sdk/blob/master/./docs/sdks/prompt/README.md)
@@ -1721,6 +1724,7 @@ asyncio.run(main())
 
 ### [Target](https://github.com/unified-to/unified-python-sdk/blob/master/./docs/sdks/target/README.md)
 
+* [get_ads_target](https://github.com/unified-to/unified-python-sdk/blob/master/./docs/sdks/target/README.md#get_ads_target) - Retrieve a target
 * [list_ads_targets](https://github.com/unified-to/unified-python-sdk/blob/master/./docs/sdks/target/README.md#list_ads_targets) - List all targets
 
 ### [Task](https://github.com/unified-to/unified-python-sdk/blob/master/./docs/sdks/task/README.md)

{unified_python_sdk-0.57.40 → unified_python_sdk-0.57.42}/README-PYPI.md

@@ -312,6 +312,8 @@ asyncio.run(main())
 * [get_ads_group](https://github.com/unified-to/unified-python-sdk/blob/master/./docs/sdks/ads/README.md#get_ads_group) - Retrieve a group
 * [get_ads_insertionorder](https://github.com/unified-to/unified-python-sdk/blob/master/./docs/sdks/ads/README.md#get_ads_insertionorder) - Retrieve an insertionorder
 * [get_ads_organization](https://github.com/unified-to/unified-python-sdk/blob/master/./docs/sdks/ads/README.md#get_ads_organization) - Retrieve an organization
+* [get_ads_promoted](https://github.com/unified-to/unified-python-sdk/blob/master/./docs/sdks/ads/README.md#get_ads_promoted) - Retrieve a promoted
+* [get_ads_target](https://github.com/unified-to/unified-python-sdk/blob/master/./docs/sdks/ads/README.md#get_ads_target) - Retrieve a target
 * [list_ads_ads](https://github.com/unified-to/unified-python-sdk/blob/master/./docs/sdks/ads/README.md#list_ads_ads) - List all ads
 * [list_ads_campaigns](https://github.com/unified-to/unified-python-sdk/blob/master/./docs/sdks/ads/README.md#list_ads_campaigns) - List all campaigns
 * [list_ads_creatives](https://github.com/unified-to/unified-python-sdk/blob/master/./docs/sdks/ads/README.md#list_ads_creatives) - List all creatives
@@ -1443,6 +1445,7 @@ asyncio.run(main())
 
 ### [Promoted](https://github.com/unified-to/unified-python-sdk/blob/master/./docs/sdks/promoted/README.md)
 
+* [get_ads_promoted](https://github.com/unified-to/unified-python-sdk/blob/master/./docs/sdks/promoted/README.md#get_ads_promoted) - Retrieve a promoted
 * [list_ads_promoteds](https://github.com/unified-to/unified-python-sdk/blob/master/./docs/sdks/promoted/README.md#list_ads_promoteds) - List all promoteds
 
 ### [Prompt](https://github.com/unified-to/unified-python-sdk/blob/master/./docs/sdks/prompt/README.md)
@@ -1702,6 +1705,7 @@ asyncio.run(main())
 
 ### [Target](https://github.com/unified-to/unified-python-sdk/blob/master/./docs/sdks/target/README.md)
 
+* [get_ads_target](https://github.com/unified-to/unified-python-sdk/blob/master/./docs/sdks/target/README.md#get_ads_target) - Retrieve a target
 * [list_ads_targets](https://github.com/unified-to/unified-python-sdk/blob/master/./docs/sdks/target/README.md#list_ads_targets) - List all targets
 
 ### [Task](https://github.com/unified-to/unified-python-sdk/blob/master/./docs/sdks/task/README.md)

{unified_python_sdk-0.57.40 → unified_python_sdk-0.57.42}/pyproject.toml

@@ -1,7 +1,7 @@
 
 [project]
 name = "Unified-python-sdk"
-version = "0.57.40"
+version = "0.57.42"
 description = "Python Client SDK for Unified.to"
 authors = [{ name = "Unified API Inc." },]
 readme = "README-PYPI.md"

{unified_python_sdk-0.57.40 → unified_python_sdk-0.57.42}/src/unified_python_sdk/_version.py

@@ -3,10 +3,10 @@
 import importlib.metadata
 
 __title__: str = "Unified-python-sdk"
-__version__: str = "0.57.40"
+__version__: str = "0.57.42"
 __openapi_doc_version__: str = "1.0"
 __gen_version__: str = "2.881.4"
-__user_agent__: str = "speakeasy-sdk/python 0.57.40 2.881.4 1.0 Unified-python-sdk"
+__user_agent__: str = "speakeasy-sdk/python 0.57.42 2.881.4 1.0 Unified-python-sdk"
 
 try:
     if __package__ is not None:

{unified_python_sdk-0.57.40 → unified_python_sdk-0.57.42}/src/unified_python_sdk/ads.py

@@ -2186,6 +2186,362 @@ class Ads(BaseSDK):
 
         raise errors.SDKError("Unexpected response received", http_res)
 
+    def get_ads_promoted(
+        self,
+        *,
+        request: Union[
+            operations.GetAdsPromotedRequest, operations.GetAdsPromotedRequestTypedDict
+        ],
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> operations.GetAdsPromotedResponse:
+        r"""Retrieve a promoted
+
+        :param request: The request object to send.
+        :param retries: Override the default retry configuration for this method
+        :param server_url: Override the default server URL for this method
+        :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
+        :param http_headers: Additional headers to set or replace on requests.
+        """
+        base_url = None
+        url_variables = None
+        if timeout_ms is None:
+            timeout_ms = self.sdk_configuration.timeout_ms
+
+        if server_url is not None:
+            base_url = server_url
+        else:
+            base_url = self._get_url(base_url, url_variables)
+
+        if not isinstance(request, BaseModel):
+            request = utils.unmarshal(request, operations.GetAdsPromotedRequest)
+        request = cast(operations.GetAdsPromotedRequest, request)
+
+        req = self._build_request(
+            method="GET",
+            path="/ads/{connection_id}/promoted/{id}",
+            base_url=base_url,
+            url_variables=url_variables,
+            request=request,
+            request_body_required=False,
+            request_has_path_params=True,
+            request_has_query_params=True,
+            user_agent_header="user-agent",
+            accept_header_value="application/json",
+            http_headers=http_headers,
+            security=self.sdk_configuration.security,
+            allow_empty_value=None,
+            timeout_ms=timeout_ms,
+        )
+
+        if retries == UNSET:
+            if self.sdk_configuration.retry_config is not UNSET:
+                retries = self.sdk_configuration.retry_config
+
+        retry_config = None
+        if isinstance(retries, utils.RetryConfig):
+            retry_config = (retries, ["429", "500", "502", "503", "504"])
+
+        http_res = self.do_request(
+            hook_ctx=HookContext(
+                config=self.sdk_configuration,
+                base_url=base_url or "",
+                operation_id="getAdsPromoted",
+                oauth2_scopes=None,
+                security_source=self.sdk_configuration.security,
+            ),
+            request=req,
+            is_error_status_code=lambda c: utils.match_status_codes(["4XX", "5XX"], c),
+            retry_config=retry_config,
+        )
+
+        if utils.match_response(http_res, "200", "application/json"):
+            return operations.GetAdsPromotedResponse(
+                ads_promoted=unmarshal_json_response(
+                    Optional[shared.AdsPromoted], http_res
+                ),
+                status_code=http_res.status_code,
+                content_type=http_res.headers.get("Content-Type") or "",
+                raw_response=http_res,
+            )
+        if utils.match_response(http_res, "4XX", "*"):
+            http_res_text = utils.stream_to_text(http_res)
+            raise errors.SDKError("API error occurred", http_res, http_res_text)
+        if utils.match_response(http_res, "5XX", "*"):
+            http_res_text = utils.stream_to_text(http_res)
+            raise errors.SDKError("API error occurred", http_res, http_res_text)
+
+        raise errors.SDKError("Unexpected response received", http_res)
+
+    async def get_ads_promoted_async(
+        self,
+        *,
+        request: Union[
+            operations.GetAdsPromotedRequest, operations.GetAdsPromotedRequestTypedDict
+        ],
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> operations.GetAdsPromotedResponse:
+        r"""Retrieve a promoted
+
+        :param request: The request object to send.
+        :param retries: Override the default retry configuration for this method
+        :param server_url: Override the default server URL for this method
+        :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
+        :param http_headers: Additional headers to set or replace on requests.
+        """
+        base_url = None
+        url_variables = None
+        if timeout_ms is None:
+            timeout_ms = self.sdk_configuration.timeout_ms
+
+        if server_url is not None:
+            base_url = server_url
+        else:
+            base_url = self._get_url(base_url, url_variables)
+
+        if not isinstance(request, BaseModel):
+            request = utils.unmarshal(request, operations.GetAdsPromotedRequest)
+        request = cast(operations.GetAdsPromotedRequest, request)
+
+        req = self._build_request_async(
+            method="GET",
+            path="/ads/{connection_id}/promoted/{id}",
+            base_url=base_url,
+            url_variables=url_variables,
+            request=request,
+            request_body_required=False,
+            request_has_path_params=True,
+            request_has_query_params=True,
+            user_agent_header="user-agent",
+            accept_header_value="application/json",
+            http_headers=http_headers,
+            security=self.sdk_configuration.security,
+            allow_empty_value=None,
+            timeout_ms=timeout_ms,
+        )
+
+        if retries == UNSET:
+            if self.sdk_configuration.retry_config is not UNSET:
+                retries = self.sdk_configuration.retry_config
+
+        retry_config = None
+        if isinstance(retries, utils.RetryConfig):
+            retry_config = (retries, ["429", "500", "502", "503", "504"])
+
+        http_res = await self.do_request_async(
+            hook_ctx=HookContext(
+                config=self.sdk_configuration,
+                base_url=base_url or "",
+                operation_id="getAdsPromoted",
+                oauth2_scopes=None,
+                security_source=self.sdk_configuration.security,
+            ),
+            request=req,
+            is_error_status_code=lambda c: utils.match_status_codes(["4XX", "5XX"], c),
+            retry_config=retry_config,
+        )
+
+        if utils.match_response(http_res, "200", "application/json"):
+            return operations.GetAdsPromotedResponse(
+                ads_promoted=unmarshal_json_response(
+                    Optional[shared.AdsPromoted], http_res
+                ),
+                status_code=http_res.status_code,
+                content_type=http_res.headers.get("Content-Type") or "",
+                raw_response=http_res,
+            )
+        if utils.match_response(http_res, "4XX", "*"):
+            http_res_text = await utils.stream_to_text_async(http_res)
+            raise errors.SDKError("API error occurred", http_res, http_res_text)
+        if utils.match_response(http_res, "5XX", "*"):
+            http_res_text = await utils.stream_to_text_async(http_res)
+            raise errors.SDKError("API error occurred", http_res, http_res_text)
+
+        raise errors.SDKError("Unexpected response received", http_res)
+
+    def get_ads_target(
+        self,
+        *,
+        request: Union[
+            operations.GetAdsTargetRequest, operations.GetAdsTargetRequestTypedDict
+        ],
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> operations.GetAdsTargetResponse:
+        r"""Retrieve a target
+
+        :param request: The request object to send.
+        :param retries: Override the default retry configuration for this method
+        :param server_url: Override the default server URL for this method
+        :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
+        :param http_headers: Additional headers to set or replace on requests.
+        """
+        base_url = None
+        url_variables = None
+        if timeout_ms is None:
+            timeout_ms = self.sdk_configuration.timeout_ms
+
+        if server_url is not None:
+            base_url = server_url
+        else:
+            base_url = self._get_url(base_url, url_variables)
+
+        if not isinstance(request, BaseModel):
+            request = utils.unmarshal(request, operations.GetAdsTargetRequest)
+        request = cast(operations.GetAdsTargetRequest, request)
+
+        req = self._build_request(
+            method="GET",
+            path="/ads/{connection_id}/target/{id}",
+            base_url=base_url,
+            url_variables=url_variables,
+            request=request,
+            request_body_required=False,
+            request_has_path_params=True,
+            request_has_query_params=True,
+            user_agent_header="user-agent",
+            accept_header_value="application/json",
+            http_headers=http_headers,
+            security=self.sdk_configuration.security,
+            allow_empty_value=None,
+            timeout_ms=timeout_ms,
+        )
+
+        if retries == UNSET:
+            if self.sdk_configuration.retry_config is not UNSET:
+                retries = self.sdk_configuration.retry_config
+
+        retry_config = None
+        if isinstance(retries, utils.RetryConfig):
+            retry_config = (retries, ["429", "500", "502", "503", "504"])
+
+        http_res = self.do_request(
+            hook_ctx=HookContext(
+                config=self.sdk_configuration,
+                base_url=base_url or "",
+                operation_id="getAdsTarget",
+                oauth2_scopes=None,
+                security_source=self.sdk_configuration.security,
+            ),
+            request=req,
+            is_error_status_code=lambda c: utils.match_status_codes(["4XX", "5XX"], c),
+            retry_config=retry_config,
+        )
+
+        if utils.match_response(http_res, "200", "application/json"):
+            return operations.GetAdsTargetResponse(
+                ads_target=unmarshal_json_response(
+                    Optional[shared.AdsTarget], http_res
+                ),
+                status_code=http_res.status_code,
+                content_type=http_res.headers.get("Content-Type") or "",
+                raw_response=http_res,
+            )
+        if utils.match_response(http_res, "4XX", "*"):
+            http_res_text = utils.stream_to_text(http_res)
+            raise errors.SDKError("API error occurred", http_res, http_res_text)
+        if utils.match_response(http_res, "5XX", "*"):
+            http_res_text = utils.stream_to_text(http_res)
+            raise errors.SDKError("API error occurred", http_res, http_res_text)
+
+        raise errors.SDKError("Unexpected response received", http_res)
+
+    async def get_ads_target_async(
+        self,
+        *,
+        request: Union[
+            operations.GetAdsTargetRequest, operations.GetAdsTargetRequestTypedDict
+        ],
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> operations.GetAdsTargetResponse:
+        r"""Retrieve a target
+
+        :param request: The request object to send.
+        :param retries: Override the default retry configuration for this method
+        :param server_url: Override the default server URL for this method
+        :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
+        :param http_headers: Additional headers to set or replace on requests.
+        """
+        base_url = None
+        url_variables = None
+        if timeout_ms is None:
+            timeout_ms = self.sdk_configuration.timeout_ms
+
+        if server_url is not None:
+            base_url = server_url
+        else:
+            base_url = self._get_url(base_url, url_variables)
+
+        if not isinstance(request, BaseModel):
+            request = utils.unmarshal(request, operations.GetAdsTargetRequest)
+        request = cast(operations.GetAdsTargetRequest, request)
+
+        req = self._build_request_async(
+            method="GET",
+            path="/ads/{connection_id}/target/{id}",
+            base_url=base_url,
+            url_variables=url_variables,
+            request=request,
+            request_body_required=False,
+            request_has_path_params=True,
+            request_has_query_params=True,
+            user_agent_header="user-agent",
+            accept_header_value="application/json",
+            http_headers=http_headers,
+            security=self.sdk_configuration.security,
+            allow_empty_value=None,
+            timeout_ms=timeout_ms,
+        )
+
+        if retries == UNSET:
+            if self.sdk_configuration.retry_config is not UNSET:
+                retries = self.sdk_configuration.retry_config
+
+        retry_config = None
+        if isinstance(retries, utils.RetryConfig):
+            retry_config = (retries, ["429", "500", "502", "503", "504"])
+
+        http_res = await self.do_request_async(
+            hook_ctx=HookContext(
+                config=self.sdk_configuration,
+                base_url=base_url or "",
+                operation_id="getAdsTarget",
+                oauth2_scopes=None,
+                security_source=self.sdk_configuration.security,
+            ),
+            request=req,
+            is_error_status_code=lambda c: utils.match_status_codes(["4XX", "5XX"], c),
+            retry_config=retry_config,
+        )
+
+        if utils.match_response(http_res, "200", "application/json"):
+            return operations.GetAdsTargetResponse(
+                ads_target=unmarshal_json_response(
+                    Optional[shared.AdsTarget], http_res
+                ),
+                status_code=http_res.status_code,
+                content_type=http_res.headers.get("Content-Type") or "",
+                raw_response=http_res,
+            )
+        if utils.match_response(http_res, "4XX", "*"):
+            http_res_text = await utils.stream_to_text_async(http_res)
+            raise errors.SDKError("API error occurred", http_res, http_res_text)
+        if utils.match_response(http_res, "5XX", "*"):
+            http_res_text = await utils.stream_to_text_async(http_res)
+            raise errors.SDKError("API error occurred", http_res, http_res_text)
+
+        raise errors.SDKError("Unexpected response received", http_res)
+
     def list_ads_ads(
         self,
         *,

{unified_python_sdk-0.57.40 → unified_python_sdk-0.57.42}/src/unified_python_sdk/models/operations/__init__.py

@@ -910,6 +910,20 @@ if TYPE_CHECKING:
         GetAdsOrganizationResponse,
         GetAdsOrganizationResponseTypedDict,
     )
+    from .getadspromoted import (
+        GetAdsPromotedQueryParamFields,
+        GetAdsPromotedRequest,
+        GetAdsPromotedRequestTypedDict,
+        GetAdsPromotedResponse,
+        GetAdsPromotedResponseTypedDict,
+    )
+    from .getadstarget import (
+        GetAdsTargetQueryParamFields,
+        GetAdsTargetRequest,
+        GetAdsTargetRequestTypedDict,
+        GetAdsTargetResponse,
+        GetAdsTargetResponseTypedDict,
+    )
     from .getassessmentpackage import (
         GetAssessmentPackageRequest,
         GetAssessmentPackageRequestTypedDict,
@@ -5217,6 +5231,16 @@ __all__ = [
     "GetAdsOrganizationRequestTypedDict",
     "GetAdsOrganizationResponse",
     "GetAdsOrganizationResponseTypedDict",
+    "GetAdsPromotedQueryParamFields",
+    "GetAdsPromotedRequest",
+    "GetAdsPromotedRequestTypedDict",
+    "GetAdsPromotedResponse",
+    "GetAdsPromotedResponseTypedDict",
+    "GetAdsTargetQueryParamFields",
+    "GetAdsTargetRequest",
+    "GetAdsTargetRequestTypedDict",
+    "GetAdsTargetResponse",
+    "GetAdsTargetResponseTypedDict",
     "GetAssessmentPackageRequest",
     "GetAssessmentPackageRequestTypedDict",
     "GetAssessmentPackageResponse",
@@ -8439,6 +8463,16 @@ _dynamic_imports: dict[str, str] = {
     "GetAdsOrganizationRequestTypedDict": ".getadsorganization",
     "GetAdsOrganizationResponse": ".getadsorganization",
     "GetAdsOrganizationResponseTypedDict": ".getadsorganization",
+    "GetAdsPromotedQueryParamFields": ".getadspromoted",
+    "GetAdsPromotedRequest": ".getadspromoted",
+    "GetAdsPromotedRequestTypedDict": ".getadspromoted",
+    "GetAdsPromotedResponse": ".getadspromoted",
+    "GetAdsPromotedResponseTypedDict": ".getadspromoted",
+    "GetAdsTargetQueryParamFields": ".getadstarget",
+    "GetAdsTargetRequest": ".getadstarget",
+    "GetAdsTargetRequestTypedDict": ".getadstarget",
+    "GetAdsTargetResponse": ".getadstarget",
+    "GetAdsTargetResponseTypedDict": ".getadstarget",
     "GetAssessmentPackageRequest": ".getassessmentpackage",
     "GetAssessmentPackageRequestTypedDict": ".getassessmentpackage",
     "GetAssessmentPackageResponse": ".getassessmentpackage",

unified_python_sdk-0.57.42/src/unified_python_sdk/models/operations/getadspromoted.py

@@ -0,0 +1,114 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+
+from __future__ import annotations
+from enum import Enum
+import httpx
+from pydantic import model_serializer
+from typing import List, Optional
+from typing_extensions import Annotated, NotRequired, TypedDict
+from unified_python_sdk.models.shared import adspromoted as shared_adspromoted
+from unified_python_sdk.types import BaseModel, UNSET_SENTINEL
+from unified_python_sdk.utils import (
+    FieldMetadata,
+    PathParamMetadata,
+    QueryParamMetadata,
+)
+
+
+class GetAdsPromotedQueryParamFields(str, Enum):
+    ID = "id"
+    NAME = "name"
+    TYPE = "type"
+    RAW = "raw"
+
+
+class GetAdsPromotedRequestTypedDict(TypedDict):
+    connection_id: str
+    r"""ID of the connection"""
+    id: str
+    r"""ID of the Promoted"""
+    fields: NotRequired[List[GetAdsPromotedQueryParamFields]]
+    r"""Fields to return"""
+    raw: NotRequired[str]
+    r"""Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar"""
+
+
+class GetAdsPromotedRequest(BaseModel):
+    connection_id: Annotated[
+        str, FieldMetadata(path=PathParamMetadata(style="simple", explode=False))
+    ]
+    r"""ID of the connection"""
+
+    id: Annotated[
+        str, FieldMetadata(path=PathParamMetadata(style="simple", explode=False))
+    ]
+    r"""ID of the Promoted"""
+
+    fields: Annotated[
+        Optional[List[GetAdsPromotedQueryParamFields]],
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Fields to return"""
+
+    raw: Annotated[
+        Optional[str],
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar"""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["fields", "raw"])
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k, serialized.get(n))
+
+            if val != UNSET_SENTINEL:
+                if val is not None or k not in optional_fields:
+                    m[k] = val
+
+        return m
+
+
+class GetAdsPromotedResponseTypedDict(TypedDict):
+    content_type: str
+    r"""HTTP response content type for this operation"""
+    status_code: int
+    r"""HTTP response status code for this operation"""
+    raw_response: httpx.Response
+    r"""Raw HTTP response; suitable for custom response parsing"""
+    ads_promoted: NotRequired[shared_adspromoted.AdsPromotedTypedDict]
+    r"""Successful"""
+
+
+class GetAdsPromotedResponse(BaseModel):
+    content_type: str
+    r"""HTTP response content type for this operation"""
+
+    status_code: int
+    r"""HTTP response status code for this operation"""
+
+    raw_response: httpx.Response
+    r"""Raw HTTP response; suitable for custom response parsing"""
+
+    ads_promoted: Optional[shared_adspromoted.AdsPromoted] = None
+    r"""Successful"""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["AdsPromoted"])
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k, serialized.get(n))
+
+            if val != UNSET_SENTINEL:
+                if val is not None or k not in optional_fields:
+                    m[k] = val
+
+        return m