direct-cli 0.3.0__tar.gz → 0.3.2__tar.gz

{direct_cli-0.3.0 → direct_cli-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: direct-cli
-Version: 0.3.0
+Version: 0.3.2
 Summary: Command-line interface for Yandex Direct API
 Author: axisrow
 License: MIT
@@ -118,6 +118,18 @@ Install with `pip install direct-cli`, then run commands with `direct`.
 Invoking the deprecated `direct-cli` entrypoint exits with
 `use direct instead of direct-cli`.
 
+### Quick Start: Check Balance
+
+Yandex removed the legacy v4 `GetBalance` method. Direct CLI uses the v4 Live
+`AccountManagement` method with `Action=Get` for `direct balance`, returning
+money fields such as `Amount`, `AmountAvailableForTransfer`, and `Currency`.
+
+```bash
+direct balance
+direct balance --logins client-login,other-client --format table
+direct balance --logins client-login --dry-run
+```
+
 ### Global Options
 
 | Option | Description |
@@ -127,6 +139,47 @@ Invoking the deprecated `direct-cli` entrypoint exits with
 | `--profile` | Credential profile name |
 | `--sandbox` | Use sandbox API |
 
+### V4 Live Goals
+
+```bash
+direct v4goals get-stat-goals --campaign-ids 123,456
+direct v4goals get-retargeting-goals --campaign-ids 123,456 --format table
+direct v4goals get-stat-goals --campaign-ids 123 --dry-run
+```
+
+### V4 Live Events
+
+```bash
+direct v4events get-events-log --from 2026-04-14T00:00:00 --to 2026-04-15T00:00:00
+direct v4events get-events-log --from 2026-04-14T00:00:00 --to 2026-04-15T00:00:00 --currency RUB --limit 100 --offset 0 --format table
+```
+
+### V4 Live Finance
+
+`get-credit-limits` requires a financial token and operation number. Pass them
+with `--finance-token` and `--operation-num`, or set
+`YANDEX_DIRECT_FINANCE_TOKEN` and `YANDEX_DIRECT_OPERATION_NUM`.
+Money mutation commands are dry-run-only in this release and always require
+`--dry-run`; dry-run output masks the financial token.
+
+```bash
+direct v4finance get-credit-limits --logins client-login --finance-token FINANCE_TOKEN --operation-num 123
+direct v4finance get-credit-limits --logins client-login,other-client --format table
+direct v4finance check-payment --custom-transaction-id A123456789012345678901234567890B
+direct v4finance transfer-money --from-campaign-id 123 --to-campaign-id 456 --amount 100.50 --finance-token FINANCE_TOKEN --operation-num 123 --dry-run
+direct v4finance pay-campaigns --campaign-id 123 --amount 100.50 --contract-id CONTRACT_ID --pay-method CREDIT --finance-token FINANCE_TOKEN --operation-num 123 --dry-run
+```
+
+### V4 Live Shared Account
+
+Shared-account mutations are dry-run-only in this release and always require
+`--dry-run`.
+
+```bash
+direct v4account enable-shared-account --client-login client-login --dry-run
+direct v4account account-management --action Update --account-id 1327944 --day-budget 100.50 --spend-mode Default --money-in-sms Yes --money-out-sms No --email ops@example.com --money-warning-value 25 --dry-run
+```
+
 ### CLI Convention
 
 The current CLI convention is defined as follows.
@@ -324,6 +377,7 @@ direct keywords delete --id 88888
 ```bash
 # Get a report (saved to file)
 direct reports get --type CAMPAIGN_PERFORMANCE_REPORT --from 2024-01-01 --to 2024-01-31 --name "January Report" --fields "Date,CampaignId,Clicks,Cost" --format csv --output report.csv
+direct reports get --type CUSTOM_REPORT --from 2024-01-01 --to 2024-01-31 --name "Goals Report" --fields "Date,CampaignId,GoalsRoi" --goals 12345,67890 --attribution-models AUTO --format csv --output goals-report.csv
 
 # List available report types
 direct reports list-types
@@ -489,9 +543,9 @@ Current command surface:
 | WSDL-backed API services | 29 |
 | Supported API services including Reports | 30 |
 | WSDL operations | 112 |
-| CLI groups including `auth` | 31 |
-| CLI subcommands including `auth` | 122 |
-| API CLI subcommands excluding `auth` | 118 |
+| CLI groups including `auth` | 39 |
+| CLI subcommands including `auth` | 130 |
+| API CLI subcommands excluding `auth` | 126 |
 
 ### API Coverage And Drift Monitoring
 
@@ -946,6 +1000,7 @@ direct keywords delete --id 88888
 ```bash
 # Сформировать отчёт (сохраняется в файл)
 direct reports get --type CAMPAIGN_PERFORMANCE_REPORT --from 2024-01-01 --to 2024-01-31 --name "Отчёт за январь" --fields "Date,CampaignId,Clicks,Cost" --format csv --output report.csv
+direct reports get --type CUSTOM_REPORT --from 2024-01-01 --to 2024-01-31 --name "Отчёт по целям" --fields "Date,CampaignId,GoalsRoi" --goals 12345,67890 --attribution-models AUTO --format csv --output goals-report.csv
 
 # Список доступных типов отчётов
 direct reports list-types
@@ -1112,9 +1167,9 @@ YANDEX_DIRECT_LIVE_WRITE=1 pytest -m integration_live_write -v --record-mode=rew
 | WSDL-backed API services | 29 |
 | API services с учётом Reports | 30 |
 | WSDL operations | 112 |
-| CLI groups с `auth` | 31 |
-| CLI subcommands с `auth` | 122 |
-| API CLI subcommands без `auth` | 118 |
+| CLI groups с `auth` | 39 |
+| CLI subcommands с `auth` | 130 |
+| API CLI subcommands без `auth` | 126 |
 
 #### Live sandbox write smoke
 

{direct_cli-0.3.0 → direct_cli-0.3.2}/README.md

@@ -79,6 +79,18 @@ Install with `pip install direct-cli`, then run commands with `direct`.
 Invoking the deprecated `direct-cli` entrypoint exits with
 `use direct instead of direct-cli`.
 
+### Quick Start: Check Balance
+
+Yandex removed the legacy v4 `GetBalance` method. Direct CLI uses the v4 Live
+`AccountManagement` method with `Action=Get` for `direct balance`, returning
+money fields such as `Amount`, `AmountAvailableForTransfer`, and `Currency`.
+
+```bash
+direct balance
+direct balance --logins client-login,other-client --format table
+direct balance --logins client-login --dry-run
+```
+
 ### Global Options
 
 | Option | Description |
@@ -88,6 +100,47 @@ Invoking the deprecated `direct-cli` entrypoint exits with
 | `--profile` | Credential profile name |
 | `--sandbox` | Use sandbox API |
 
+### V4 Live Goals
+
+```bash
+direct v4goals get-stat-goals --campaign-ids 123,456
+direct v4goals get-retargeting-goals --campaign-ids 123,456 --format table
+direct v4goals get-stat-goals --campaign-ids 123 --dry-run
+```
+
+### V4 Live Events
+
+```bash
+direct v4events get-events-log --from 2026-04-14T00:00:00 --to 2026-04-15T00:00:00
+direct v4events get-events-log --from 2026-04-14T00:00:00 --to 2026-04-15T00:00:00 --currency RUB --limit 100 --offset 0 --format table
+```
+
+### V4 Live Finance
+
+`get-credit-limits` requires a financial token and operation number. Pass them
+with `--finance-token` and `--operation-num`, or set
+`YANDEX_DIRECT_FINANCE_TOKEN` and `YANDEX_DIRECT_OPERATION_NUM`.
+Money mutation commands are dry-run-only in this release and always require
+`--dry-run`; dry-run output masks the financial token.
+
+```bash
+direct v4finance get-credit-limits --logins client-login --finance-token FINANCE_TOKEN --operation-num 123
+direct v4finance get-credit-limits --logins client-login,other-client --format table
+direct v4finance check-payment --custom-transaction-id A123456789012345678901234567890B
+direct v4finance transfer-money --from-campaign-id 123 --to-campaign-id 456 --amount 100.50 --finance-token FINANCE_TOKEN --operation-num 123 --dry-run
+direct v4finance pay-campaigns --campaign-id 123 --amount 100.50 --contract-id CONTRACT_ID --pay-method CREDIT --finance-token FINANCE_TOKEN --operation-num 123 --dry-run
+```
+
+### V4 Live Shared Account
+
+Shared-account mutations are dry-run-only in this release and always require
+`--dry-run`.
+
+```bash
+direct v4account enable-shared-account --client-login client-login --dry-run
+direct v4account account-management --action Update --account-id 1327944 --day-budget 100.50 --spend-mode Default --money-in-sms Yes --money-out-sms No --email ops@example.com --money-warning-value 25 --dry-run
+```
+
 ### CLI Convention
 
 The current CLI convention is defined as follows.
@@ -285,6 +338,7 @@ direct keywords delete --id 88888
 ```bash
 # Get a report (saved to file)
 direct reports get --type CAMPAIGN_PERFORMANCE_REPORT --from 2024-01-01 --to 2024-01-31 --name "January Report" --fields "Date,CampaignId,Clicks,Cost" --format csv --output report.csv
+direct reports get --type CUSTOM_REPORT --from 2024-01-01 --to 2024-01-31 --name "Goals Report" --fields "Date,CampaignId,GoalsRoi" --goals 12345,67890 --attribution-models AUTO --format csv --output goals-report.csv
 
 # List available report types
 direct reports list-types
@@ -450,9 +504,9 @@ Current command surface:
 | WSDL-backed API services | 29 |
 | Supported API services including Reports | 30 |
 | WSDL operations | 112 |
-| CLI groups including `auth` | 31 |
-| CLI subcommands including `auth` | 122 |
-| API CLI subcommands excluding `auth` | 118 |
+| CLI groups including `auth` | 39 |
+| CLI subcommands including `auth` | 130 |
+| API CLI subcommands excluding `auth` | 126 |
 
 ### API Coverage And Drift Monitoring
 
@@ -907,6 +961,7 @@ direct keywords delete --id 88888
 ```bash
 # Сформировать отчёт (сохраняется в файл)
 direct reports get --type CAMPAIGN_PERFORMANCE_REPORT --from 2024-01-01 --to 2024-01-31 --name "Отчёт за январь" --fields "Date,CampaignId,Clicks,Cost" --format csv --output report.csv
+direct reports get --type CUSTOM_REPORT --from 2024-01-01 --to 2024-01-31 --name "Отчёт по целям" --fields "Date,CampaignId,GoalsRoi" --goals 12345,67890 --attribution-models AUTO --format csv --output goals-report.csv
 
 # Список доступных типов отчётов
 direct reports list-types
@@ -1073,9 +1128,9 @@ YANDEX_DIRECT_LIVE_WRITE=1 pytest -m integration_live_write -v --record-mode=rew
 | WSDL-backed API services | 29 |
 | API services с учётом Reports | 30 |
 | WSDL operations | 112 |
-| CLI groups с `auth` | 31 |
-| CLI subcommands с `auth` | 122 |
-| API CLI subcommands без `auth` | 118 |
+| CLI groups с `auth` | 39 |
+| CLI subcommands с `auth` | 130 |
+| API CLI subcommands без `auth` | 126 |
 
 #### Live sandbox write smoke
 

{direct_cli-0.3.0 → direct_cli-0.3.2}/direct_cli/_smoke_probes.py

@@ -8,7 +8,11 @@ from typing import Any, Optional
 
 from .api import create_client
 
-VIDEO_CREATIVE_TYPES = {"VIDEO_EXTENSION_CREATIVE", "CPM_VIDEO_CREATIVE"}
+VIDEO_CREATIVE_TYPES = {
+    "VIDEO_EXTENSION_CREATIVE",
+    "CPM_VIDEO_CREATIVE",
+    "CPC_VIDEO_CREATIVE",
+}
 
 
 def _extract_items(response: Any) -> list[dict[str, Any]]:
@@ -18,7 +22,7 @@ def _extract_items(response: Any) -> list[dict[str, Any]]:
 
 
 def _advideo_get_accepts(client: Any, candidate: str) -> bool:
-    """Return whether advideos.get accepts and returns the candidate ID."""
+    """Return whether advideos.get accepts the candidate ID."""
     body = {
         "method": "get",
         "params": {
@@ -28,7 +32,8 @@ def _advideo_get_accepts(client: Any, candidate: str) -> bool:
         },
     }
     try:
-        return bool(_extract_items(client.advideos().post(data=body)))
+        _extract_items(client.advideos().post(data=body))
+        return True
     except Exception:
         return False
 

{direct_cli-0.3.0 → direct_cli-0.3.2}/direct_cli/_vendor/tapi_yandex_direct/__init__.py

@@ -1,7 +1,7 @@
 
 __author__ = 'Pavel Maksimov'
 __email__ = 'vur21@ya.ru'
-__version__ = '2026.4.27'
+__version__ = '2026.4.28'
 
 
 from .resource_mapping import *

{direct_cli-0.3.0 → direct_cli-0.3.2}/direct_cli/_vendor/tapi_yandex_direct/v4/adapter.py

@@ -43,10 +43,14 @@ class V4LiveClientAdapter(JSONAdapterMixin, TapiAdapter):
         token = api_params.get("access_token")
         login = api_params.get("login")
         language = api_params.get("language", "en")
-
-        # Enrich the JSON body with token / locale / login (param.login for
-        # agent calls). format_data_to_request does not see api_params, so we
-        # do this here, after super() has already serialised the user data.
+        finance_token = api_params.get("finance_token")
+        operation_num = api_params.get("operation_num")
+
+        # Enrich the JSON body with top-level v4 Live fields.
+        # format_data_to_request does not see api_params, so we do this here,
+        # after super() has already serialised the user data. Agency/client
+        # selection is transport-level (Client-Login header); method params
+        # must stay schema-shaped.
         raw = params.get("data")
         if raw:
             if isinstance(raw, (bytes, bytearray)):
@@ -66,14 +70,19 @@ class V4LiveClientAdapter(JSONAdapterMixin, TapiAdapter):
                 body.setdefault("token", token)
             if language:
                 body.setdefault("locale", language)
-            if login and isinstance(body.get("param"), dict):
-                body["param"].setdefault("login", login)
+            if finance_token:
+                body.setdefault("finance_token", finance_token)
+            if operation_num is not None:
+                body.setdefault("operation_num", operation_num)
 
             params["data"] = orjson.dumps(body)
 
         if token:
             params["headers"]["Authorization"] = "Bearer {}".format(token)
 
+        if login:
+            params["headers"]["Client-Login"] = login
+
         return params
 
     def format_data_to_request(self, data) -> Optional[bytes]:

{direct_cli-0.3.0 → direct_cli-0.3.2}/direct_cli/_vendor/tapi_yandex_direct/v4/adapter.pyi

@@ -49,6 +49,8 @@ class YandexDirectV4Live:
         language: str = "en",
         retry_if_exceeded_limit: bool = True,
         retries_if_server_error: int = 5,
+        finance_token: Optional[str] = None,
+        operation_num: Optional[int] = None,
     ) -> None: ...
 
     def v4live(self) -> V4LiveExecutor: ...

{direct_cli-0.3.0 → direct_cli-0.3.2}/direct_cli/api.py

@@ -5,6 +5,7 @@ API client wrapper for Direct CLI
 from typing import Optional, Dict, Any, List
 
 from direct_cli._vendor.tapi_yandex_direct import YandexDirect
+from direct_cli._vendor.tapi_yandex_direct.v4 import YandexDirectV4Live
 from .auth import get_credentials
 
 
@@ -67,6 +68,64 @@ def create_client(
     )
 
 
+def create_v4_client(
+    token: Optional[str] = None,
+    login: Optional[str] = None,
+    profile: Optional[str] = None,
+    sandbox: bool = False,
+    op_token_ref: Optional[str] = None,
+    op_login_ref: Optional[str] = None,
+    bw_token_ref: Optional[str] = None,
+    bw_login_ref: Optional[str] = None,
+    language: Optional[str] = None,
+    retry_if_exceeded_limit: bool = True,
+    retries_if_server_error: int = 5,
+    finance_token: Optional[str] = None,
+    operation_num: Optional[int] = None,
+) -> YandexDirectV4Live:
+    """
+    Create YandexDirect v4 Live client.
+
+    Args:
+        token: API access token
+        login: Client login (for agency accounts)
+        profile: Credential profile name
+        sandbox: Use sandbox API
+        op_token_ref: 1Password secret reference for token
+        op_login_ref: 1Password secret reference for login
+        bw_token_ref: Bitwarden item name/ID for token
+        bw_login_ref: Bitwarden item name/ID for login
+        language: API locale
+        retry_if_exceeded_limit: Retry when the API limit is exceeded
+        retries_if_server_error: Number of retries for server errors
+        finance_token: Financial token for v4 Live finance methods
+        operation_num: Financial operation number for v4 Live finance methods
+
+    Returns:
+        YandexDirect v4 Live client instance
+    """
+    final_token, final_login = get_credentials(
+        token,
+        login,
+        profile=profile,
+        op_token_ref=op_token_ref,
+        op_login_ref=op_login_ref,
+        bw_token_ref=bw_token_ref,
+        bw_login_ref=bw_login_ref,
+    )
+
+    return YandexDirectV4Live(
+        access_token=final_token,
+        login=final_login,
+        is_sandbox=sandbox,
+        language=language or "en",
+        retry_if_exceeded_limit=retry_if_exceeded_limit,
+        retries_if_server_error=retries_if_server_error,
+        finance_token=finance_token,
+        operation_num=operation_num,
+    )
+
+
 def fetch_all_pages(
     client: YandexDirect,
     resource_name: str,

{direct_cli-0.3.0 → direct_cli-0.3.2}/direct_cli/cli.py

@@ -41,6 +41,16 @@ from .commands.advideos import advideos
 from .commands.dynamicfeedadtargets import dynamicfeedadtargets
 from .commands.strategies import strategies
 from .commands.auth import auth
+from .commands.balance import balance
+from .commands.v4events import v4events
+from .commands.v4finance import v4finance
+from .commands.v4account import v4account
+from .commands.v4shells import (
+    v4forecast,
+    v4meta,
+    v4wordstat,
+)
+from .commands.v4goals import v4goals
 
 # Load .env file
 load_dotenv()
@@ -173,6 +183,14 @@ for command in (
     advideos,
     dynamicfeedadtargets,
     strategies,
+    balance,
+    v4finance,
+    v4account,
+    v4goals,
+    v4events,
+    v4wordstat,
+    v4forecast,
+    v4meta,
     auth,
 ):
     _register_command(command)

{direct_cli-0.3.0 → direct_cli-0.3.2}/direct_cli/commands/adextensions.py

@@ -6,7 +6,7 @@ import click
 
 from ..api import create_client
 from ..output import format_output, print_error
-from ..utils import get_default_fields, parse_ids
+from ..utils import add_criteria_csv, get_default_fields, parse_ids
 
 
 @click.group()
@@ -17,13 +17,30 @@ def adextensions():
 @adextensions.command()
 @click.option("--ids", help="Comma-separated extension IDs")
 @click.option("--types", help="Filter by types")
+@click.option("--states", help="Comma-separated states")
+@click.option("--statuses", help="Comma-separated statuses")
+@click.option("--modified-since", help="ModifiedSince datetime")
 @click.option("--limit", type=int, help="Limit number of results")
 @click.option("--fetch-all", is_flag=True, help="Fetch all pages")
 @click.option("--format", "output_format", default="json", help="Output format")
 @click.option("--output", help="Output file")
 @click.option("--fields", help="Comma-separated field names")
+@click.option("--dry-run", is_flag=True, help="Show request without sending")
 @click.pass_context
-def get(ctx, ids, types, limit, fetch_all, output_format, output, fields):
+def get(
+    ctx,
+    ids,
+    types,
+    states,
+    statuses,
+    modified_since,
+    limit,
+    fetch_all,
+    output_format,
+    output,
+    fields,
+    dry_run,
+):
     """Get ad extensions"""
     try:
         client = create_client(
@@ -41,6 +58,10 @@ def get(ctx, ids, types, limit, fetch_all, output_format, output, fields):
             criteria["Ids"] = parse_ids(ids)
         if types:
             criteria["Types"] = types.split(",")
+        add_criteria_csv(criteria, "States", states, upper=True)
+        add_criteria_csv(criteria, "Statuses", statuses, upper=True)
+        if modified_since:
+            criteria["ModifiedSince"] = modified_since
 
         params = {"SelectionCriteria": criteria, "FieldNames": field_names}
 
@@ -49,6 +70,10 @@ def get(ctx, ids, types, limit, fetch_all, output_format, output, fields):
 
         body = {"method": "get", "params": params}
 
+        if dry_run:
+            format_output(body, "json", None)
+            return
+
         result = client.adextensions().post(data=body)
 
         if fetch_all:

{direct_cli-0.3.0 → direct_cli-0.3.2}/direct_cli/commands/adgroups.py

@@ -6,7 +6,7 @@ import click
 
 from ..api import create_client
 from ..output import format_output, print_error
-from ..utils import get_default_fields, parse_ids
+from ..utils import add_criteria_csv, get_default_fields, parse_ids
 
 
 @click.group()
@@ -18,26 +18,46 @@ def adgroups():
 @click.option("--ids", help="Comma-separated ad group IDs")
 @click.option("--campaign-ids", help="Comma-separated campaign IDs")
 @click.option("--status", help="Filter by status")
+@click.option("--statuses", help="Comma-separated statuses")
 @click.option("--types", help="Filter by types")
+@click.option("--tag-ids", help="Comma-separated tag IDs")
+@click.option("--tags", help="Comma-separated tag names")
+@click.option("--app-icon-statuses", help="Comma-separated app icon statuses")
+@click.option("--serving-statuses", help="Comma-separated serving statuses")
+@click.option(
+    "--negative-keyword-shared-set-ids",
+    help="Comma-separated negative keyword shared set IDs",
+)
 @click.option("--limit", type=int, help="Limit number of results")
 @click.option("--fetch-all", is_flag=True, help="Fetch all pages")
 @click.option("--format", "output_format", default="json", help="Output format")
 @click.option("--output", help="Output file")
 @click.option("--fields", help="Comma-separated field names")
+@click.option("--dry-run", is_flag=True, help="Show request without sending")
 @click.pass_context
 def get(
     ctx,
     ids,
     campaign_ids,
     status,
+    statuses,
     types,
+    tag_ids,
+    tags,
+    app_icon_statuses,
+    serving_statuses,
+    negative_keyword_shared_set_ids,
     limit,
     fetch_all,
     output_format,
     output,
     fields,
+    dry_run,
 ):
     """Get ad groups"""
+    if status and statuses:
+        raise click.UsageError("--status and --statuses are mutually exclusive")
+
     try:
         client = create_client(
             token=ctx.obj.get("token"),
@@ -54,8 +74,19 @@ def get(
             criteria["CampaignIds"] = parse_ids(campaign_ids)
         if status:
             criteria["Statuses"] = [status]
+        add_criteria_csv(criteria, "Statuses", statuses, upper=True)
         if types:
             criteria["Types"] = types.split(",")
+        add_criteria_csv(criteria, "TagIds", tag_ids, integers=True)
+        add_criteria_csv(criteria, "Tags", tags)
+        add_criteria_csv(criteria, "AppIconStatuses", app_icon_statuses, upper=True)
+        add_criteria_csv(criteria, "ServingStatuses", serving_statuses, upper=True)
+        add_criteria_csv(
+            criteria,
+            "NegativeKeywordSharedSetIds",
+            negative_keyword_shared_set_ids,
+            integers=True,
+        )
 
         params = {"SelectionCriteria": criteria, "FieldNames": field_names}
 
@@ -64,6 +95,10 @@ def get(
 
         body = {"method": "get", "params": params}
 
+        if dry_run:
+            format_output(body, "json", None)
+            return
+
         result = client.adgroups().post(data=body)
 
         if fetch_all:

{direct_cli-0.3.0 → direct_cli-0.3.2}/direct_cli/commands/adimages.py

@@ -6,7 +6,7 @@ import click
 
 from ..api import create_client
 from ..output import format_output, print_error
-from ..utils import get_default_fields, load_base64_file, parse_ids
+from ..utils import add_criteria_csv, get_default_fields, load_base64_file, parse_ids
 
 
 @click.group()
@@ -16,13 +16,27 @@ def adimages():
 
 @adimages.command()
 @click.option("--ids", help="Comma-separated image IDs")
+@click.option("--image-hashes", help="Comma-separated ad image hashes")
+@click.option("--associated", type=click.Choice(["YES", "NO"], case_sensitive=False))
 @click.option("--limit", type=int, help="Limit number of results")
 @click.option("--fetch-all", is_flag=True, help="Fetch all pages")
 @click.option("--format", "output_format", default="json", help="Output format")
 @click.option("--output", help="Output file")
 @click.option("--fields", help="Comma-separated field names")
+@click.option("--dry-run", is_flag=True, help="Show request without sending")
 @click.pass_context
-def get(ctx, ids, limit, fetch_all, output_format, output, fields):
+def get(
+    ctx,
+    ids,
+    image_hashes,
+    associated,
+    limit,
+    fetch_all,
+    output_format,
+    output,
+    fields,
+    dry_run,
+):
     """Get ad images"""
     try:
         client = create_client(
@@ -31,21 +45,28 @@ def get(ctx, ids, limit, fetch_all, output_format, output, fields):
             sandbox=ctx.obj.get("sandbox"),
         )
 
-        field_names = (
-            fields.split(",") if fields else get_default_fields("adimages")
-        )
+        field_names = fields.split(",") if fields else get_default_fields("adimages")
 
         criteria = {}
         if ids:
             criteria["Ids"] = parse_ids(ids)
+        add_criteria_csv(criteria, "AdImageHashes", image_hashes)
+        if associated:
+            criteria["Associated"] = associated.upper()
 
-        params = {"SelectionCriteria": criteria, "FieldNames": field_names}
+        params = {"FieldNames": field_names}
+        if criteria:
+            params["SelectionCriteria"] = criteria
 
         if limit:
             params["Page"] = {"Limit": limit}
 
         body = {"method": "get", "params": params}
 
+        if dry_run:
+            format_output(body, "json", None)
+            return
+
         result = client.adimages().post(data=body)
 
         if fetch_all: