Google REST API client for Elixir.

OAuth2 bearer auth, Finch + Jason HTTP, structured errors, and thin wrappers for Search Console, GA4 Admin/Data, AdSense Management, and Google Ads.

Quick start

# config/runtime.exs
config :noizu_google,
  access_token: System.get_env("GOOGLE_ACCESS_TOKEN"),
  client_id: System.get_env("GOOGLE_CLIENT_ID"),
  client_secret: System.get_env("GOOGLE_CLIENT_SECRET")

client = Noizu.Google.client()

{:ok, sites} = Noizu.Google.Api.SearchConsole.Sites.list(client: client)

{:ok, report} =
  Noizu.Google.Api.SearchConsole.SearchAnalytics.query(
    "https://example.com/",
    %{
      startDate: "2026-01-01",
      endDate: "2026-01-31",
      dimensions: ["query"]
    },
    client: client
  )

{:ok, props} =
  Noizu.Google.Api.AnalyticsAdmin.Properties.list(
    filter: "parent:accounts/123",
    client: client
  )

Architecture

• Noizu.Google.Client — credentials + base URLs
• Noizu.Google.HTTP — REST GET/POST/PUT/PATCH/DELETE with JSON + bearer auth
• Noizu.Google.OAuth — authorize URL, code exchange, refresh
• Noizu.Google.Scopes — common OAuth scope constants
• Noizu.Google.Api.* — endpoint modules by Google product
• Noizu.Google.Error — structured errors

API namespaces

Pass %Client{} via opts[:client] (or omit to use application config defaults).

See the HexDocs extras for the OAuth runbook and ADR-001 (MCP + Terraform).