feat(ads): add the fopost ads google commands

README.md

@@ -267,3 +267,22 @@ and exits `7` or `9`, so a script can back off on its own terms.
 ## License
 
 MIT © Porter Bridge, LLC. See [LICENSE](LICENSE).
+
+### Google Ads
+
+`fopost ads google` covers the Search surface no other network has. Every command names
+the connection and the Google Ads account:
+
+```bash
+fopost ads google keywords --connection c4d5e6f7-… --customer 1234567890
+fopost ads google keyword-ideas --connection c4d5e6f7-… --customer 1234567890 --seed "running shoes"
+fopost ads google search-terms --connection c4d5e6f7-… --customer 1234567890 --since 2026-09-01 --until 2026-09-20
+fopost ads google assets --connection c4d5e6f7-… --customer 1234567890
+fopost ads google asset-groups --connection c4d5e6f7-… --customer 1234567890
+fopost ads google conversions --connection c4d5e6f7-… --customer 1234567890
+fopost ads google query --connection c4d5e6f7-… --customer 1234567890 \
+  'SELECT campaign.name, metrics.clicks FROM campaign WHERE segments.date DURING LAST_30_DAYS'
+```
+
+`--customer` has to name an account the connection's grant reaches; any other answers
+404. The other `fopost ads` commands work across networks and dispatch by connection.

go.mod

@@ -3,7 +3,7 @@ module github.com/fopost/fopost-cli
 go 1.22
 
 require (
-	github.com/fopost/fopost-go v0.2.1-0.20260920154339-1957686eb2db
+	github.com/fopost/fopost-go v0.2.1-0.20260920161845-0d662e46400a
 	github.com/spf13/cobra v1.10.2
 	golang.org/x/term v0.27.0
 )

go.sum

@@ -1,6 +1,8 @@
 github.com/cpuguy83/go-md2man/v2 v2.0.6/go.mod h1:oOW0eioCTA6cOiMLiUPZOpcVxMig6NIQQ7OS05n1F4g=
 github.com/fopost/fopost-go v0.2.1-0.20260920154339-1957686eb2db h1:ZRTF4nBDm+K4SzZEPlsC8RvLHIKO0Vj4Dr+nw1+iw8M=
 github.com/fopost/fopost-go v0.2.1-0.20260920154339-1957686eb2db/go.mod h1:Qz+7UCYTBnDEeZqB3VMrePxmYLVR9rFvx3+QWcKND8Q=
+github.com/fopost/fopost-go v0.2.1-0.20260920161845-0d662e46400a h1:RG/LXPHro7c2J/e7e+sTxNV8C963xZ8vXBDo+4AvL/c=
+github.com/fopost/fopost-go v0.2.1-0.20260920161845-0d662e46400a/go.mod h1:Qz+7UCYTBnDEeZqB3VMrePxmYLVR9rFvx3+QWcKND8Q=
 github.com/inconshreveable/mousetrap v1.1.0 h1:wN+x4NVGpMsO7ErUn/mUI3vEoE6Jt13X2s0bqwp9tc8=
 github.com/inconshreveable/mousetrap v1.1.0/go.mod h1:vpF70FUmC8bwa3OWnCshd2FqLfsEA9PFc4w1p2J65bw=
 github.com/russross/blackfriday/v2 v2.1.0/go.mod h1:+Rmxgy9KzJVeS9/2gXHxylqXiyQDYRxCVz55jmeOWTM=

internal/cmd/ads.go

@@ -15,7 +15,7 @@ func init() { register(newAdsCmd) }
 func newAdsCmd(state *State) *cobra.Command {
 	cmd := &cobra.Command{
 		Use:   "ads",
-		Short: "Inspect Meta campaigns and catalogs, change status, and read insights, leads and the ad archive",
+		Short: "Inspect campaigns and catalogs, change status, and read insights, leads and the ad archive",
 	}
 	cmd.AddCommand(
 		newAdsTreeCmd(state),
@@ -25,6 +25,7 @@ func newAdsCmd(state *State) *cobra.Command {
 		newAdsLeadsCmd(state),
 		newAdsCatalogsCmd(state),
 		newAdsLibraryCmd(state),
+		newAdsGoogleCmd(state),
 	)
 	return cmd
 }