很高興在此宣布，Looker 22.4 現已正式發布 Looker API 4.0。正式發布的 API 4.0 (API 4.0 GA) 有多項重大異動和新增功能，並將多個端點從 Beta 版升級為穩定版。如需詳細的 API 4.0 規格，請參閱 API 參考資料。我們更新了 Looker 支援和社群支援的 SDK，以支援 Looker API 4.0 正式版端點。詳情請參閱「API 和 SDK 支援政策」和「API 版本管理」。本文其餘部分將說明破壞性變更、因應措施，以及遷移至 API 4.0 正式版後可望獲得的功能。
這份文件適合哪些人閱讀？
如果您透過 Looker 支援的 SDK、社群支援的 SDK 或 API 本身使用 Looker API，請參閱本文。請閱讀與您使用的 Looker API 版本對應的章節。
API 4.0 正式發布前版本使用者
如果您使用 API 4.0，請閱讀本節。本文說明遷移至 API 4.0 正式版時的重大變更，以及可用的解決方式。
API 4.0 正式版會將所有實體 ID 欄位從數字 integer 型別變更為 string 型別。舉例來說，GET /groups/{group_id} endpoint 會傳回 id 做為 string 類型，而不是 int64 類型。
請詳閱下表，瞭解使用 API 4.0 端點的影響和因應措施：
| 用量 | 潛在影響1 | 預防措施 |
| Looker 行動應用程式 | 舊版 Looker 行動應用程式將停止運作 | 請使用者將 Looker 行動應用程式更新至最新版本 |
| Looker 支援的 2 SDK | ||
| TypeScript SDK (4.0 API) | 沒有影響 | 無須採取行動 |
| Python SDK (4.0 API) | 沒有影響 | 無須採取行動 |
| Ruby SDK (4.0 API) | 沒有影響 | 無須採取行動 |
| 社群支援的 2 SDK | ||
| Swift SDK | 執行階段例外狀況 | 將 SDK 更新至 22.0 以上版本，然後解決產生的型別錯誤 (如有) |
| Kotlin SDK | 沒有影響 | 無須採取行動 |
| LookR SDK | 沒有影響 | 無須採取行動 |
| C# SDK | 沒有影響 | 無須採取行動 |
| Go SDK | 執行階段例外狀況 | 將 SDK 更新至 22.0 以上版本，然後解決產生的型別錯誤 (如有) |
| 其他 | ||
| 使用 4.0 版 API，但不使用 SDK (或使用外部提供的程式庫) | 視語言的型別敏感度而定，可能發生執行階段錯誤 | 檢查程式碼，確認是否有任何 ID 欄位類型相依性，並新增對字串類型 ID 欄位的支援。另請參閱這份額外指南。 |
1：假設是常見的使用模式，可能包含使用 Looker 的 ID 欄位，但不包含異常使用模式，例如對 ID 執行數值運算。
2：Looker API 和 SDK 支援。Looker 不會正式支援社群支援的程式庫。
API 3.1 使用者
如果您使用 API 3.1，請閱讀本節。本文將介紹 API 4.0 提供的新功能和變更。請注意，所有 Looker 支援和社群支援的 SDK 主要支援 API 4.0。詳情請參閱「SDK 和 API 支援政策」。
其他 API 4.0 正式發布版功能
為方便起見，我們列出 API 4.0 最顯著且實用的新增項目：
- 建立及管理看板、看板項目和看板區段。如要進一步瞭解看板，請參閱看板說明文件頁面。
- 查詢其他連線資訊，例如資料庫、結構定義、資料欄和資料表。設定及更新其他連結欄位。
- 建立及管理 OAuth 應用程式和使用者。如要進一步瞭解 OAuth，請參閱 OAuth 說明文件頁面。
- 依階層和角色搜尋群組。
- 搜尋角色和使用者人數。
- 取得及設定 Looker 執行個體設定。如要進一步瞭解設定，請參閱設定說明文件頁面。
- 建立及管理快訊。如要進一步瞭解快訊，請參閱快訊說明文件頁面。
- 建立、管理及測試 SSH 通道和 SSH 伺服器。如要進一步瞭解 SSH，請參閱 SSH 說明文件頁面。
- 移動和複製資訊主頁。
- 取得新資訊主頁的相對網址。
- 移動和複製 Look。
- 已簽署的嵌入和未簽署的嵌入密鑰、網址，以及使用者建立和管理。
- 取得更新權杖，以更新登入存取權杖。
- 限制並偏移結果，避免取得所有 LookML 模型和所有使用者。
- 限制並偏移搜尋使用者的結果。
- 以 Swagger 2.x JSON 格式取得 Looker 執行個體 API 規格。
API 4.0 正式版淘汰異動
API 4.0 正式版取代了多個已淘汰的 API 3.1 端點，並提供改良功能。下列端點會受到影響：
- 已移除淘汰的「首頁」端點。請改用看板端點，而非首頁。請參閱「使用看板呈現內容」。
- 已移除已淘汰的 Space 端點。請改用資料夾端點，而非 Space。請參閱「整理及管理內容存取權」。
API 3.0 使用者
API 3.0 已淘汰，建議您遷移至 API 4.0。
- 只有 API 4.0 支援所有 Looker 支援和社群支援的 SDK，可簡化開發作業。歡迎查看我們的 SDK 存放區。
- API 4.0 推出多項新功能和強化項目，詳情請參閱本頁的「API 4.0 正式版新增功能」一節。
總結
API 4.0 將新增多項功能，並進行加成變更，您隨時可以在 API 參考資料中查看最新變更。詳情請參閱「API 和 SDK 支援政策」和「API 版本管理」。我們瞭解破壞性變更並非理想做法，除非發生極端問題，否則我們不會對正式發布的 API 4.0 進行任何重大變更。我們希望正式發布的 Looker API 4.0 能協助您在 Looker 平台上更有效率地輕鬆開發產品。