Lightning Platform API 舊版淘汰

變更的內容是什麼？

隨 Summer ‘21 版發行，下列 Lightning Platform API 舊版將淘汰，且不再受 Salesforce 支援：

*預計時間為 2021 年 6 月；日期可能變更。

客戶可以繼續使用舊版 API 至 Summer ‘21 為止，屆時這些舊版將無法使用。當舊版淘汰後，使用受影響版本 API 的應用程式將會遭到中斷，因為要求將會失敗並導致錯誤，指出要求的端點已停用。

我需要採取哪些行動？

在 Summer ‘21 版本之前，客戶必須修改或升級應用程式，才能與最新的 API 版本搭配使用，進而避免軟體參照已淘汰版本所造成的中斷。升級為新版 API 可獲得進階功能，安全性與效能也更為提升。

我該如何知道我的應用程式中是否使用受影響之舊版的 API？

若要找出使用將被淘汰 API 的應用程式，請連絡您組織所使用之應用程式的開發人員，以判定正在使用的 API 版本。

如果您無法連絡應用程式的開發人員，可透過下列步驟，從您的 Salesforce 組織檢閱報告 SOAP 和 REST API 活動的事件記錄：

使用如 Salesforce CLI 等工具對 EventLogFile 物件執行 SOQL 查詢，這會提供您組織在過去 24 小時內所有已採取動作的記錄。
1. sfdx force:data:soql:query -q "SELECT LogFile, EventType, CreatedDate FROM EventLogFile WHERE EventType IN ('API', 'RestApi')" -u <your-username>
對於每個結果，使用端點執行 REST 要求以取得資料，並複製到 .CSV 檔案。
1. 例如：/services/data/v46.0/sobjects/EventLogFile/0AT3i000005vXpWGAU/LogFile
2. 將回應內文貼入應用程式 (如 Excel) 中，以 .CSV 檔案更輕鬆檢視事件記錄。
檢閱每個 .CSV 檔案並判定系統是否向 API 版本低於 20 的端點發出要求。
1. SOAP / API EventType -- 檢閱 API_VERSION 欄中 API_TYPE 記錄的值「E」或「P」
2. REST / RestApi EventType -- 查看 URI 欄中的值，並注意路徑中具有「/v20.0」或更低版本的端點
任何使用 20 或以下版本的整合將受到此 API 淘汰的影響。

如需詳細資訊，請參閱「如何下載與視覺化事件記錄檔案」Trailhead 模組。

針對 Bulk API，請瀏覽至「設定」中的「大量資料載入工作」頁面並檢視每個「Bulk V1」工作的詳細資料。「API 版本」欄位中出現 20.0 或以下值的工作將受到此 API 淘汰的影響。

你們為什麼要淘汰此產品？

我們正致力於增強最新版 API 的研發工作，以改善透過應用程式建立自訂功能時的整體 Salesforce 體驗。

如何取得詳細資訊？

如需最新 SOAP API 版本支援功能的詳細資訊，請造訪 Salesforce 開發人員網站並參考下列文件：

如有其他問題，您可透過「說明和訓練」入口網頁向客戶支援開啟個案。