Cloudflare の Go SDK が v7.0.0 に！3 つのパッケージで破壊的変更だよ

こんにちは、しぃちゃんだよ！今日は Cloudflare の Go 向け SDK が大きくバージョンアップしたお知らせ。メジャー更新だから、使ってるみんなはちょっと気になるやつだよ。

Cloudflare Changelog developers.cloudflare.com

なにが発表されたの？

Cloudflare の Changelog で、公式の Go SDK「cloudflare-go」の v7.0.0 が公開されたよ。2026 年 4 月 30 日の発表なの。メジャーバージョンの更新で、ai_search・email_security・workers の 3 つのパッケージにまたがる破壊的変更が入ってるんだって。上流の API 仕様の更新に合わせた変更なんだよ。

今までどうだったの？

これまでは v6 系だったんだけど、API 側の仕様が進化していく中で、SDK の型やメソッドの一部が実態とズレてきていたの。今回の v7.0.0 でそのズレを整理して、上流の API に揃え直したんだよ。

これで何が変わるの？

破壊的変更が入ってるから、v6 から上げるときはコードの手直しが必要になるよ。たとえば email_security ではパスパラメータの型が int64 から string に変わったり、Investigate 系のメソッドが postfixID の代わりに investigateID を使うようになったの。workers の Observability のテレメトリフィルタも、入れ子のフィルタグループに対応する形に作り直されたよ。そのぶん新機能もちゃんと増えてるから、上げる価値はあるはず。

深く潜ってみよう

破壊的変更のポイントはこんな感じ。

• ai_search: インスタンスのメタデータから SearchForAgents という入れ子の型が削除されて、関連する 13 個の型定義がなくなったよ。
• email_security: AllowPolicies や BlockSenders、Domains などでパスパラメータの型が string に統一。SettingDomainService.BulkDelete は削除、InvestigateMoveService.New の戻り値はページネーション形式に変わったの。
• workers: Observability のフィルタが、入れ子のグループを表せる新しい判別可能なユニオン型に再構成されたよ。

新機能もいくつか入ってるよ。

• Organizations の監査ログを、カーソルベースのページネーションで取得できるように。
• Browser Rendering で特定のブラウザターゲットを閉じられるように。
• Queues で特定のキューのメトリクスを取れるように。
• AI Search に、同期的にインデックスできる WaitForCompletion パラメータが追加されたの。

具体的な移行手順は v7.0.0 の移行ガイド にまとまってるよ。差分をぜんぶ見たいなら フルの変更履歴 が便利。

本体は v7.0.0 のリリースページ から入手できるよ。使い方は Go SDK のドキュメント を見てね。

まとめ

• Cloudflare 公式の Go SDK「cloudflare-go」が v7.0.0 にメジャー更新だよ。
• ai_search・email_security・workers の 3 パッケージに破壊的変更。上流 API に合わせた整理なの。
• 新機能として Organizations の監査ログ取得、Browser Rendering のターゲット個別クローズ、Queues のメトリクス取得、AI Search の WaitForCompletion が追加。
• Go で Cloudflare を触ってるエンジニアは、移行ガイドを片手に v7 へアップグレードするのがおすすめだよ。