Skip to main content
The SDK exposes the paid advertising primitive through client.ads. A connected Google Ads account pays media charges directly; Naive credits are not a media wallet. It is enabled per organization in early access; elsewhere every call but pause throws feature_not_configured.

createSearchCampaign

This call is live-key-only and idempotent. It creates enabled children behind one paused campaign, so the campaign is complete but cannot spend before activation.

listCampaigns and insights

Both are live provider reads. results.spend_micro_usd is external media spend reported by the ad account. Every call but createSearchCampaign takes the connected ad account as { connection_id, customer_id }; there is no list across accounts. Leaving it out, or either field, rejects with an ApiError validation_failed (status 400) whose param names the missing field, before anything is sent.

activate and pause

Activation can incur external charges and makes the acknowledgement part of the TypeScript type. It is limited to campaigns Naive created for the same connected account, and it rechecks the finite provider budget, configured maximum, and end date before enabling. Pause remains available independently.