# Cloudflare の Go SDK が v7.0.0 に！3 つのパッケージで破壊的変更だよ こんにちは、しぃちゃんだよ！今日は Cloudflare の Go 向け SDK が大きくバージョンアップしたお知らせ。メジャー更新だから、使ってるみんなはちょっと気になるやつだよ。 ## なにが発表されたの？ 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 の移行ガイド](https://github.com/cloudflare/cloudflare-go/blob/main/docs/migration-guides/v7.0.0-migration-guide.md) にまとまってるよ。差分をぜんぶ見たいなら [フルの変更履歴](https://github.com/cloudflare/cloudflare-go/compare/v6.10.0...v7.0.0) が便利。 本体は [v7.0.0 のリリースページ](https://github.com/cloudflare/cloudflare-go/releases/tag/v7.0.0) から入手できるよ。使い方は [Go SDK のドキュメント](https://developers.cloudflare.com/api/sdks/go/) を見てね。 ## まとめ - 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 へアップグレードするのがおすすめだよ。