amazon-ads-cli 0.1.3__tar.gz → 0.1.4__tar.gz

{amazon_ads_cli-0.1.3 → amazon_ads_cli-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: amazon-ads-cli
-Version: 0.1.3
+Version: 0.1.4
 Summary: CLI tool for Amazon Advertising API v3
 Home-page: https://github.com/stellaraether/amazon-ads-cli
 Author: Lunan Li

{amazon_ads_cli-0.1.3 → amazon_ads_cli-0.1.4}/amazon_ads_cli/main.py

@@ -153,14 +153,40 @@ def list_campaigns(ctx):
     )
     campaigns = result.payload.get("campaigns", [])
 
-    click.echo(f"\n{'Campaign':<30} {'State':<10} {'Budget':<10} {'Type'}")
-    click.echo("-" * 65)
+    click.echo(f"\n{'ID':<20} {'Campaign':<28} {'State':<10} {'Budget':<10} {'Type'}")
+    click.echo("-" * 85)
     for camp in campaigns:
-        name = camp["name"][:28]
+        cid = camp["campaignId"][:18]
+        name = camp["name"][:26]
         state = camp["state"]
         budget = f"${camp['budget']['budget']}"
         ctype = camp.get("targetingType", "N/A")
-        click.echo(f"{name:<30} {state:<10} {budget:<10} {ctype}")
+        click.echo(f"{cid:<20} {name:<28} {state:<10} {budget:<10} {ctype}")
+
+
+@campaigns.command("show")
+@click.argument("campaign-id")
+@click.pass_context
+def show_campaign(ctx, campaign_id):
+    """Show full details for a campaign."""
+    result = sponsored_products.CampaignsV3(marketplace=Marketplaces.NA).list_campaigns(
+        body={"campaignIdFilter": {"include": [campaign_id]}}
+    )
+    campaigns = result.payload.get("campaigns", [])
+    if not campaigns:
+        click.echo(f"❌ Campaign {campaign_id} not found")
+        return
+
+    camp = campaigns[0]
+    click.echo(f"\n📋 Campaign: {camp['name']}")
+    click.echo(f"   ID: {camp['campaignId']}")
+    click.echo(f"   State: {camp['state']}")
+    click.echo(
+        f"   Budget: ${camp['budget']['budget']}/{camp['budget']['budgetType'].lower()}"
+    )
+    click.echo(f"   Type: {camp.get('targetingType', 'N/A')}")
+    click.echo(f"   Start: {camp.get('startDate', 'N/A')}")
+    click.echo(f"   End: {camp.get('endDate', 'N/A') or 'No end date'}")
 
 
 @campaigns.command("pause")
@@ -213,6 +239,36 @@ def set_budget(ctx, campaign_id, amount):
         click.echo(f"❌ Error: {e}")
 
 
+@cli.group()
+def adgroups():
+    """Ad group management commands."""
+    pass
+
+
+@adgroups.command("list")
+@click.option("--campaign-id", help="Filter by campaign ID")
+@click.pass_context
+def list_adgroups(ctx, campaign_id):
+    """List all ad groups."""
+    body = {}
+    if campaign_id:
+        body["campaignIdFilter"] = {"include": [campaign_id]}
+
+    result = sponsored_products.AdGroupsV3(marketplace=Marketplaces.NA).list_ad_groups(
+        body=body
+    )
+    ad_groups = result.payload.get("adGroups", [])
+
+    click.echo(f"\n{'ID':<20} {'Campaign ID':<20} {'Name':<30} {'State'}")
+    click.echo("-" * 85)
+    for ag in ad_groups:
+        ag_id = ag["adGroupId"][:18]
+        camp_id = ag["campaignId"][:18]
+        name = ag["name"][:28]
+        state = ag["state"]
+        click.echo(f"{ag_id:<20} {camp_id:<20} {name:<30} {state}")
+
+
 @cli.group()
 def keywords():
     """Keyword management commands."""
@@ -243,6 +299,28 @@ def list_keywords(ctx, campaign_id):
         click.echo(f"{text:<35} {match:<10} {bid:<8} {state}")
 
 
+@keywords.command("list-all")
+@click.pass_context
+def list_all_keywords(ctx):
+    """List all keywords across all campaigns."""
+    result = sponsored_products.KeywordsV3(marketplace=Marketplaces.NA).list_keywords(
+        body={}
+    )
+    keywords = result.payload.get("keywords", [])
+
+    click.echo(
+        f"\n{'Campaign ID':<20} {'Keyword':<35} {'Match':<10} {'Bid':<8} {'State'}"
+    )
+    click.echo("-" * 90)
+    for kw in keywords:
+        camp_id = kw.get("campaignId", "N/A")[:18]
+        text = kw["keywordText"][:33]
+        match = kw["matchType"]
+        bid = f"${kw['bid']}"
+        state = kw["state"]
+        click.echo(f"{camp_id:<20} {text:<35} {match:<10} {bid:<8} {state}")
+
+
 @keywords.command("add")
 @click.argument("campaign-id")
 @click.argument("ad-group-id")
@@ -317,6 +395,24 @@ def list_negatives(ctx, campaign_id):
         click.echo(f"{text:<35} {match:<15}")
 
 
+@negatives.command("list-all")
+@click.pass_context
+def list_all_negatives(ctx):
+    """List all negative keywords across all campaigns."""
+    result = sponsored_products.NegativeKeywordsV3(
+        marketplace=Marketplaces.NA
+    ).list_negative_keywords(body={"stateFilter": {"include": ["ENABLED"]}})
+    negatives = result.payload.get("negativeKeywords", [])
+
+    click.echo(f"\n{'Campaign ID':<20} {'Negative Keyword':<35} {'Match':<15}")
+    click.echo("-" * 80)
+    for neg in negatives:
+        camp_id = neg.get("campaignId", "N/A")[:18]
+        text = neg["keywordText"][:33]
+        match = neg["matchType"]
+        click.echo(f"{camp_id:<20} {text:<35} {match:<15}")
+
+
 @negatives.command("add")
 @click.argument("campaign-id")
 @click.argument("ad-group-id")
@@ -366,6 +462,33 @@ def remove_negative(ctx, negative_keyword_id):
         click.echo(f"❌ Error: {e}")
 
 
+@cli.group()
+def targets():
+    """Product target management commands."""
+    pass
+
+
+@targets.command("list-all")
+@click.pass_context
+def list_all_targets(ctx):
+    """List all product targets across all campaigns."""
+    result = sponsored_products.TargetsV3(
+        marketplace=Marketplaces.NA
+    ).list_product_targets(body={})
+    targets_list = result.payload.get("productTargets", [])
+
+    click.echo(
+        f"\n{'Campaign ID':<20} {'Ad Group ID':<20} {'Expression':<40} {'State'}"
+    )
+    click.echo("-" * 95)
+    for t in targets_list:
+        camp_id = t.get("campaignId", "N/A")[:18]
+        ag_id = t.get("adGroupId", "N/A")[:18]
+        expr = str(t.get("expression", []))[:38]
+        state = t.get("state", "N/A")
+        click.echo(f"{camp_id:<20} {ag_id:<20} {expr:<40} {state}")
+
+
 @cli.group()
 def report():
     """Report commands."""
@@ -463,6 +586,145 @@ def report_today(ctx):
         click.echo(f"❌ Error: {e}")
 
 
+@report.command("status")
+@click.argument("report-id")
+@click.pass_context
+def report_status(ctx, report_id):
+    """Check status of an existing report."""
+    try:
+        result = reports.Reports(marketplace=Marketplaces.NA).get_report(
+            reportId=report_id
+        )
+        payload = result.payload
+
+        status = payload.get("status")
+        name = payload.get("name", "N/A")
+        start = payload.get("startDate", "N/A")
+        end = payload.get("endDate", "N/A")
+        created = payload.get("createdAt", "N/A")
+        updated = payload.get("updatedAt", "N/A")
+
+        click.echo(f"\n📊 Report: {name}")
+        click.echo(f"   ID: {report_id}")
+        click.echo(f"   Status: {status}")
+        click.echo(f"   Date Range: {start} to {end}")
+        click.echo(f"   Created: {created}")
+        click.echo(f"   Updated: {updated}")
+
+        if status == "COMPLETED":
+            size = payload.get("fileSize", "N/A")
+            click.echo(f"   File Size: {size}")
+            click.echo("\n✅ Report is ready. Download with:")
+            click.echo(f"   amz-ads report download {report_id}")
+        elif status == "FAILED":
+            reason = payload.get("failureReason", "Unknown")
+            click.echo(f"\n❌ Failed: {reason}")
+        else:
+            click.echo("\n⏳ Still processing. Check again later.")
+
+    except Exception as e:
+        click.echo(f"❌ Error: {e}")
+
+
+@report.command("download")
+@click.argument("report-id")
+@click.option(
+    "--format",
+    "fmt",
+    default="table",
+    type=click.Choice(["table", "json", "csv"]),
+    help="Output format",
+)
+@click.option("--output", "-o", help="Save to file instead of stdout")
+@click.pass_context
+def report_download(ctx, report_id, fmt, output):
+    """Download a completed report by ID."""
+    try:
+        result = reports.Reports(marketplace=Marketplaces.NA).get_report(
+            reportId=report_id
+        )
+        status = result.payload.get("status")
+
+        if status != "COMPLETED":
+            click.echo(f"❌ Report is not ready (status: {status})")
+            click.echo(f"   Check status: amz-ads report status {report_id}")
+            return
+
+        url = result.payload.get("url")
+        if not url:
+            click.echo("❌ No download URL available")
+            return
+
+        import gzip
+
+        import requests
+
+        click.echo("Downloading report...")
+        response = requests.get(url)
+        data = gzip.decompress(response.content)
+        report_data = json.loads(data)
+
+        if fmt == "json":
+            output_text = json.dumps(report_data, indent=2)
+        elif fmt == "csv":
+            if not report_data:
+                click.echo("❌ Report is empty")
+                return
+            import csv
+            import io
+
+            buf = io.StringIO()
+            writer = csv.DictWriter(buf, fieldnames=report_data[0].keys())
+            writer.writeheader()
+            writer.writerows(report_data)
+            output_text = buf.getvalue()
+        else:
+            # Table format
+            if not report_data:
+                click.echo("❌ Report is empty")
+                return
+
+            # Detect report type by columns
+            columns = report_data[0].keys()
+
+            if "searchTerm" in columns:
+                # Search terms report
+                report_data.sort(
+                    key=lambda x: float(x.get("cost", 0) or 0), reverse=True
+                )
+                output_text = f"\n{'Search Term':<40} {'Campaign':<20} {'Spend':>8} {'Sales':>8} {'ACOS'}\n"
+                output_text += "-" * 90 + "\n"
+                for row in report_data[:50]:
+                    term = row.get("searchTerm", "N/A")[:38]
+                    camp = row.get("campaignName", "N/A")[:18]
+                    cost = float(row.get("cost", 0) or 0)
+                    sales = float(row.get("sales14d", 0) or 0)
+                    acos = (cost / sales * 100) if sales > 0 else 0
+                    output_text += f"{term:<40} {camp:<20} ${cost:>7.2f} ${sales:>7.2f} {acos:>5.1f}%\n"
+            else:
+                # Campaign report
+                output_text = f"\n{'Campaign':<30} {'Impr':>8} {'Clicks':>7} {'Spend':>8} {'Sales':>8} {'ACOS'}\n"
+                output_text += "-" * 75 + "\n"
+                for row in report_data:
+                    camp_name = row.get("campaignName", "N/A")[:28]
+                    impr = int(row.get("impressions", 0) or 0)
+                    clicks = int(row.get("clicks", 0) or 0)
+                    cost = float(row.get("cost", 0) or 0)
+                    sales = float(row.get("sales14d", 0) or 0)
+                    acos = (cost / sales * 100) if sales > 0 else 0
+                    output_text += f"{camp_name:<30} {impr:>8} {clicks:>7} ${cost:>7.2f} ${sales:>7.2f} {acos:>5.1f}%\n"
+
+        if output:
+            with open(output, "w") as f:
+                f.write(output_text)
+            click.echo(f"✅ Saved to {output}")
+        else:
+            click.echo(output_text)
+
+    except Exception as e:
+        click.echo(f"❌ Error: {e}")
+
+
 @report.command("search-terms")
 @click.option("--days", default=7, help="Number of days to look back")
 @click.pass_context

{amazon_ads_cli-0.1.3 → amazon_ads_cli-0.1.4}/amazon_ads_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: amazon-ads-cli
-Version: 0.1.3
+Version: 0.1.4
 Summary: CLI tool for Amazon Advertising API v3
 Home-page: https://github.com/stellaraether/amazon-ads-cli
 Author: Lunan Li

{amazon_ads_cli-0.1.3 → amazon_ads_cli-0.1.4}/setup.py

@@ -2,7 +2,7 @@ from setuptools import find_packages, setup
 
 setup(
     name="amazon-ads-cli",
-    version="0.1.3",
+    version="0.1.4",
     description="CLI tool for Amazon Advertising API v3",
     author="Lunan Li",
     author_email="lunan@stellaraether.com",