google-analytics-cli 0.1.0__py3-none-any.whl

ga_cli/commands/event_edit_rules.py

@@ -0,0 +1,292 @@
+"""Event edit rule management commands."""
+
+import json
+from pathlib import Path
+from typing import Optional
+
+import questionary
+import typer
+
+from ..api.client import get_admin_alpha_client
+from ..config.store import get_effective_value
+from ..utils import handle_error, info, output, require_options, resolve_output_format, success
+from ..utils.pagination import paginate_all
+
+event_edit_rules_app = typer.Typer(
+    name="event-edit-rules",
+    help="Manage event edit rules",
+    no_args_is_help=True,
+)
+
+
+def _load_json_config(config_file: str) -> dict:
+    """Load and parse a JSON config file."""
+    config_path = Path(config_file)
+    if not config_path.exists():
+        raise typer.BadParameter(f"Config file not found: {config_file}")
+    try:
+        return json.loads(config_path.read_text())
+    except json.JSONDecodeError as exc:
+        raise typer.BadParameter(f"Invalid JSON in config file: {exc}")
+
+
+@event_edit_rules_app.command("list")
+def list_cmd(
+    property_id: Optional[str] = typer.Option(
+        None, "--property-id", "-p", help="Property ID (numeric)"
+    ),
+    stream_id: str = typer.Option(
+        ..., "--stream-id", "-s", help="Data stream ID"
+    ),
+    output_format: Optional[str] = typer.Option(
+        None, "--output", "-o", help="Output format (json, table, compact)"
+    ),
+):
+    """List event edit rules for a data stream."""
+    try:
+        effective_property = get_effective_value(property_id, "default_property_id")
+        require_options({"property_id": effective_property}, ["property_id"])
+        effective_format = resolve_output_format(output_format)
+
+        admin = get_admin_alpha_client()
+        parent = f"properties/{effective_property}/dataStreams/{stream_id}"
+        rules = paginate_all(
+            lambda **kw: admin.properties()
+            .dataStreams()
+            .eventEditRules()
+            .list(parent=parent, **kw)
+            .execute(),
+            "eventEditRules",
+            pageSize=200,
+        )
+
+        output(
+            rules,
+            effective_format,
+            columns=[
+                "name",
+                "displayName",
+                "processingOrder",
+            ],
+            headers=[
+                "Resource Name",
+                "Display Name",
+                "Processing Order",
+            ],
+        )
+    except Exception as e:
+        handle_error(e)
+
+
+@event_edit_rules_app.command("get")
+def get_cmd(
+    property_id: Optional[str] = typer.Option(
+        None, "--property-id", "-p", help="Property ID (numeric)"
+    ),
+    stream_id: str = typer.Option(
+        ..., "--stream-id", "-s", help="Data stream ID"
+    ),
+    rule_id: str = typer.Option(
+        ..., "--rule-id", "-r", help="Event edit rule ID"
+    ),
+    output_format: Optional[str] = typer.Option(
+        None, "--output", "-o", help="Output format (json, table, compact)"
+    ),
+):
+    """Get details for an event edit rule."""
+    try:
+        effective_property = get_effective_value(property_id, "default_property_id")
+        require_options({"property_id": effective_property}, ["property_id"])
+        effective_format = resolve_output_format(output_format)
+
+        admin = get_admin_alpha_client()
+        resource_name = (
+            f"properties/{effective_property}/dataStreams/{stream_id}"
+            f"/eventEditRules/{rule_id}"
+        )
+        rule = (
+            admin.properties()
+            .dataStreams()
+            .eventEditRules()
+            .get(name=resource_name)
+            .execute()
+        )
+        output(rule, effective_format)
+    except Exception as e:
+        handle_error(e)
+
+
+@event_edit_rules_app.command("create")
+def create_cmd(
+    property_id: Optional[str] = typer.Option(
+        None, "--property-id", "-p", help="Property ID (numeric)"
+    ),
+    stream_id: str = typer.Option(
+        ..., "--stream-id", "-s", help="Data stream ID"
+    ),
+    config_file: str = typer.Option(
+        ..., "--config", "-c", help="Path to JSON event edit rule config file"
+    ),
+    output_format: Optional[str] = typer.Option(
+        None, "--output", "-o", help="Output format (json, table, compact)"
+    ),
+):
+    """Create an event edit rule from a JSON config file."""
+    try:
+        effective_property = get_effective_value(property_id, "default_property_id")
+        require_options({"property_id": effective_property}, ["property_id"])
+        effective_format = resolve_output_format(output_format)
+
+        body = _load_json_config(config_file)
+
+        admin = get_admin_alpha_client()
+        parent = f"properties/{effective_property}/dataStreams/{stream_id}"
+        rule = (
+            admin.properties()
+            .dataStreams()
+            .eventEditRules()
+            .create(parent=parent, body=body)
+            .execute()
+        )
+        output(rule, effective_format)
+    except typer.BadParameter:
+        raise
+    except Exception as e:
+        handle_error(e)
+
+
+@event_edit_rules_app.command("update")
+def update_cmd(
+    property_id: Optional[str] = typer.Option(
+        None, "--property-id", "-p", help="Property ID (numeric)"
+    ),
+    stream_id: str = typer.Option(
+        ..., "--stream-id", "-s", help="Data stream ID"
+    ),
+    rule_id: str = typer.Option(
+        ..., "--rule-id", "-r", help="Event edit rule ID"
+    ),
+    config_file: str = typer.Option(
+        ..., "--config", "-c", help="Path to JSON file with fields to update"
+    ),
+    output_format: Optional[str] = typer.Option(
+        None, "--output", "-o", help="Output format (json, table, compact)"
+    ),
+):
+    """Update an event edit rule from a JSON config file."""
+    try:
+        effective_property = get_effective_value(property_id, "default_property_id")
+        require_options({"property_id": effective_property}, ["property_id"])
+        effective_format = resolve_output_format(output_format)
+
+        body = _load_json_config(config_file)
+
+        if not body:
+            raise typer.BadParameter("Config file must contain at least one field to update.")
+
+        update_mask = ",".join(body.keys())
+
+        admin = get_admin_alpha_client()
+        resource_name = (
+            f"properties/{effective_property}/dataStreams/{stream_id}"
+            f"/eventEditRules/{rule_id}"
+        )
+        rule = (
+            admin.properties()
+            .dataStreams()
+            .eventEditRules()
+            .patch(
+                name=resource_name,
+                body=body,
+                updateMask=update_mask,
+            )
+            .execute()
+        )
+        output(rule, effective_format)
+    except typer.BadParameter:
+        raise
+    except Exception as e:
+        handle_error(e)
+
+
+@event_edit_rules_app.command("delete")
+def delete_cmd(
+    property_id: Optional[str] = typer.Option(
+        None, "--property-id", "-p", help="Property ID (numeric)"
+    ),
+    stream_id: str = typer.Option(
+        ..., "--stream-id", "-s", help="Data stream ID"
+    ),
+    rule_id: str = typer.Option(
+        ..., "--rule-id", "-r", help="Event edit rule ID"
+    ),
+    yes: bool = typer.Option(False, "--yes", "-y", help="Skip confirmation prompt"),
+):
+    """Delete an event edit rule."""
+    try:
+        effective_property = get_effective_value(property_id, "default_property_id")
+        require_options({"property_id": effective_property}, ["property_id"])
+
+        if not yes:
+            confirmed = questionary.confirm(
+                f"Delete event edit rule {rule_id}? This cannot be undone."
+            ).ask()
+            if not confirmed:
+                info("Cancelled.")
+                raise typer.Exit()
+
+        admin = get_admin_alpha_client()
+        resource_name = (
+            f"properties/{effective_property}/dataStreams/{stream_id}"
+            f"/eventEditRules/{rule_id}"
+        )
+        admin.properties().dataStreams().eventEditRules().delete(
+            name=resource_name
+        ).execute()
+        success(f"Event edit rule {rule_id} deleted.")
+    except typer.Exit:
+        raise
+    except Exception as e:
+        handle_error(e)
+
+
+@event_edit_rules_app.command("reorder")
+def reorder_cmd(
+    property_id: Optional[str] = typer.Option(
+        None, "--property-id", "-p", help="Property ID (numeric)"
+    ),
+    stream_id: str = typer.Option(
+        ..., "--stream-id", "-s", help="Data stream ID"
+    ),
+    rule_ids: str = typer.Option(
+        ...,
+        "--rule-ids",
+        help="Comma-separated rule IDs in desired processing order (all rules must be included)",
+    ),
+):
+    """Reorder event edit rules on a data stream."""
+    try:
+        effective_property = get_effective_value(property_id, "default_property_id")
+        require_options({"property_id": effective_property}, ["property_id"])
+
+        parent = f"properties/{effective_property}/dataStreams/{stream_id}"
+        ids = [rid.strip() for rid in rule_ids.split(",") if rid.strip()]
+
+        if not ids:
+            raise typer.BadParameter("--rule-ids must contain at least one rule ID.")
+
+        body = {
+            "eventEditRules": [
+                f"{parent}/eventEditRules/{rid}" for rid in ids
+            ]
+        }
+
+        admin = get_admin_alpha_client()
+        admin.properties().dataStreams().eventEditRules().reorder(
+            parent=parent, body=body
+        ).execute()
+        success("Event edit rules reordered.")
+    except typer.BadParameter:
+        raise
+    except Exception as e:
+        handle_error(e)

ga_cli/commands/firebase_links.py

@@ -0,0 +1,142 @@
+"""Firebase link management commands."""
+
+from typing import Optional
+
+import questionary
+import typer
+
+from ..api.client import get_admin_client
+from ..config.store import get_effective_value
+from ..utils import (
+    handle_dry_run,
+    handle_error,
+    info,
+    output,
+    require_options,
+    resolve_output_format,
+    success,
+)
+from ..utils.pagination import paginate_all
+
+firebase_links_app = typer.Typer(
+    name="firebase-links",
+    help="Manage Firebase links",
+    no_args_is_help=True,
+)
+
+
+@firebase_links_app.command("list")
+def list_cmd(
+    property_id: Optional[str] = typer.Option(
+        None, "--property-id", "-p", help="Property ID (numeric)"
+    ),
+    output_format: Optional[str] = typer.Option(
+        None, "--output", "-o", help="Output format (json, table, compact)"
+    ),
+):
+    """List Firebase links for a property."""
+    try:
+        effective_property = get_effective_value(property_id, "default_property_id")
+        require_options({"property_id": effective_property}, ["property_id"])
+        effective_format = resolve_output_format(output_format)
+
+        admin = get_admin_client()
+        links = paginate_all(
+            lambda **kw: admin.properties()
+            .firebaseLinks()
+            .list(parent=f"properties/{effective_property}", **kw)
+            .execute(),
+            "firebaseLinks",
+            pageSize=200,
+        )
+
+        output(
+            links,
+            effective_format,
+            columns=["name", "project", "createTime"],
+            headers=["Resource Name", "Project", "Create Time"],
+        )
+    except Exception as e:
+        handle_error(e)
+
+
+@firebase_links_app.command("create")
+def create_cmd(
+    property_id: Optional[str] = typer.Option(
+        None, "--property-id", "-p", help="Property ID (numeric)"
+    ),
+    project: str = typer.Option(
+        ..., "--project", help="Firebase project resource name (e.g., projects/my-project)"
+    ),
+    dry_run: bool = typer.Option(
+        False, "--dry-run", help="Preview the request without executing"
+    ),
+    output_format: Optional[str] = typer.Option(
+        None, "--output", "-o", help="Output format (json, table, compact)"
+    ),
+):
+    """Create a Firebase link."""
+    try:
+        effective_property = get_effective_value(property_id, "default_property_id")
+        require_options({"property_id": effective_property}, ["property_id"])
+        effective_format = resolve_output_format(output_format)
+
+        body = {"project": project}
+        if dry_run:
+            handle_dry_run("create", "POST", f"properties/{effective_property}", body)
+
+        admin = get_admin_client()
+        link = (
+            admin.properties()
+            .firebaseLinks()
+            .create(parent=f"properties/{effective_property}", body=body)
+            .execute()
+        )
+        output(link, effective_format)
+    except typer.Exit:
+        raise
+    except Exception as e:
+        handle_error(e)
+
+
+@firebase_links_app.command("delete")
+def delete_cmd(
+    property_id: Optional[str] = typer.Option(
+        None, "--property-id", "-p", help="Property ID (numeric)"
+    ),
+    link_id: str = typer.Option(
+        ..., "--link-id", help="Firebase link ID"
+    ),
+    yes: bool = typer.Option(False, "--yes", "-y", help="Skip confirmation prompt"),
+    dry_run: bool = typer.Option(
+        False, "--dry-run", help="Preview the request without executing"
+    ),
+):
+    """Delete a Firebase link."""
+    try:
+        effective_property = get_effective_value(property_id, "default_property_id")
+        require_options({"property_id": effective_property}, ["property_id"])
+
+        if dry_run:
+            handle_dry_run(
+                "delete", "DELETE",
+                f"properties/{effective_property}/firebaseLinks/{link_id}",
+                None,
+            )
+
+        if not yes:
+            confirmed = questionary.confirm(
+                f"Delete Firebase link {link_id}? This cannot be undone."
+            ).ask()
+            if not confirmed:
+                info("Cancelled.")
+                raise typer.Exit()
+
+        admin = get_admin_client()
+        resource_name = f"properties/{effective_property}/firebaseLinks/{link_id}"
+        admin.properties().firebaseLinks().delete(name=resource_name).execute()
+        success(f"Firebase link {link_id} deleted.")
+    except typer.Exit:
+        raise
+    except Exception as e:
+        handle_error(e)

ga_cli/commands/google_ads_links.py

@@ -0,0 +1,225 @@
+"""Google Ads link management commands."""
+
+from typing import Optional
+
+import questionary
+import typer
+
+from ..api.client import get_admin_client
+from ..config.store import get_effective_value
+from ..utils import (
+    handle_dry_run,
+    handle_error,
+    info,
+    output,
+    require_options,
+    resolve_output_format,
+    success,
+)
+from ..utils.pagination import paginate_all
+
+google_ads_links_app = typer.Typer(
+    name="google-ads-links",
+    help="Manage Google Ads links",
+    no_args_is_help=True,
+)
+
+
+@google_ads_links_app.command("list")
+def list_cmd(
+    property_id: Optional[str] = typer.Option(
+        None, "--property-id", "-p", help="Property ID (numeric)"
+    ),
+    output_format: Optional[str] = typer.Option(
+        None, "--output", "-o", help="Output format (json, table, compact)"
+    ),
+):
+    """List Google Ads links for a property."""
+    try:
+        effective_property = get_effective_value(property_id, "default_property_id")
+        require_options({"property_id": effective_property}, ["property_id"])
+        effective_format = resolve_output_format(output_format)
+
+        admin = get_admin_client()
+        links = paginate_all(
+            lambda **kw: admin.properties()
+            .googleAdsLinks()
+            .list(parent=f"properties/{effective_property}", **kw)
+            .execute(),
+            "googleAdsLinks",
+            pageSize=200,
+        )
+
+        output(
+            links,
+            effective_format,
+            columns=[
+                "name",
+                "customerId",
+                "canManageClients",
+                "adsPersonalizationEnabled",
+                "createTime",
+            ],
+            headers=[
+                "Resource Name",
+                "Customer ID",
+                "Can Manage Clients",
+                "Ads Personalization",
+                "Create Time",
+            ],
+        )
+    except Exception as e:
+        handle_error(e)
+
+
+@google_ads_links_app.command("create")
+def create_cmd(
+    property_id: Optional[str] = typer.Option(
+        None, "--property-id", "-p", help="Property ID (numeric)"
+    ),
+    customer_id: str = typer.Option(
+        ..., "--customer-id", help="Google Ads customer ID"
+    ),
+    ads_personalization: bool = typer.Option(
+        True,
+        "--ads-personalization/--no-ads-personalization",
+        help="Enable ads personalization",
+    ),
+    dry_run: bool = typer.Option(
+        False, "--dry-run", help="Preview the request without executing"
+    ),
+    output_format: Optional[str] = typer.Option(
+        None, "--output", "-o", help="Output format (json, table, compact)"
+    ),
+):
+    """Create a Google Ads link."""
+    try:
+        effective_property = get_effective_value(property_id, "default_property_id")
+        require_options({"property_id": effective_property}, ["property_id"])
+        effective_format = resolve_output_format(output_format)
+
+        body = {
+            "customerId": customer_id,
+            "adsPersonalizationEnabled": ads_personalization,
+        }
+        if dry_run:
+            handle_dry_run("create", "POST", f"properties/{effective_property}", body)
+
+        admin = get_admin_client()
+        link = (
+            admin.properties()
+            .googleAdsLinks()
+            .create(parent=f"properties/{effective_property}", body=body)
+            .execute()
+        )
+        output(link, effective_format)
+    except typer.Exit:
+        raise
+    except Exception as e:
+        handle_error(e)
+
+
+@google_ads_links_app.command("update")
+def update_cmd(
+    property_id: Optional[str] = typer.Option(
+        None, "--property-id", "-p", help="Property ID (numeric)"
+    ),
+    link_id: str = typer.Option(
+        ..., "--link-id", help="Google Ads link ID"
+    ),
+    ads_personalization: Optional[bool] = typer.Option(
+        None,
+        "--ads-personalization/--no-ads-personalization",
+        help="Enable or disable ads personalization",
+    ),
+    dry_run: bool = typer.Option(
+        False, "--dry-run", help="Preview the request without executing"
+    ),
+    output_format: Optional[str] = typer.Option(
+        None, "--output", "-o", help="Output format (json, table, compact)"
+    ),
+):
+    """Update a Google Ads link."""
+    try:
+        effective_property = get_effective_value(property_id, "default_property_id")
+        require_options({"property_id": effective_property}, ["property_id"])
+        effective_format = resolve_output_format(output_format)
+
+        body = {}
+        mask_fields = []
+        if ads_personalization is not None:
+            body["adsPersonalizationEnabled"] = ads_personalization
+            mask_fields.append("adsPersonalizationEnabled")
+
+        if not mask_fields:
+            raise typer.BadParameter(
+                "At least one field must be specified: "
+                "--ads-personalization / --no-ads-personalization"
+            )
+
+        resource_name = f"properties/{effective_property}/googleAdsLinks/{link_id}"
+        if dry_run:
+            handle_dry_run(
+                "update", "PATCH", resource_name,
+                body, update_mask=",".join(mask_fields),
+            )
+
+        admin = get_admin_client()
+        link = (
+            admin.properties()
+            .googleAdsLinks()
+            .patch(
+                name=resource_name,
+                body=body,
+                updateMask=",".join(mask_fields),
+            )
+            .execute()
+        )
+        output(link, effective_format)
+    except (typer.BadParameter, typer.Exit):
+        raise
+    except Exception as e:
+        handle_error(e)
+
+
+@google_ads_links_app.command("delete")
+def delete_cmd(
+    property_id: Optional[str] = typer.Option(
+        None, "--property-id", "-p", help="Property ID (numeric)"
+    ),
+    link_id: str = typer.Option(
+        ..., "--link-id", help="Google Ads link ID"
+    ),
+    yes: bool = typer.Option(False, "--yes", "-y", help="Skip confirmation prompt"),
+    dry_run: bool = typer.Option(
+        False, "--dry-run", help="Preview the request without executing"
+    ),
+):
+    """Delete a Google Ads link."""
+    try:
+        effective_property = get_effective_value(property_id, "default_property_id")
+        require_options({"property_id": effective_property}, ["property_id"])
+
+        if dry_run:
+            handle_dry_run(
+                "delete", "DELETE",
+                f"properties/{effective_property}/googleAdsLinks/{link_id}",
+                None,
+            )
+
+        if not yes:
+            confirmed = questionary.confirm(
+                f"Delete Google Ads link {link_id}? This cannot be undone."
+            ).ask()
+            if not confirmed:
+                info("Cancelled.")
+                raise typer.Exit()
+
+        admin = get_admin_client()
+        resource_name = f"properties/{effective_property}/googleAdsLinks/{link_id}"
+        admin.properties().googleAdsLinks().delete(name=resource_name).execute()
+        success(f"Google Ads link {link_id} deleted.")
+    except typer.Exit:
+        raise
+    except Exception as e:
+        handle_error(e)