direct-cli 0.0.0__py3-none-any.whl

direct_cli/commands/keywords.py

@@ -0,0 +1,309 @@
+"""
+Keywords 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 keywords():
+    """Manage keywords"""
+    pass
+
+
+@keywords.command()
+@click.option("--ids", help="Comma-separated keyword IDs")
+@click.option("--adgroup-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("--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,
+    adgroup_ids,
+    campaign_ids,
+    status,
+    limit,
+    fetch_all,
+    output_format,
+    output,
+    fields,
+):
+    """Get keywords"""
+    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("keywords")
+
+        criteria = {}
+        if ids:
+            criteria["Ids"] = parse_ids(ids)
+        if adgroup_ids:
+            criteria["AdGroupIds"] = parse_ids(adgroup_ids)
+        if campaign_ids:
+            criteria["CampaignIds"] = parse_ids(campaign_ids)
+        if status:
+            criteria["Statuses"] = [status]
+
+        params = {"SelectionCriteria": criteria, "FieldNames": field_names}
+
+        if limit:
+            params["Page"] = {"Limit": limit}
+
+        body = {"method": "get", "params": params}
+
+        result = client.keywords().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()
+
+
+@keywords.command()
+@click.option("--adgroup-id", required=True, type=int, help="Ad group ID")
+@click.option("--keyword", required=True, help="Keyword text")
+@click.option("--bid", type=float, help="Search bid")
+@click.option("--context-bid", type=float, help="Context bid")
+@click.option("--user-param-1", help="User parameter 1")
+@click.option("--user-param-2", help="User parameter 2")
+@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,
+    adgroup_id,
+    keyword,
+    bid,
+    context_bid,
+    user_param_1,
+    user_param_2,
+    extra_json,
+    dry_run,
+):
+    """Add new keyword"""
+    try:
+        keyword_data = {"AdGroupId": adgroup_id, "Keyword": keyword}
+
+        if bid:
+            keyword_data["Bid"] = int(bid * 1000000)
+        if context_bid:
+            keyword_data["ContextBid"] = int(context_bid * 1000000)
+        if user_param_1:
+            keyword_data["UserParam1"] = user_param_1
+        if user_param_2:
+            keyword_data["UserParam2"] = user_param_2
+
+        if extra_json:
+            extra = json.loads(extra_json)
+            keyword_data.update(extra)
+
+        body = {"method": "add", "params": {"Keywords": [keyword_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.keywords().post(data=body)
+        format_output(result().extract(), "json", None)
+
+    except Exception as e:
+        print_error(str(e))
+        raise click.Abort()
+
+
+@keywords.command()
+@click.option("--id", "keyword_id", required=True, type=int, help="Keyword ID")
+@click.option("--bid", type=float, help="Search bid")
+@click.option("--context-bid", type=float, help="Context bid")
+@click.option("--status", help="New status")
+@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, keyword_id, bid, context_bid, status, extra_json, dry_run):
+    """Update keyword"""
+    try:
+        keyword_data = {"Id": keyword_id}
+
+        if bid:
+            keyword_data["Bid"] = int(bid * 1000000)
+        if context_bid:
+            keyword_data["ContextBid"] = int(context_bid * 1000000)
+        if status:
+            keyword_data["Status"] = status
+
+        if extra_json:
+            extra = json.loads(extra_json)
+            keyword_data.update(extra)
+
+        body = {"method": "update", "params": {"Keywords": [keyword_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.keywords().post(data=body)
+        format_output(result().extract(), "json", None)
+
+    except Exception as e:
+        print_error(str(e))
+        raise click.Abort()
+
+
+@keywords.command()
+@click.option("--id", "keyword_id", required=True, type=int, help="Keyword ID")
+@click.pass_context
+def delete(ctx, keyword_id):
+    """Delete keyword"""
+    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": [keyword_id]}},
+        }
+
+        result = client.keywords().post(data=body)
+        format_output(result().extract(), "json", None)
+
+    except Exception as e:
+        print_error(str(e))
+        raise click.Abort()
+
+
+@keywords.command()
+@click.option("--id", "keyword_id", required=True, type=int, help="Keyword ID")
+@click.pass_context
+def archive(ctx, keyword_id):
+    """Archive keyword"""
+    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": [keyword_id]}},
+        }
+
+        result = client.keywords().post(data=body)
+        format_output(result().extract(), "json", None)
+
+    except Exception as e:
+        print_error(str(e))
+        raise click.Abort()
+
+
+@keywords.command()
+@click.option("--id", "keyword_id", required=True, type=int, help="Keyword ID")
+@click.pass_context
+def unarchive(ctx, keyword_id):
+    """Unarchive keyword"""
+    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": [keyword_id]}},
+        }
+
+        result = client.keywords().post(data=body)
+        format_output(result().extract(), "json", None)
+
+    except Exception as e:
+        print_error(str(e))
+        raise click.Abort()
+
+
+@keywords.command()
+@click.option("--id", "keyword_id", required=True, type=int, help="Keyword ID")
+@click.pass_context
+def suspend(ctx, keyword_id):
+    """Suspend keyword"""
+    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": [keyword_id]}},
+        }
+
+        result = client.keywords().post(data=body)
+        format_output(result().extract(), "json", None)
+
+    except Exception as e:
+        print_error(str(e))
+        raise click.Abort()
+
+
+@keywords.command()
+@click.option("--id", "keyword_id", required=True, type=int, help="Keyword ID")
+@click.pass_context
+def resume(ctx, keyword_id):
+    """Resume keyword"""
+    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": [keyword_id]}},
+        }
+
+        result = client.keywords().post(data=body)
+        format_output(result().extract(), "json", None)
+
+    except Exception as e:
+        print_error(str(e))
+        raise click.Abort()

direct_cli/commands/keywordsresearch.py

@@ -0,0 +1,71 @@
+"""
+KeywordsResearch commands
+"""
+
+import click
+
+from ..api import create_client
+from ..output import format_output, print_error
+
+
+@click.group()
+def keywordsresearch():
+    """Keyword research tools"""
+    pass
+
+
+@keywordsresearch.command()
+@click.option("--keywords", required=True, help="Comma-separated keywords")
+@click.option("--limit", type=int, help="Limit number of results")
+@click.option("--format", "output_format", default="json", help="Output format")
+@click.option("--output", help="Output file")
+@click.pass_context
+def get(ctx, keywords, limit, output_format, output):
+    """Get keywords research data"""
+    try:
+        client = create_client(
+            token=ctx.obj.get("token"),
+            login=ctx.obj.get("login"),
+            sandbox=ctx.obj.get("sandbox"),
+        )
+
+        params = {"Keywords": [k.strip() for k in keywords.split(",")]}
+
+        if limit:
+            params["Limit"] = limit
+
+        body = {"method": "get", "params": params}
+
+        result = client.keywordsresearch().post(data=body)
+        format_output(result.data, output_format, output)
+
+    except Exception as e:
+        print_error(str(e))
+        raise click.Abort()
+
+
+@keywordsresearch.command()
+@click.option("--keywords", required=True, help="Comma-separated keywords")
+@click.option("--format", "output_format", default="json", help="Output format")
+@click.option("--output", help="Output file")
+@click.pass_context
+def has_search_volume(ctx, keywords, output_format, output):
+    """Check if keywords have search volume"""
+    try:
+        client = create_client(
+            token=ctx.obj.get("token"),
+            login=ctx.obj.get("login"),
+            sandbox=ctx.obj.get("sandbox"),
+        )
+
+        body = {
+            "method": "HasSearchVolume",
+            "params": {"Keywords": [k.strip() for k in keywords.split(",")]},
+        }
+
+        result = client.keywordsresearch().post(data=body)
+        format_output(result.data, output_format, output)
+
+    except Exception as e:
+        print_error(str(e))
+        raise click.Abort()

direct_cli/commands/leads.py

@@ -0,0 +1,65 @@
+"""
+Leads commands
+"""
+
+import click
+
+from ..api import create_client
+from ..output import format_output, print_error
+from ..utils import parse_ids
+
+
+@click.group()
+def leads():
+    """Manage leads"""
+    pass
+
+
+@leads.command()
+@click.option("--campaign-ids", help="Comma-separated campaign 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, campaign_ids, limit, fetch_all, output_format, output, fields):
+    """Get leads"""
+    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 ["Date", "LeadId", "CampaignId", "AdGroupId", "AdId"]
+        )
+
+        criteria = {}
+        if campaign_ids:
+            criteria["CampaignIds"] = parse_ids(campaign_ids)
+
+        params = {"SelectionCriteria": criteria, "FieldNames": field_names}
+
+        if limit:
+            params["Page"] = {"Limit": limit}
+
+        body = {"method": "get", "params": params}
+
+        result = client.leads().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/negativekeywordsharedsets.py

@@ -0,0 +1,97 @@
+"""
+NegativeKeywordSharedSets 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 negativekeywordsharedsets():
+    """Manage negative keyword shared sets"""
+    pass
+
+
+@negativekeywordsharedsets.command()
+@click.option("--ids", help="Comma-separated 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.pass_context
+def get(ctx, ids, limit, fetch_all, output_format, output, fields):
+    """Get negative keyword shared sets"""
+    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", "NegativeKeywords"]
+        )
+
+        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.negativekeywordsharedsets().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()
+
+
+@negativekeywordsharedsets.command()
+@click.option("--name", required=True, help="Set name")
+@click.option("--keywords", required=True, help="Comma-separated negative keywords")
+@click.option("--dry-run", is_flag=True, help="Show request without sending")
+@click.pass_context
+def add(ctx, name, keywords, dry_run):
+    """Add negative keyword shared set"""
+    try:
+        set_data = {
+            "Name": name,
+            "NegativeKeywords": [{"Keyword": k.strip()} for k in keywords.split(",")],
+        }
+
+        body = {"method": "add", "params": {"NegativeKeywordSharedSets": [set_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.negativekeywordsharedsets().post(data=body)
+        format_output(result().extract(), "json", None)
+
+    except Exception as e:
+        print_error(str(e))
+        raise click.Abort()

direct_cli/commands/reports.py

@@ -0,0 +1,128 @@
+"""
+Reports commands
+"""
+
+import json
+import click
+from datetime import datetime
+
+from ..api import create_client
+from ..output import format_output, print_error
+
+
+REPORT_TYPES = [
+    "CAMPAIGN_PERFORMANCE_REPORT",
+    "ADGROUP_PERFORMANCE_REPORT",
+    "AD_PERFORMANCE_REPORT",
+    "CRITERIA_PERFORMANCE_REPORT",
+    "CUSTOM_REPORT",
+    "REACH_AND_FREQUENCY_CAMPAIGN_REPORT",
+    "SEARCH_QUERY_PERFORMANCE_REPORT",
+]
+
+
+@click.group()
+def reports():
+    """Generate and manage reports"""
+    pass
+
+
+@reports.command()
+@click.option(
+    "--type",
+    "report_type",
+    required=True,
+    help="Report type (CAMPAIGN_PERFORMANCE_REPORT, etc.)",
+)
+@click.option("--from", "date_from", required=True, help="Start date (YYYY-MM-DD)")
+@click.option("--to", "date_to", required=True, help="End date (YYYY-MM-DD)")
+@click.option("--name", required=True, help="Report name")
+@click.option("--fields", required=True, help="Comma-separated field names")
+@click.option("--campaign-ids", help="Comma-separated campaign IDs")
+@click.option("--adgroup-ids", help="Comma-separated ad group IDs")
+@click.option(
+    "--format",
+    "output_format",
+    default="json",
+    help="Output format (json/table/csv/tsv)",
+)
+@click.option("--output", help="Output file")
+@click.option("--mode", default="auto", help="Processing mode (online/offline/auto)")
+@click.pass_context
+def get(
+    ctx,
+    report_type,
+    date_from,
+    date_to,
+    name,
+    fields,
+    campaign_ids,
+    adgroup_ids,
+    output_format,
+    output,
+    mode,
+):
+    """Get report"""
+    try:
+        client = create_client(
+            token=ctx.obj.get("token"),
+            login=ctx.obj.get("login"),
+            sandbox=ctx.obj.get("sandbox"),
+        )
+
+        field_names = [f.strip() for f in fields.split(",")]
+
+        selection_criteria = {"DateFrom": date_from, "DateTo": date_to}
+
+        if campaign_ids:
+            selection_criteria["Filter"] = [
+                {
+                    "Field": "CampaignId",
+                    "Operator": "IN",
+                    "Values": campaign_ids.split(","),
+                }
+            ]
+        elif adgroup_ids:
+            selection_criteria["Filter"] = [
+                {
+                    "Field": "AdGroupId",
+                    "Operator": "IN",
+                    "Values": adgroup_ids.split(","),
+                }
+            ]
+
+        body = {
+            "params": {
+                "SelectionCriteria": selection_criteria,
+                "FieldNames": field_names,
+                "ReportName": name,
+                "ReportType": report_type,
+                "DateRangeType": "CUSTOM_DATE",
+                "Format": "TSV" if output_format in ["tsv", "csv"] else "TSV",
+                "IncludeVAT": "YES",
+                "IncludeDiscount": "YES",
+            }
+        }
+
+        result = client.reports().post(data=body)
+
+        if output_format == "json":
+            format_output(result().to_dicts(), "json", output)
+        elif output_format == "table":
+            format_output(result().to_dicts(), "table", output)
+        elif output_format == "csv":
+            format_output(result().to_values(), "csv", output, headers=result.columns)
+        elif output_format == "tsv":
+            format_output(result().to_values(), "tsv", output, headers=result.columns)
+        else:
+            format_output(result.data, "json", output)
+
+    except Exception as e:
+        print_error(str(e))
+        raise click.Abort()
+
+
+@reports.command()
+def list_types():
+    """List available report types"""
+    format_output(REPORT_TYPES, "json", None)