Looker 22.4 の API 4.0 GA リリースに続いて、すでに非推奨になった 3.0 API に加えて、3.1 API のサポート終了を発表しました。
2022 年 6 月のサポート終了通知をもって、3.1 API と 3.0 API(3.x と表現します)は非推奨になりました。3.x API バージョンは、少なくとも 1 年間は非推奨ステータスで提供され、2023 年 6 月の Looker リリース以降削除されます。
そのため、2023 年 6 月までに、3.x API エンドポイントではなく 4.0 API エンドポイントを使用するようにアプリケーションをアップグレードすることをおすすめします。4.0 API は非推奨 API で提供される機能に完全に対応しており、3.1x から 4.0 へのアップグレードはほとんどのユーザーにとって簡単です。
Timeline
- 2022 年以前: API 3.0 は非推奨ステータス、3.1 は安定ステータス、4.0 はベータ版ステータス
- 2022 年 3 月: API 4.0 が安定ステータスになり、Looker 22.4 で一般提供
- 2022 年 6 月 23 日 - API 3.1 のサポート終了を発表
- 2023 年 6 月 - API 3.x は Looker から削除予定
API 4.0 移行の概要
API 3.x エンドポイントの置換
以下に示すように、API 4.0 はいくつかの非推奨の API 3.x エンドポイントを、同等のまたは改善されたエンドポイントに置き換えます。
- 「Space」エンドポイントの名前が変更されました。代わりに類義語の「Folder」エンドポイントを使用してください。
- フォルダ機能のドキュメントをご覧ください。
- フォルダ API エンドポイントのリストを参照してください。
- 「ホームページ」エンドポイントが削除されました。代わりに、拡張機能の「ボード」エンドポイントを使用してください。
- ボード機能のドキュメントをご覧ください。
- ボード API エンドポイントのリストを参照してください。
API 4.0 の ID フィールド タイプの破壊的変更
API 4.0 では、一部の ID フィールドの型が数値から文字列に更新されました。Looker でサポートされている言語 SDK を使用して、移行中と移行後のアプリケーションの型が正しいことを確認してください。Kotlin、Swift、R、C#、Go など、コミュニティでサポートされている言語 SDK のほとんどは、更新された型でもすでに機能します。