asa-api-client 0.3.0__tar.gz → 0.4.0__tar.gz

{asa_api_client-0.3.0 → asa_api_client-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: asa-api-client
-Version: 0.3.0
+Version: 0.4.0
 Summary: A modern Python client for the Apple Search Ads API with full type safety and async support
 Project-URL: Homepage, https://github.com/SamPetherbridge/asa-api-client
 Project-URL: Documentation, https://asa-api-client.peth.au

{asa_api_client-0.3.0 → asa_api_client-0.4.0}/asa_api_client/__init__.py

@@ -51,4 +51,4 @@ __all__ = [
     "configure_logging",
 ]
 
-__version__ = "0.3.0"
+__version__ = "0.4.0"

{asa_api_client-0.3.0 → asa_api_client-0.4.0}/asa_api_client/cli/analyze.py

@@ -12,7 +12,7 @@ from rich.console import Console
 from rich.progress import BarColumn, Progress, TaskID, TextColumn
 from xlsxwriter.exceptions import XlsxWriterException
 
-from asa_api_client.cli import dates, fetch, metrics, v1_smoke
+from asa_api_client.cli import dates, fetch, metrics, popularity, v1_smoke
 from asa_api_client.cli.v1_adapter import V1FetchAdapter
 from asa_api_client.cli.workbook import SummaryData, write_workbook
 from asa_api_client.client import AppleSearchAdsClient
@@ -210,6 +210,14 @@ def analyze(
         wasted=metrics.wasted_spend(analysis["keywords"]),
     )
 
+    # The popularity sheet is enrichment via the v1 insights API; it
+    # must never break (or fail) an otherwise successful analyze run.
+    try:
+        popularity_frame, popularity_notes = popularity.build_popularity(result)
+    except Exception as exc:  # nothing from this sheet may abort the workbook
+        popularity_frame, popularity_notes = pd.DataFrame(), []
+        _err.print(f"[yellow]Warning:[/yellow] Search Popularity sheet skipped: {exc}")
+
     out_path = output or Path(f"asa-analysis-{file_scope}-{today:%Y-%m-%d}.xlsx")
     notes = {key: lv.notes for key, lv in result.levels.items()}
     try:
@@ -220,6 +228,8 @@ def analyze(
             daily=daily_frames,
             notes=notes,
             currency_format=fmt,
+            popularity=popularity_frame,
+            popularity_notes=popularity_notes,
         )
     except (OSError, XlsxWriterException) as exc:
         raise _fail(f"Could not write {out_path}: {exc}") from exc

asa_api_client-0.4.0/asa_api_client/cli/popularity.py

@@ -0,0 +1,258 @@
+"""Search Popularity enrichment for the analyze command.
+
+Matches the organization's keywords and search terms against Apple's
+search-term-popularity insights (Apple Ads Platform API v1) to show how
+much App Store search volume each term actually carries.
+
+Live-API behavior this module works around (documented in
+:mod:`asa_api_client.v1.resources.insights`):
+
+- Any ``filters`` in the request make the API return zero rows, so the
+  query is always unfiltered and matching happens client-side.
+- Weekly windows must start on a Sunday, so the query targets the most
+  recent complete Sun-Sat week.
+- Data is published with roughly a week's lag, so an empty latest week
+  falls back exactly one week and retries once.
+
+Failures never propagate: any API or configuration problem degrades to
+an empty frame plus an explanatory note.
+"""
+
+import os
+from collections.abc import Callable
+from datetime import UTC, date, datetime, timedelta
+
+import pandas as pd
+
+from asa_api_client.cli import fetch
+from asa_api_client.exceptions import AppleSearchAdsError
+from asa_api_client.v1.client import AppleAdsClient
+from asa_api_client.v1.models.insights import (
+    SearchTermPopularityGranularity,
+    SearchTermPopularityQueryRequest,
+    SearchTermPopularityRow,
+    SearchTermPopularityTimeRange,
+)
+
+POPULARITY_COLUMNS: list[str] = [
+    "search_term",
+    "source",
+    "country_or_region",
+    "genre",
+    "rank_in_genre",
+    "search_popularity_1_to_100",
+    "search_popularity_1_to_5",
+]
+
+_FIELDS = (
+    "rankInGenre",
+    "searchPopularityInGenre",
+    "searchPopularity1to100",
+    "searchPopularity1to5",
+)
+
+_NO_MATCH_NOTE = (
+    "No account keywords or search terms meet Apple's ≥500 searches/week popularity floor."
+)
+
+
+class _SkipPopularity(Exception):
+    """The sheet cannot be built; the message is the explanatory note."""
+
+
+def latest_complete_week(today: date) -> tuple[date, date]:
+    """Find the most recent complete Sun-Sat week ending before today.
+
+    Args:
+        today: The current date.
+
+    Returns:
+        The inclusive ``(sunday, saturday)`` pair of the latest Sun-Sat
+        week whose Saturday is at least one day in the past.
+    """
+    reference = today - timedelta(days=1)
+    saturday = reference - timedelta(days=(reference.weekday() - 5) % 7)
+    return saturday - timedelta(days=6), saturday
+
+
+def _level_terms(result: fetch.FetchResult, level: str, column: str) -> set[str]:
+    """Collect lowercased distinct term texts from one level frame.
+
+    Args:
+        result: The fetched analyze data.
+        level: The level key (e.g. ``"keywords"``).
+        column: The term column on that level's daily frame.
+
+    Returns:
+        The distinct non-empty terms, lowercased. Empty when the level,
+        its frame, or the column is missing.
+    """
+    data = result.levels.get(level)
+    if data is None or data.daily.empty or column not in data.daily.columns:
+        return set()
+    return {str(value).lower() for value in data.daily[column].dropna() if str(value)}
+
+
+def _resolve_account(client: AppleAdsClient) -> str | None:
+    """Ensure the client has an ad account, auto-selecting from ACLs.
+
+    Prefers the ACL ad account whose ID equals ``ASA_ORG_ID`` (orgs and
+    their primary ad accounts commonly share an ID); otherwise a single
+    accessible account is used.
+
+    Args:
+        client: The v1 API client.
+
+    Returns:
+        A note describing the auto-selection, or None when the client
+        already had an account configured.
+
+    Raises:
+        _SkipPopularity: When no account can be selected unambiguously.
+    """
+    if client.ad_account_id is not None:
+        return None
+    accounts = [
+        acl.ad_account
+        for acl in client.acls.list()
+        if acl.ad_account is not None and acl.ad_account.id is not None
+    ]
+    org_id = os.environ.get("ASA_ORG_ID")
+    selected = next((a for a in accounts if str(a.id) == org_id), None) if org_id else None
+    if selected is None and len(accounts) == 1:
+        selected = accounts[0]
+    if selected is None:
+        raise _SkipPopularity(
+            "Search Popularity skipped: ASA_AD_ACCOUNT_ID is not set and the "
+            f"ad account could not be auto-selected from {len(accounts)} ACL entries."
+        )
+    client.ad_account_id = str(selected.id)
+    return f"Ad account {selected.id} ({selected.name}) auto-selected for popularity data."
+
+
+def _week_rows(
+    client: AppleAdsClient, sunday: date, saturday: date
+) -> list[SearchTermPopularityRow]:
+    """Query one Sun-Sat week of popularity data, unfiltered.
+
+    Args:
+        client: The v1 API client.
+        sunday: The week's start (must be a Sunday).
+        saturday: The week's end.
+
+    Returns:
+        Every popularity row for the week across all storefronts.
+    """
+    request = SearchTermPopularityQueryRequest(
+        fields=list(_FIELDS),
+        time_range=SearchTermPopularityTimeRange(
+            start=sunday,
+            end=saturday,
+            granularity=SearchTermPopularityGranularity.WEEKLY_SUN_SAT,
+        ),
+    )
+    return list(client.insights.query_search_term_popularity(request))
+
+
+def _match(
+    rows: list[SearchTermPopularityRow], keyword_terms: set[str], search_terms: set[str]
+) -> pd.DataFrame:
+    """Keep the popularity rows whose term the org bids on or matched.
+
+    Args:
+        rows: All popularity rows for the queried week.
+        keyword_terms: Lowercased keyword texts from the keywords level.
+        search_terms: Lowercased texts from the search-terms level.
+
+    Returns:
+        The matched rows with :data:`POPULARITY_COLUMNS`, sorted by
+        overall popularity (desc) then in-genre rank (asc).
+    """
+    records: list[dict[str, object]] = []
+    for row in rows:
+        term = (row.search_term or "").lower()
+        in_keywords = term in keyword_terms
+        in_search_terms = term in search_terms
+        if not term or not (in_keywords or in_search_terms):
+            continue
+        if in_keywords and in_search_terms:
+            source = "Both"
+        else:
+            source = "Keywords" if in_keywords else "Search Terms"
+        records.append(
+            {
+                "search_term": row.search_term,
+                "source": source,
+                "country_or_region": row.country_or_region,
+                "genre": row.genre,
+                "rank_in_genre": row.rank_in_genre,
+                "search_popularity_1_to_100": row.search_popularity_1_to_100,
+                "search_popularity_1_to_5": row.search_popularity_1_to_5,
+            }
+        )
+    frame = pd.DataFrame(records, columns=POPULARITY_COLUMNS)
+    if frame.empty:
+        return frame
+    return frame.sort_values(
+        by=["search_popularity_1_to_100", "rank_in_genre"],
+        ascending=[False, True],
+        na_position="last",
+        kind="mergesort",
+    ).reset_index(drop=True)
+
+
+def build_popularity(
+    result: fetch.FetchResult,
+    *,
+    client_factory: Callable[[], AppleAdsClient] | None = None,
+    today: date | None = None,
+) -> tuple[pd.DataFrame, list[str]]:
+    """Build the Search Popularity frame for an analyze run.
+
+    Collects the org's keyword and search-term texts from ``result``,
+    queries one week of search-term popularity via the v1 API (falling
+    back one week when the latest week has no data yet), and keeps the
+    rows matching the org's terms across all storefronts.
+
+    Args:
+        result: The fetched analyze data (term sources).
+        client_factory: Zero-argument v1 client factory; defaults to
+            :meth:`AppleAdsClient.from_env`. The client is closed before
+            returning.
+        today: The current date; defaults to today (UTC).
+
+    Returns:
+        Tuple of (popularity frame with :data:`POPULARITY_COLUMNS`,
+        notes for the sheet). On any API or configuration failure the
+        frame is empty and the notes explain why — this function never
+        raises for those errors.
+    """
+    keyword_terms = _level_terms(result, "keywords", "keyword")
+    search_terms = _level_terms(result, "search_terms", "search_term_text")
+    if not (keyword_terms or search_terms):
+        return pd.DataFrame(columns=POPULARITY_COLUMNS), [
+            "No keywords or search terms in scope; popularity lookup skipped."
+        ]
+
+    factory = client_factory or AppleAdsClient.from_env
+    try:
+        with factory() as client:
+            account_note = _resolve_account(client)
+            sunday, saturday = latest_complete_week(today or datetime.now(tz=UTC).date())
+            rows = _week_rows(client, sunday, saturday)
+            if not rows:
+                sunday -= timedelta(days=7)
+                saturday -= timedelta(days=7)
+                rows = _week_rows(client, sunday, saturday)
+    except _SkipPopularity as exc:
+        return pd.DataFrame(columns=POPULARITY_COLUMNS), [str(exc)]
+    except AppleSearchAdsError as exc:
+        return pd.DataFrame(columns=POPULARITY_COLUMNS), [f"Search Popularity unavailable: {exc}"]
+
+    notes = [f"Popularity week: {sunday} – {saturday}"]  # noqa: RUF001
+    if account_note is not None:
+        notes.append(account_note)
+    frame = _match(rows, keyword_terms, search_terms)
+    if frame.empty:
+        notes.append(_NO_MATCH_NOTE)
+    return frame, notes

{asa_api_client-0.3.0 → asa_api_client-0.4.0}/asa_api_client/cli/workbook.py

@@ -90,6 +90,17 @@ ANALYSIS_COLUMNS: dict[str, list[tuple[str, str, str]]] = {
     ],
 }
 
+POPULARITY_SHEET = "Search Popularity"
+_POPULARITY_SPEC: list[tuple[str, str, str]] = [
+    ("search_term", "Search Term", "text"),
+    ("source", "Source", "text"),
+    ("country_or_region", "Country/Region", "text"),
+    ("genre", "Genre", "text"),
+    ("rank_in_genre", "Rank in Genre", "int"),
+    ("search_popularity_1_to_100", "Popularity (1-100)", "int"),
+    ("search_popularity_1_to_5", "Popularity (1-5)", "int"),
+]
+
 _COLUMN_WIDTHS = {"text": 28, "id": 12, "int": 12, "currency": 12, "percent": 9}
 _TAB_GREY = "#9CA3AF"
 
@@ -406,6 +417,8 @@ def write_workbook(
     daily: dict[str, pd.DataFrame],
     notes: dict[str, list[str]],
     currency_format: str = "$#,##0.00",
+    popularity: pd.DataFrame | None = None,
+    popularity_notes: list[str] | None = None,
 ) -> None:
     """Write the full analysis workbook to ``path``.
 
@@ -416,6 +429,10 @@ def write_workbook(
         daily: Normalized daily frames keyed by level key.
         notes: Per-level notes rendered above the daily tables.
         currency_format: Excel number format for money cells.
+        popularity: Optional Search Popularity frame; the sheet is
+            written when the frame has rows or ``popularity_notes`` has
+            entries, and omitted entirely when ``popularity`` is None.
+        popularity_notes: Notes rendered above the popularity table.
     """
     book = xlsxwriter.Workbook(str(path), {"nan_inf_to_errors": True})
     try:
@@ -431,6 +448,13 @@ def write_workbook(
                 fmts,
                 cpa_benchmark,
             )
+        if popularity is not None and (not popularity.empty or popularity_notes):
+            ws = book.add_worksheet(POPULARITY_SHEET)
+            start = 0
+            for note in popularity_notes or []:
+                ws.write_string(start, 0, note, fmts["note"])
+                start += 1
+            _write_table(ws, popularity, _POPULARITY_SPEC, fmts, start_row=start)
         for key, label in LEVELS:
             ws = book.add_worksheet(f"Daily · {label}")
             ws.set_tab_color(_TAB_GREY)

{asa_api_client-0.3.0 → asa_api_client-0.4.0}/asa_api_client/client.py

@@ -4,6 +4,7 @@ This module provides the AppleSearchAdsClient class, which is the
 primary interface for interacting with the Apple Search Ads API.
 """
 
+import warnings
 from pathlib import Path
 from types import TracebackType
 from typing import Self
@@ -29,9 +30,15 @@ DEFAULT_BASE_URL = "https://api.searchads.apple.com/api/v5"
 
 
 class AppleSearchAdsClient:
-    """Client for interacting with the Apple Search Ads API.
+    """Client for the legacy Apple Search Ads Campaign Management API v5.
 
-    This is the main entry point for the library. It provides access
+    .. deprecated:: 0.4.0
+        Apple sunsets the Campaign Management API v5 on **2027-01-26**.
+        Migrate to :class:`~asa_api_client.AppleAdsClient` (Platform API
+        v1) — it uses the same credentials. Constructing this client
+        emits a ``DeprecationWarning``.
+
+    This is the v5 entry point for the library. It provides access
     to all API resources through a structured, resource-based interface.
 
     The client supports both synchronous and asynchronous operations.
@@ -125,7 +132,19 @@ class AppleSearchAdsClient:
 
         Raises:
             ConfigurationError: If credentials are invalid or missing.
+
+        Warns:
+            DeprecationWarning: The Campaign Management API v5 sunsets
+                on 2027-01-26; migrate to ``AppleAdsClient``.
         """
+        warnings.warn(
+            "AppleSearchAdsClient targets the Campaign Management API v5, "
+            "which Apple sunsets on 2027-01-26. Migrate to AppleAdsClient "
+            "(Apple Ads Platform API v1) — same credentials; see "
+            "https://asa-api-client.peth.au/guide/platform-api-v1/",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         self.org_id = org_id
         self._base_url = base_url.rstrip("/")
         self._timeout = timeout

{asa_api_client-0.3.0 → asa_api_client-0.4.0}/asa_api_client/v1/models/ad_groups.py

@@ -14,7 +14,17 @@ from enum import StrEnum
 
 from pydantic import Field
 
-from asa_api_client.v1.models.base import Money, V1Model
+from asa_api_client.v1.models.base import V1Model
+from asa_api_client.v1.models.shared import (
+    BidStrategy,
+    TargetingData,
+)
+from asa_api_client.v1.models.shared import (
+    BidStrategyGoal as BidStrategyGoal,
+)
+from asa_api_client.v1.models.shared import (
+    BidStrategyType as BidStrategyType,
+)
 
 
 class PricingModel(StrEnum):
@@ -90,44 +100,6 @@ class AdGroupSystemLimitedStatusReason(StrEnum):
     ADS_LIMITED = "ADS_LIMITED"
 
 
-class BidStrategyType(StrEnum):
-    """Bidding strategy applied to the ad group's auctions."""
-
-    MANUAL_CPT = "MANUAL_CPT"
-    MANUAL_CPM = "MANUAL_CPM"
-    MAX_CONVERSIONS = "MAX_CONVERSIONS"
-    MAX_ENGAGEMENTS = "MAX_ENGAGEMENTS"
-
-
-class BidStrategyGoal(StrEnum):
-    """Optimization goal paired with a bid strategy type.
-
-    Documented pairings: ``MANUAL_CPT`` ↔ ``TAP``, ``MANUAL_CPM`` ↔
-    ``IMPRESSION``, ``MAX_CONVERSIONS`` ↔ ``INSTALL``,
-    ``MAX_ENGAGEMENTS`` ↔ ``TAP``.
-    """
-
-    IMPRESSION = "IMPRESSION"
-    INSTALL = "INSTALL"
-    TAP = "TAP"
-
-
-class TargetingData(V1Model):
-    """Include/exclude value lists for one targeting dimension.
-
-    All values are strings, even numeric IDs and ages (e.g. ``"18"``,
-    ``"123456789"``). Only ``appCategory`` and ``appDownloader``
-    support ``exclude``; other dimensions are include-only.
-
-    Attributes:
-        include: Values to restrict delivery to.
-        exclude: Values to block delivery to.
-    """
-
-    include: list[str] | None = None
-    exclude: list[str] | None = None
-
-
 class AdGroupTargeting(V1Model):
     """Targeting dimensions for an ad group.
 
@@ -168,25 +140,6 @@ class AdGroupTargeting(V1Model):
     location_group: TargetingData | None = Field(default=None, alias="locationGroup")
 
 
-class BidStrategy(V1Model):
-    """Bid strategy for an ad group.
-
-    ``bid_strategy_type`` and ``bid_strategy_goal`` must always be
-    sent together as a documented pairing; omitting one or mismatching
-    them returns an error.
-
-    Attributes:
-        bid_strategy_type: The bidding strategy type.
-        bid_strategy_goal: The optimization goal matching the type.
-        bid: For ``MANUAL_CPT`` the max amount paid per tap; for
-            automated strategies an optional per-auction ceiling.
-    """
-
-    bid_strategy_type: BidStrategyType | None = Field(default=None, alias="bidStrategyType")
-    bid_strategy_goal: BidStrategyGoal | None = Field(default=None, alias="bidStrategyGoal")
-    bid: Money | None = None
-
-
 class AdGroup(V1Model):
     """An ad group as returned by the API.
 

{asa_api_client-0.3.0 → asa_api_client-0.4.0}/asa_api_client/v1/models/budget_orders.py

@@ -13,6 +13,12 @@ from typing import Annotated
 from pydantic import Field, field_serializer
 
 from asa_api_client.v1.models.base import Money, V1Model
+from asa_api_client.v1.models.shared import (
+    InvoiceDetail,
+)
+from asa_api_client.v1.models.shared import (
+    SharedBudgetAssignment as SharedBudgetAssignment,
+)
 
 # The API requires yyyy-MM-dd'T'HH:mm:ss.SSS timestamps in UTC with no
 # timezone suffix.
@@ -91,32 +97,6 @@ class BudgetSystemStatusReason(StrEnum):
     SCHEDULE_PENDING = "SCHEDULE_PENDING"
 
 
-class InvoiceDetail(V1Model):
-    """Billing details for Line of Credit (LOC) accounts.
-
-    Embedded in budget order (and campaign) objects. On budget order
-    creation the API requires ``name``, ``primary_buyer_name``,
-    ``primary_buyer_email``, and ``billing_email``; all fields are
-    modeled optional because responses may omit any of them.
-
-    Attributes:
-        name: Billing contact name (required on budget-order create).
-        client_name: Identifies the advertiser or product. Nullable.
-        primary_buyer_name: Primary buyer's name (required on create).
-        primary_buyer_email: Primary buyer's email address (required
-            on create).
-        order_number: Purchase order (PO) number. Nullable.
-        billing_email: Billing email address (required on create).
-    """
-
-    name: str | None = None
-    client_name: str | None = Field(default=None, alias="clientName")
-    primary_buyer_name: str | None = Field(default=None, alias="primaryBuyerName")
-    primary_buyer_email: str | None = Field(default=None, alias="primaryBuyerEmail")
-    order_number: str | None = Field(default=None, alias="orderNumber")
-    billing_email: str | None = Field(default=None, alias="billingEmail")
-
-
 class InvoiceDetailUpdate(V1Model):
     """Partial update of a budget order's invoice details.
 
@@ -244,19 +224,6 @@ class SharedBudgetUpdate(V1Model):
         return _format_timestamp(value)
 
 
-class SharedBudgetAssignment(V1Model):
-    """Read-only link between a campaign and a budget order.
-
-    Returned only inside a Campaign's ``sharedBudgets`` array; NOT
-    independently addressable via any endpoint.
-
-    Attributes:
-        budget_id: The budget order the campaign is assigned to.
-    """
-
-    budget_id: int | None = Field(default=None, alias="budgetId")
-
-
 class SharedBudgetAssignmentCreate(V1Model):
     """Assignment entry embedded in a CampaignCreate ``sharedBudgets`` array.
 

{asa_api_client-0.3.0 → asa_api_client-0.4.0}/asa_api_client/v1/models/campaigns.py

@@ -13,6 +13,18 @@ from enum import StrEnum
 from pydantic import Field, field_serializer
 
 from asa_api_client.v1.models.base import Money, V1Model
+from asa_api_client.v1.models.shared import (
+    BidStrategy,
+    InvoiceDetail,
+    SharedBudgetAssignment,
+    TargetingData,
+)
+from asa_api_client.v1.models.shared import (
+    BidStrategyGoal as BidStrategyGoal,
+)
+from asa_api_client.v1.models.shared import (
+    BidStrategyType as BidStrategyType,
+)
 
 
 class BillingEvent(StrEnum):
@@ -161,23 +173,6 @@ class SupplyPlacement(StrEnum):
     MAPS_SEARCH_HOME = "MAPS_SEARCH_HOME"
 
 
-class BidStrategyType(StrEnum):
-    """How bids are set in auctions."""
-
-    MANUAL_CPT = "MANUAL_CPT"
-    MANUAL_CPM = "MANUAL_CPM"
-    MAX_CONVERSIONS = "MAX_CONVERSIONS"
-    MAX_ENGAGEMENTS = "MAX_ENGAGEMENTS"
-
-
-class BidStrategyGoal(StrEnum):
-    """The outcome a bid strategy optimizes for."""
-
-    IMPRESSION = "IMPRESSION"
-    INSTALL = "INSTALL"
-    TAP = "TAP"
-
-
 class RegulationType(StrEnum):
     """Regulatory disclosure types."""
 
@@ -198,21 +193,6 @@ class RegulationResponseValue(StrEnum):
     NOT_ANSWERED = "NOT_ANSWERED"
 
 
-class TargetingData(V1Model):
-    """A targeting dimension's include/exclude value sets.
-
-    Campaign-level targeting is include-only: ``exclude`` is unsupported
-    for every campaign targeting dimension (unlike ad-group targeting).
-
-    Attributes:
-        include: Values to target.
-        exclude: Values to exclude (ad-group targeting only).
-    """
-
-    include: list[str] | None = None
-    exclude: list[str] | None = None
-
-
 class CampaignTargeting(V1Model):
     """Campaign-level targeting: supply source, placements, markets.
 
@@ -237,55 +217,6 @@ class DailyBudget(V1Model):
     value: Money | None = None
 
 
-class BidStrategy(V1Model):
-    """How a campaign competes in auctions.
-
-    ``bid_strategy_type`` and ``bid_strategy_goal`` must both be
-    supplied together and match an allowed pairing on create and update.
-
-    Attributes:
-        bid_strategy_type: The bidding type (manual or automated).
-        bid_strategy_goal: The outcome the strategy optimizes for.
-        bid: The bid amount for manual strategies.
-    """
-
-    bid_strategy_type: BidStrategyType | None = Field(default=None, alias="bidStrategyType")
-    bid_strategy_goal: BidStrategyGoal | None = Field(default=None, alias="bidStrategyGoal")
-    bid: Money | None = None
-
-
-class SharedBudgetAssignment(V1Model):
-    """One budget-order assignment in a campaign's ``sharedBudgets``.
-
-    Attributes:
-        budget_id: The assigned budget order's ID.
-    """
-
-    budget_id: int | None = Field(default=None, alias="budgetId")
-
-
-class InvoiceDetail(V1Model):
-    """Invoice billing details for Line of Credit (LOC) accounts.
-
-    ``primary_buyer_name``, ``primary_buyer_email``, and
-    ``billing_email`` are required by the API when creating a campaign
-    on an LOC account.
-
-    Attributes:
-        client_name: Identifies the advertiser or product.
-        primary_buyer_name: The primary buyer's name.
-        primary_buyer_email: The primary buyer's email address.
-        order_number: Purchase order number.
-        billing_email: The billing email address.
-    """
-
-    client_name: str | None = Field(default=None, alias="clientName")
-    primary_buyer_name: str | None = Field(default=None, alias="primaryBuyerName")
-    primary_buyer_email: str | None = Field(default=None, alias="primaryBuyerEmail")
-    order_number: str | None = Field(default=None, alias="orderNumber")
-    billing_email: str | None = Field(default=None, alias="billingEmail")
-
-
 class RegulationResponse(V1Model):
     """A regulatory consent acknowledgment on a campaign.