direct-cli 0.0.0__py3-none-any.whl

direct_cli/commands/bids.py

@@ -0,0 +1,108 @@
+"""
+Bids commands
+"""
+
+import json
+import click
+
+from ..api import create_client
+from ..output import format_output, print_error
+from ..utils import parse_ids
+
+
+@click.group()
+def bids():
+    """Manage bids"""
+    pass
+
+
+@bids.command()
+@click.option("--campaign-ids", help="Comma-separated campaign IDs")
+@click.option("--adgroup-ids", help="Comma-separated ad group IDs")
+@click.option("--keyword-ids", help="Comma-separated keyword 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.pass_context
+def get(
+    ctx, campaign_ids, adgroup_ids, keyword_ids, limit, fetch_all, output_format, output
+):
+    """Get bids"""
+    try:
+        client = create_client(
+            token=ctx.obj.get("token"),
+            login=ctx.obj.get("login"),
+            sandbox=ctx.obj.get("sandbox"),
+        )
+
+        criteria = {}
+        if campaign_ids:
+            criteria["CampaignIds"] = parse_ids(campaign_ids)
+        if adgroup_ids:
+            criteria["AdGroupIds"] = parse_ids(adgroup_ids)
+        if keyword_ids:
+            criteria["KeywordIds"] = parse_ids(keyword_ids)
+
+        params = {
+            "SelectionCriteria": criteria,
+            "FieldNames": ["CampaignId", "AdGroupId", "KeywordId", "Bid"],
+        }
+
+        if limit:
+            params["Page"] = {"Limit": limit}
+
+        body = {"method": "get", "params": params}
+
+        result = client.bids().post(data=body)
+
+        if fetch_all:
+            items = []
+            for item in result().iter_items():
+                items.append(item)
+            format_output(items, output_format, output)
+        else:
+            data = result().extract()
+            format_output(data, output_format, output)
+
+    except Exception as e:
+        print_error(str(e))
+        raise click.Abort()
+
+
+@bids.command()
+@click.option("--campaign-id", required=True, type=int, help="Campaign ID")
+@click.option("--bid", type=float, help="Bid amount")
+@click.option("--json", "extra_json", help="Additional JSON parameters")
+@click.option("--dry-run", is_flag=True, help="Show request without sending")
+@click.pass_context
+def set(ctx, campaign_id, bid, extra_json, dry_run):
+    """Set bids"""
+    try:
+        bid_data = {"CampaignId": campaign_id}
+
+        if bid:
+            bid_data["Bid"] = int(bid * 1000000)
+
+        if extra_json:
+            extra = json.loads(extra_json)
+            bid_data.update(extra)
+
+        body = {"method": "set", "params": {"Bids": [bid_data]}}
+
+        if dry_run:
+            format_output(body, "json", None)
+            return
+
+        client = create_client(
+            token=ctx.obj.get("token"),
+            login=ctx.obj.get("login"),
+            sandbox=ctx.obj.get("sandbox"),
+        )
+
+        result = client.bids().post(data=body)
+        format_output(result().extract(), "json", None)
+
+    except Exception as e:
+        print_error(str(e))
+        raise click.Abort()

direct_cli/commands/businesses.py

@@ -0,0 +1,61 @@
+"""
+Businesses commands
+"""
+
+import click
+
+from ..api import create_client
+from ..output import format_output, print_error
+from ..utils import parse_ids
+
+
+@click.group()
+def businesses():
+    """Manage businesses"""
+    pass
+
+
+@businesses.command()
+@click.option("--ids", help="Comma-separated business 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.pass_context
+def get(ctx, ids, limit, fetch_all, output_format, output, fields):
+    """Get businesses"""
+    try:
+        client = create_client(
+            token=ctx.obj.get("token"),
+            login=ctx.obj.get("login"),
+            sandbox=ctx.obj.get("sandbox"),
+        )
+
+        field_names = fields.split(",") if fields else ["Id", "Name", "Url"]
+
+        criteria = {}
+        if ids:
+            criteria["Ids"] = parse_ids(ids)
+
+        params = {"SelectionCriteria": criteria, "FieldNames": field_names}
+
+        if limit:
+            params["Page"] = {"Limit": limit}
+
+        body = {"method": "get", "params": params}
+
+        result = client.businesses().post(data=body)
+
+        if fetch_all:
+            items = []
+            for item in result().iter_items():
+                items.append(item)
+            format_output(items, output_format, output)
+        else:
+            data = result().extract()
+            format_output(data, output_format, output)
+
+    except Exception as e:
+        print_error(str(e))
+        raise click.Abort()

direct_cli/commands/campaigns.py

@@ -0,0 +1,311 @@
+"""
+Campaigns commands
+"""
+
+import json
+import click
+from typing import Optional, List
+
+from ..api import create_client
+from ..output import format_output, print_error
+from ..utils import (
+    parse_ids,
+    build_selection_criteria,
+    build_common_params,
+    get_default_fields,
+)
+
+
+@click.group()
+def campaigns():
+    """Manage campaigns"""
+    pass
+
+
+@campaigns.command()
+@click.option("--ids", help="Comma-separated campaign IDs")
+@click.option("--status", help="Filter by status (ACTIVE, SUSPENDED, etc.)")
+@click.option("--types", help="Filter by types (TEXT_CAMPAIGN, etc.)")
+@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 (json/table/csv/tsv)",
+)
+@click.option("--output", help="Output file")
+@click.option(
+    "--fields", help="Comma-separated field names (default: all common fields)"
+)
+@click.pass_context
+def get(ctx, ids, status, types, limit, fetch_all, output_format, output, fields):
+    """Get campaigns"""
+    try:
+        client = create_client(
+            token=ctx.obj.get("token"),
+            login=ctx.obj.get("login"),
+            sandbox=ctx.obj.get("sandbox"),
+        )
+
+        # Parse field names
+        field_names = fields.split(",") if fields else get_default_fields("campaigns")
+
+        # Build selection criteria
+        criteria = build_selection_criteria(
+            ids=parse_ids(ids), status=status, types=types
+        )
+
+        # Build params
+        params = build_common_params(
+            criteria=criteria, field_names=field_names, limit=limit
+        )
+
+        body = {"method": "get", "params": params}
+
+        result = client.campaigns().post(data=body)
+
+        if fetch_all:
+            # Get all pages
+            items = []
+            for item in result().iter_items():
+                items.append(item)
+            format_output(items, output_format, output)
+        else:
+            data = result().extract()
+            format_output(data, output_format, output)
+
+    except Exception as e:
+        print_error(str(e))
+        raise click.Abort()
+
+
+@campaigns.command()
+@click.option("--name", required=True, help="Campaign name")
+@click.option("--start-date", required=True, help="Start date (YYYY-MM-DD)")
+@click.option("--type", "campaign_type", default="TEXT_CAMPAIGN", help="Campaign type")
+@click.option("--budget", type=int, help="Daily budget in currency units")
+@click.option("--end-date", help="End date (YYYY-MM-DD)")
+@click.option("--json", "extra_json", help="Additional JSON parameters")
+@click.option("--dry-run", is_flag=True, help="Show request without sending")
+@click.pass_context
+def add(ctx, name, start_date, campaign_type, budget, end_date, extra_json, dry_run):
+    """Add new campaign"""
+    try:
+        campaign_data = {
+            "Name": name,
+            "StartDate": start_date,
+            "TextCampaign": {
+                "BiddingStrategy": {
+                    "Search": {"BiddingStrategyType": "HIGHEST_POSITION"},
+                    "Network": {"BiddingStrategyType": "SERVING_OFF"},
+                },
+                "Settings": [],
+            },
+        }
+
+        if budget:
+            campaign_data["DailyBudget"] = {
+                "Amount": budget * 1000000,
+                "Mode": "STANDARD",
+            }
+
+        if end_date:
+            campaign_data["EndDate"] = end_date
+
+        if extra_json:
+            extra = json.loads(extra_json)
+            campaign_data.update(extra)
+
+        body = {"method": "add", "params": {"Campaigns": [campaign_data]}}
+
+        if dry_run:
+            format_output(body, "json", None)
+            return
+
+        client = create_client(
+            token=ctx.obj.get("token"),
+            login=ctx.obj.get("login"),
+            sandbox=ctx.obj.get("sandbox"),
+        )
+
+        result = client.campaigns().post(data=body)
+        format_output(result().extract(), "json", None)
+
+    except Exception as e:
+        print_error(str(e))
+        raise click.Abort()
+
+
+@campaigns.command()
+@click.option("--id", "campaign_id", required=True, type=int, help="Campaign ID")
+@click.option("--name", help="New campaign name")
+@click.option("--status", help="New status")
+@click.option("--budget", type=int, help="New daily budget")
+@click.option("--json", "extra_json", help="Additional JSON parameters")
+@click.option("--dry-run", is_flag=True, help="Show request without sending")
+@click.pass_context
+def update(ctx, campaign_id, name, status, budget, extra_json, dry_run):
+    """Update campaign"""
+    try:
+        campaign_data = {"Id": campaign_id}
+
+        if name:
+            campaign_data["Name"] = name
+
+        if status:
+            campaign_data["Status"] = status
+
+        if budget:
+            campaign_data["DailyBudget"] = {
+                "Amount": budget * 1000000,
+                "Mode": "STANDARD",
+            }
+
+        if extra_json:
+            extra = json.loads(extra_json)
+            campaign_data.update(extra)
+
+        body = {"method": "update", "params": {"Campaigns": [campaign_data]}}
+
+        if dry_run:
+            format_output(body, "json", None)
+            return
+
+        client = create_client(
+            token=ctx.obj.get("token"),
+            login=ctx.obj.get("login"),
+            sandbox=ctx.obj.get("sandbox"),
+        )
+
+        result = client.campaigns().post(data=body)
+        format_output(result().extract(), "json", None)
+
+    except Exception as e:
+        print_error(str(e))
+        raise click.Abort()
+
+
+@campaigns.command()
+@click.option("--id", "campaign_id", required=True, type=int, help="Campaign ID")
+@click.pass_context
+def delete(ctx, campaign_id):
+    """Delete campaign"""
+    try:
+        client = create_client(
+            token=ctx.obj.get("token"),
+            login=ctx.obj.get("login"),
+            sandbox=ctx.obj.get("sandbox"),
+        )
+
+        body = {
+            "method": "delete",
+            "params": {"SelectionCriteria": {"Ids": [campaign_id]}},
+        }
+
+        result = client.campaigns().post(data=body)
+        format_output(result().extract(), "json", None)
+
+    except Exception as e:
+        print_error(str(e))
+        raise click.Abort()
+
+
+@campaigns.command()
+@click.option("--id", "campaign_id", required=True, type=int, help="Campaign ID")
+@click.pass_context
+def archive(ctx, campaign_id):
+    """Archive campaign"""
+    try:
+        client = create_client(
+            token=ctx.obj.get("token"),
+            login=ctx.obj.get("login"),
+            sandbox=ctx.obj.get("sandbox"),
+        )
+
+        body = {
+            "method": "archive",
+            "params": {"SelectionCriteria": {"Ids": [campaign_id]}},
+        }
+
+        result = client.campaigns().post(data=body)
+        format_output(result().extract(), "json", None)
+
+    except Exception as e:
+        print_error(str(e))
+        raise click.Abort()
+
+
+@campaigns.command()
+@click.option("--id", "campaign_id", required=True, type=int, help="Campaign ID")
+@click.pass_context
+def unarchive(ctx, campaign_id):
+    """Unarchive campaign"""
+    try:
+        client = create_client(
+            token=ctx.obj.get("token"),
+            login=ctx.obj.get("login"),
+            sandbox=ctx.obj.get("sandbox"),
+        )
+
+        body = {
+            "method": "unarchive",
+            "params": {"SelectionCriteria": {"Ids": [campaign_id]}},
+        }
+
+        result = client.campaigns().post(data=body)
+        format_output(result().extract(), "json", None)
+
+    except Exception as e:
+        print_error(str(e))
+        raise click.Abort()
+
+
+@campaigns.command()
+@click.option("--id", "campaign_id", required=True, type=int, help="Campaign ID")
+@click.pass_context
+def suspend(ctx, campaign_id):
+    """Suspend campaign"""
+    try:
+        client = create_client(
+            token=ctx.obj.get("token"),
+            login=ctx.obj.get("login"),
+            sandbox=ctx.obj.get("sandbox"),
+        )
+
+        body = {
+            "method": "suspend",
+            "params": {"SelectionCriteria": {"Ids": [campaign_id]}},
+        }
+
+        result = client.campaigns().post(data=body)
+        format_output(result().extract(), "json", None)
+
+    except Exception as e:
+        print_error(str(e))
+        raise click.Abort()
+
+
+@campaigns.command()
+@click.option("--id", "campaign_id", required=True, type=int, help="Campaign ID")
+@click.pass_context
+def resume(ctx, campaign_id):
+    """Resume campaign"""
+    try:
+        client = create_client(
+            token=ctx.obj.get("token"),
+            login=ctx.obj.get("login"),
+            sandbox=ctx.obj.get("sandbox"),
+        )
+
+        body = {
+            "method": "resume",
+            "params": {"SelectionCriteria": {"Ids": [campaign_id]}},
+        }
+
+        result = client.campaigns().post(data=body)
+        format_output(result().extract(), "json", None)
+
+    except Exception as e:
+        print_error(str(e))
+        raise click.Abort()

direct_cli/commands/changes.py

@@ -0,0 +1,97 @@
+"""
+Changes commands
+"""
+
+import click
+
+from ..api import create_client
+from ..output import format_output, print_error
+from ..utils import parse_ids
+
+
+@click.group()
+def changes():
+    """Check for changes"""
+    pass
+
+
+@changes.command()
+@click.option("--campaign-ids", required=True, help="Comma-separated campaign IDs")
+@click.option("--timestamp", help="Timestamp for changes check (ISO format)")
+@click.option("--format", "output_format", default="json", help="Output format")
+@click.option("--output", help="Output file")
+@click.pass_context
+def check(ctx, campaign_ids, timestamp, output_format, output):
+    """Check changes for campaigns"""
+    try:
+        client = create_client(
+            token=ctx.obj.get("token"),
+            login=ctx.obj.get("login"),
+            sandbox=ctx.obj.get("sandbox"),
+        )
+
+        params = {"CampaignIds": parse_ids(campaign_ids)}
+
+        if timestamp:
+            params["Timestamp"] = timestamp
+
+        body = {"method": "check", "params": params}
+
+        result = client.changes().post(data=body)
+        format_output(result.data, output_format, output)
+
+    except Exception as e:
+        print_error(str(e))
+        raise click.Abort()
+
+
+@changes.command()
+@click.option("--timestamp", help="Timestamp for changes check (ISO format)")
+@click.option("--format", "output_format", default="json", help="Output format")
+@click.option("--output", help="Output file")
+@click.pass_context
+def check_campaigns(ctx, timestamp, output_format, output):
+    """Check campaigns changes"""
+    try:
+        client = create_client(
+            token=ctx.obj.get("token"),
+            login=ctx.obj.get("login"),
+            sandbox=ctx.obj.get("sandbox"),
+        )
+
+        params = {}
+
+        if timestamp:
+            params["Timestamp"] = timestamp
+
+        body = {"method": "checkCampaigns", "params": params}
+
+        result = client.changes().post(data=body)
+        format_output(result.data, output_format, output)
+
+    except Exception as e:
+        print_error(str(e))
+        raise click.Abort()
+
+
+@changes.command()
+@click.option("--format", "output_format", default="json", help="Output format")
+@click.option("--output", help="Output file")
+@click.pass_context
+def check_dictionaries(ctx, output_format, output):
+    """Check dictionaries changes"""
+    try:
+        client = create_client(
+            token=ctx.obj.get("token"),
+            login=ctx.obj.get("login"),
+            sandbox=ctx.obj.get("sandbox"),
+        )
+
+        body = {"method": "checkDictionaries", "params": {}}
+
+        result = client.changes().post(data=body)
+        format_output(result.data, output_format, output)
+
+    except Exception as e:
+        print_error(str(e))
+        raise click.Abort()

direct_cli/commands/clients.py

@@ -0,0 +1,98 @@
+"""
+Clients commands
+"""
+
+import json
+import click
+
+from ..api import create_client
+from ..output import format_output, print_error
+from ..utils import parse_ids, get_default_fields
+
+
+@click.group()
+def clients():
+    """Manage clients"""
+    pass
+
+
+@clients.command()
+@click.option("--ids", help="Comma-separated client 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.pass_context
+def get(ctx, ids, limit, fetch_all, output_format, output, fields):
+    """Get clients"""
+    try:
+        client = create_client(
+            token=ctx.obj.get("token"),
+            login=ctx.obj.get("login"),
+            sandbox=ctx.obj.get("sandbox"),
+        )
+
+        field_names = fields.split(",") if fields else get_default_fields("clients")
+
+        criteria = {}
+        if ids:
+            criteria["ClientIds"] = parse_ids(ids)
+
+        params = {"FieldNames": field_names}
+
+        if criteria:
+            params["SelectionCriteria"] = criteria
+
+        if limit:
+            params["Page"] = {"Limit": limit}
+
+        body = {"method": "get", "params": params}
+
+        result = client.clients().post(data=body)
+
+        if fetch_all:
+            items = []
+            for item in result().iter_items():
+                items.append(item)
+            format_output(items, output_format, output)
+        else:
+            data = result().extract()
+            format_output(data, output_format, output)
+
+    except Exception as e:
+        print_error(str(e))
+        raise click.Abort()
+
+
+@clients.command()
+@click.option("--client-id", required=True, type=int, help="Client ID")
+@click.option("--json", "extra_json", required=True, help="JSON with updates")
+@click.option("--dry-run", is_flag=True, help="Show request without sending")
+@click.pass_context
+def update(ctx, client_id, extra_json, dry_run):
+    """Update client settings"""
+    try:
+        client_data = {"ClientId": client_id}
+
+        extra = json.loads(extra_json)
+        client_data.update(extra)
+
+        body = {"method": "update", "params": {"Clients": [client_data]}}
+
+        if dry_run:
+            format_output(body, "json", None)
+            return
+
+        client = create_client(
+            token=ctx.obj.get("token"),
+            login=ctx.obj.get("login"),
+            sandbox=ctx.obj.get("sandbox"),
+        )
+
+        result = client.clients().post(data=body)
+        format_output(result().extract(), "json", None)
+
+    except Exception as e:
+        print_error(str(e))
+        raise click.Abort()