升級到最新的圖形 API 版本

本指南說明如何準備您的應用程式來測試不同的圖形 API 版本並升級到最新版本。

較新的 API 版本變更可能影響應用程式的 API 呼叫,這些影響會顯示在 API 升級工具中。您將可以快速查看從現有版本升級到新版本需要進行的變更。

瞭解變更如何影響應用程式

API 升級工具會顯示自訂的變更清單,這些變更將在升級為指定的目標版本時,影響到應用程式。如此可讓您查看來源與目標版本之間的所有相關變更。

步驟 1:在升級工具中,從下拉式功能表選擇您的應用程式,或輸入應用程式的名稱。

下拉式功能表最多僅能列出 10 個應用程式。若要查看較已列出更多的應用程式,請使用下拉式功能表中的搜尋列。

步驟 2:使用右側的下拉式功能表,選擇升級前升級後版本。

查看結果

工具會顯示將應用程式升級到所選版本需要進行的各項變更。如果您的應用程式所發出的 API 呼叫不受較新版本的影響,則不會傳回任何資料。

方法會依影響呼叫的版本以不同色彩標示。暫留在長條圖上,即可查看各個版本的變更數量。各個版本的相關日期指的是對所有應用程式強制執行變更的日期。

資料表會顯示變更類型(淘汰、新功能或變更)、哪些方法受到影響、過去 7 天發出的呼叫次數,以及該特定變更所影響的 API 呼叫百分比。

限制

  • 您必須是應用程式的管理員或開發人員,才能在工具中查看應用程式。
  • 如果您的應用程式尚未從升級前版本發出任何 API 呼叫,或發出的 API 呼叫太少,則不會傳回任何資料。
  • 顯示的呼叫數量可能不正確。API 呼叫記錄是取樣與彙總自上一個星期的結果。這會用於與呼叫量比較,以預估多少呼叫次數可能會受到指定版本變更的影響。

注意:並非所有變更都會影響每個 API 呼叫。對於您的應用程式是否需要處理特定變更,請審慎判斷。請務必測試新版本的 API 呼叫,確保運作正確。

實作新版本

在應用程式主控板「設定 > 進階」中,捲動到升級 API 版本區塊。

將開發人員和管理員升級

此升級會讓應用程式的所有開發人員和管理員升級到下一個可用版本。這允許您在公開發佈新版本之前,使用一小部分真實用戶來測試變更。

升級所有呼叫

此升級會將應用程式發出的所有呼叫,升級到下一個可用版本。早期升級非常實用,因為這項功能保留了回復為原來版本的選項,以因應未預期的錯誤或問題。

瞭解詳情

  • 圖形 API 變更紀錄 - 瞭解最新版本的變更。
  • 版本控制 - 瞭解有關圖形 API 版本控制、針對不同版本的要求等內容。
  • 測試版應用程式 - 瞭解如何建立測試版應用程式,以便在公開發佈之前測試應用程式的變更。
  • 測試用戶 - 瞭解如何建立測試用戶,以便在公開發佈之前測試應用程式的變更。