圖形 API 測試工具指南
圖形 API 測試工具可讓您建構和執行圖形 API 查詢,並針對您擁有其管理員、開發人員或測試人員角色的任何應用程式,檢視查詢的回應。
需求
-
具有管理員、開發人員或測試人員角色的應用程式。
元件
應用程式下拉式表單
應用程式下拉式功能表會顯示,具有管理員、開發人員或測試人員角色的所有應用程式。使用下拉式表單來選擇要測試的應用程式。
![](https://scontent.fkhh1-1.fna.fbcdn.net/v/t39.2365-6/79251764_578537029630374_1089724127452856320_n.png?_nc_cat=103&ccb=1-7&_nc_sid=ad8a9d&_nc_ohc=nKeEE_gKBGgAX8p9lTA&_nc_ht=scontent.fkhh1-1.fna&oh=00_AT-DrMI421KG-7K5fMiMNa6SRPt00umDdSKfQwut3UAnGQ&oe=6310E371)
「存取權杖」下拉式功能表
「存取權杖」下拉式功能表可在目前所選的應用程式中,取得並交換應用程式、用戶和粉絲專頁存取權杖。這個下拉式功能表也可讓您從用戶節點解除安裝應用程式,其會損毀目前的存取權杖。
![](https://scontent.fkhh1-1.fna.fbcdn.net/v/t39.2365-6/79446757_993982860994763_1363200333165101056_n.png?_nc_cat=106&ccb=1-7&_nc_sid=ad8a9d&_nc_ohc=3IHzzFYaJ4AAX-6m17Y&_nc_ht=scontent.fkhh1-1.fna&oh=00_AT9-7RSX-vcq3bfFLX7pUUsm9p11iUQfz_oX3U177Qwz6w&oe=63108C51)
新增「權限」下拉式功能表
每當您要求用戶存取權杖時,預設僅授予一個權限,即 public_profile
。「權限」下拉式功能表可讓您選擇「用戶資料權限」(例如 email
和 user_photos
)、「活動、社團和粉絲專頁權限」(例如 manage_pages
和 ads_management
),以及「其他」權限(例如 instagram_basic
和 publish_video
權限)。這也可讓目前的應用程式用戶(也就是您自己)授予特定的權限給應用程式。請只授予應用程式確實有需要的權限。
![](https://scontent.fkhh1-2.fna.fbcdn.net/v/t39.2365-6/79532377_432699407662681_8754821856827015168_n.png?_nc_cat=109&ccb=1-7&_nc_sid=ad8a9d&_nc_ohc=sPF5NOSLGekAX9em76F&_nc_ht=scontent.fkhh1-2.fna&oh=00_AT8oeuYu3NU-0GYN_ug8F0G-51sZHzyXzP3pTW6hsnCpJA&oe=6310EAED)
如果您的應用程式處於開發模式,則您可以授予任何權限給應用程式,您的查詢會遵循這些權限。不過,如果您的應用程式上線,則授予應用程式審查程序尚未核准的權限給應用程式,將會導致您每次提交查詢時皆失敗。
存取權杖欄位
當您獲得存取權杖時,此欄位會顯示權杖。這是包含在您圖形 API 查詢中的權杖。
![](https://scontent.fkhh1-2.fna.fbcdn.net/v/t39.2365-6/79241963_579505805926422_7830754897153753088_n.png?_nc_cat=104&ccb=1-7&_nc_sid=ad8a9d&_nc_ohc=KSzdFt5lzBMAX8K-F16&_nc_ht=scontent.fkhh1-2.fna&oh=00_AT-840t_k0hRwGZGqOqmWko9Rc_PQksSkagUBDpX28H3Vg&oe=631223A4)
點擊資訊圖示,檢視關於現有權杖的資訊,包括該權杖所連結的應用程式,以及使用該應用程式的用戶(也就是您自己)所授予的任何登入權限。
![](https://scontent.fkhh1-1.fna.fbcdn.net/v/t39.2365-6/79588248_2531830050434402_8742483506707300352_n.png?_nc_cat=106&ccb=1-7&_nc_sid=ad8a9d&_nc_ohc=7dX-i0GZhbQAX_5Wtsu&_nc_ht=scontent.fkhh1-1.fna&oh=00_AT880VnIyRdy4WUAfSCMrudX3xGtBYHIOle3DcA4RZP7hQ&oe=63119CFF)
查詢字串欄位
目前的查詢會顯示在此處。您可以輸入新的查詢,或在執行查詢後搜尋並選擇欄位檢視器的欄位,以編輯目前的查詢。您也可以使用下拉式功能表來切換操作方式,以及鎖定不同的圖形 API 版本。
如果點擊位於欄位末端的星號圖示,則會將查詢儲存為最愛。點擊書籍圖示就能檢視最愛查詢。
![](https://scontent.fkhh1-1.fna.fbcdn.net/v/t39.2365-6/79433831_2496738383900059_4484149369754353664_n.png?_nc_cat=105&ccb=1-7&_nc_sid=ad8a9d&_nc_ohc=Oei1IMR89lQAX-sTemH&_nc_ht=scontent.fkhh1-1.fna&oh=00_AT8It1qo3RP0EVpJx7ezNQpJLFcbrZy_GCKgmxv-BwZc_Q&oe=6310DA93)
節點欄位檢視器
當您提交對節點的 GET
查詢時,欄位檢視器會顯示該節點的名稱,以及圖形 API 傳回的欄位。若要修改查詢,您可以搜尋和選擇新的欄位、點擊加號圖示,然後從可用的欄位中選擇,或是取消勾選不必要的欄位。這些動作會動態更新您在查詢字串欄位中的查詢內容。
![](https://scontent.fkhh1-1.fna.fbcdn.net/v/t39.2365-6/79360573_437031223866268_5947414435097214976_n.png?_nc_cat=105&ccb=1-7&_nc_sid=ad8a9d&_nc_ohc=e3wx4O1ji3oAX_-yrVD&_nc_ht=scontent.fkhh1-1.fna&oh=00_AT83wnSys6Btju2J7nlgnJ-O6QNxP3wIWexE7dGfwrpxHQ&oe=63122EDA)
回應視窗
此處會顯示對您上一次提交查詢的回應。
![](https://scontent.fkhh1-2.fna.fbcdn.net/v/t39.2365-6/79352250_2571914689754767_3905651054900936704_n.png?_nc_cat=109&ccb=1-7&_nc_sid=ad8a9d&_nc_ohc=MwneuJshPjEAX-a-ePf&_nc_ht=scontent.fkhh1-2.fna&oh=00_AT9ogkYdabpet49TNuQouYCPzSjAWj2ZlC4j7vaOa0ilsQ&oe=631142E3)
取得程式碼
若您滿意查詢,點擊「取得程式碼」按鈕之後就會根據查詢產生程式碼範例。通常您無法將範例程式碼直接複製和貼入程式庫,但這提供一個實用的起點。
![](https://scontent.fkhh1-2.fna.fbcdn.net/v/t39.2365-6/80064637_567020644084611_3472173251394797568_n.png?_nc_cat=107&ccb=1-7&_nc_sid=ad8a9d&_nc_ohc=sH3lBXKf2loAX_zHatO&_nc_ht=scontent.fkhh1-2.fna&oh=00_AT-z_KrHbbPT2y-xiWtgDdM_tkcrrA7i7vOZ9xxY5Xmyqw&oe=6310F614)
複製偵錯資訊
若您的查詢一直失敗且無法找出原因,而決定要聯絡開發人員支援時,請點擊此按鈕,將您的查詢和回應的詳細資料複製到剪貼簿。您可以連同您的支援要求一起提交這項資訊,協助我們找出問題的根源。
![](https://scontent.fkhh1-1.fna.fbcdn.net/v/t39.2365-6/78630150_491884384764225_5239037112371642368_n.png?_nc_cat=103&ccb=1-7&_nc_sid=ad8a9d&_nc_ohc=mxR4Xsa0vzwAX-bqZff&_nc_ht=scontent.fkhh1-1.fna&oh=00_AT90XaJ6OoJTvn4K6beKMeeoT0PZDJPdaJyHPYBpbyYF8Q&oe=63125CF7)
儲存連線階段
點擊「儲存連線階段」按鈕,就能儲存已移除存取權杖的查詢狀態。如果您決定與「開發人員支援」聯絡,請在此連線階段中加入連結。
![](https://scontent.fkhh1-2.fna.fbcdn.net/v/t39.2365-6/79326442_474875476772137_6998622253617250304_n.png?_nc_cat=104&ccb=1-7&_nc_sid=ad8a9d&_nc_ohc=T2AR4cc-fzkAX8-Z-zu&_nc_ht=scontent.fkhh1-2.fna&oh=00_AT-FxQlZpfz5mBHTKvaepFnEWxh6762t151dvQU7ArEdPw&oe=6311D91B)
查詢範例
若您初次載入圖形 API 測試工具,可試著執行出現的預設查詢。如果您尚未準備就緒,請在新的視窗中開啟圖形 API 測試工具、從應用程式下拉式功能表中,選擇您想要測試的應用程式,然後取得用戶存取權杖。
預設的查詢會顯示於查詢字串欄位中:
GET https://developers.facebook.com/v5.0/me?fields=id,name
預設查詢會要求 /me
節點上的 id
和 name
欄位,這個特殊節點會對應權杖所識別的 /User
或 /Page
節點。由於您正在使用用戶存取權杖,這會對應您的用戶節點。
id
和 name
欄位可公開使用,若用戶已授予您應用程式 default
或 public_profile
權限,系統也會傳回這些欄位。這些權限已經針對所有應用程式預先核准(您可以在存取權杖欄位中點擊資訊圖示確認),因此您不需要授予任何額外的權限給應用程式,即可進行查詢。點擊取得存取權杖,然後確認您想要授予權限給應用程式,以存取您公開可取得的用戶資訊。
![](https://scontent.fkhh1-2.fna.fbcdn.net/v/t39.2365-6/79918818_2547429572153654_5190211881201041408_n.png?_nc_cat=111&ccb=1-7&_nc_sid=ad8a9d&_nc_ohc=CprTXZAAPZIAX-3huku&_nc_ht=scontent.fkhh1-2.fna&oh=00_AT9lyUFo9XjIf-rdvdHvNhqqrccaCI1RUeB-sXO4RHC70w&oe=6312181A)
提交查詢之後,您應能查看出現在回應視窗的應用程式範圍用戶編號和名稱。
Source: Graph Explorer Guide – Graph API