升級至最新版本的 Graph API

本指南將介紹如何為您的應用程式做好準備,以測試不同版本的 Graph API 並升級至最新版本。

API 升級工具會顯示由應用程式發出且可能受到較新版本 API 變更影響的 API 呼叫。這樣您就可以快速了解應該要作出哪些變更調整,以便從現有版本升級至較新版本。

了解變更對應用程式的影響

API 升級工具會顯示在升級至指定目標版本時,可能會影響應用程式的自訂變更清單。您可以使用此工具,查看原始版本和目標版本之間的所有相關變更。

第 1 步:在升級工具中,從下拉式選單中選擇您的應用程式,或者輸入應用程式的名稱。

下拉式選單最多只列出十個應用程式。如要查看更多未有列出的應用程式,請使用下拉式選單中的搜尋欄。

第 2 步:使用右側的下拉式選單,選擇您的升級前版本升級後版本

閱讀結果

此工具會顯示將應用程式更新至所選版本所需執行的變更項目數量。如果應用程式執行的 API 呼叫不會受到較新版本的影響,則不會傳回資料。

方法會根據影響呼叫的版本而顯示不同顏色的標記。將鼠標移到棒形圖上方,即可查看每個版本的變更數量。與各個版本關聯的日期是對所有應用程式執行變更的日期。

圖表會顯示變更類型(停用、新功能或變更)、受影響的方法、過去 7 天內執行的呼叫次數,以及受特定變更項目影響的 API 呼叫百分比。

限制

  • 您必須是應用程式的管理員或開發人員,才能在工具中查看有關應用程式。
  • 如果應用程式未從升級前版本呼叫任何 API 或呼叫 API 次數太少,則不會傳回資料。
  • 所顯示的呼叫數量可能不正確。API 呼叫記錄由系統在過去一星期採樣和彙整,然後與呼叫數量對比,以估計有多少呼叫會受特定變更版本所影響。

請注意:不是所有變更都會影響每個 API 呼叫。請自行判斷您的應用程式是否需要處理特定的變更。請務必在較新版本中測試您的 API 呼叫,以確保呼叫能夠正常運作。

執行新版本

在應用程式管理中心設定 > 進階中,捲動至升級 API 版本部分。

升級開發人員和管理員

此操作可將應用程式的所有開發人員和管理員升級至下一個可用版本。這樣,您便可以在公開發佈新版本之前,對一小部分真實用戶測試變更。

升級所有呼叫

此操作功能可將應用程式所執行的所有呼叫升級至下一個可用版本。及早升級功能十分有用,因為當您遇到任何預期外錯誤或問題時,您都可以選擇靠此退回原始版本。

了解詳情

  • Graph API 變更記錄 – 了解最新版本的變更。
  • 版本控制 – 全面了解有關 Graph API 版本控制、對不同版本的要求等資訊。
  • 測試應用程式 – 了解如何建立測試版應用程式,以便在公開發佈之前測試應用程式的變更。
  • 測試用戶 – 了解如何建立測試用戶,以便在公開發佈之前測試應用程式的變更。