新手指南
本指南會講解如何開始從 Facebook 社交關係圖接收資料。
準備工作
您需要完成或準備下列事項：
- Meta 應用程式 – 此 Meta 應用程式將作測試之用，因此建立此應用程式時無需使用應用程式代碼。
- 以另一個瀏覽器視窗開啟 Graph API 測試工具。
- 參閱我們的 Graph API 概覽指南，大概了解 Meta 社交關係圖的結構。
您的第一個要求
第 1 步：開啟 Graph API 測試工具
在另一個瀏覽器視窗中開啟 Graph API 測試工具，以便一邊執行範例，一邊觀看本教學導覽。
測試工具會載入預設查詢，其中包括 GET 方法、最新版本的 Graph API、查詢字串欄位中的 /me 節點與 id 和 name 欄位，以及您的 Facebook 應用程式。
第 2 步：產生存取憑證
點擊產生存取憑證按鈕。此時，使用 Facebook 帳戶登入視窗隨即彈出。在此彈出式視窗中，您的應用程式會要求您授權從 Facebook 獲取您的姓名和個人資料相片。
此流程展示的是我們的 Facebook 登入產品，可讓用戶使用 Facebook 憑證登入應用程式。Facebook 登入可讓應用程式要求用戶存取自己的 Facebook 資料，也可以讓用戶選擇接受或拒絕存取。您的姓名和個人資料相片為公開資訊，可讓其他用戶在 Facebook 上找到您，因此無需符合其他條件都可執行此要求。 點擊以…的身分繼續 用戶存取憑證隨即建立。此憑證包含以下資訊：執行要求的應用程式、使用應用程式執行要求的用戶、存取憑證是否仍然有效（大約一小時後到期）、到期時間、應用程式可要求的資料範圍等。在此要求中，範圍為 |  |
 | 點擊存取憑證旁的圓形資訊圖示，即可查看憑證資訊。 |
第 3 步：提交要求
點擊右上角的提交按鈕。
您應該會看到的內容
在回應視窗中，您會看到 JSON 回應顯示您的 Facebook 用戶帳號和姓名。
如果您從查詢字串欄位中移除 ?fields=id,name 並點擊提交，您仍會看到相同結果，這是因為 name 和 id 是預設傳回的用戶節點欄位。
您的第二個要求
第 1 步：新增欄位
讓我們再新增一個欄位 email，讓第一個要求變得更為複雜。您可以使用兩種方式來新增欄位：
- 點擊回應視窗左側節點欄位檢視器中的搜尋下拉式選單
- 開始在查詢字串欄位輸入內容。
新增 email 欄位並點擊提交。
您應該會看到的內容
如果呼叫沒有失敗，系統只會傳回 name 和 id 欄位，以及一則偵錯訊息。點擊（顯示）連結以對要求偵錯。
幾乎所有節點和欄位都需要特定權限才能被存取。偵錯訊息會表示您需要為應用程式提供相應權限，應用程式才能存取您與 Facebook 帳戶關聯的電郵地址。
第 2 步：新增權限
在右側面板中的權限下方，點擊新增權限下拉式選單。點擊用戶資料權限，然後選擇 email。 產生新的用戶存取憑證由於要變更存取憑證的範圍，所以您需要建立新的存取憑證。點擊產生用戶存取憑證。與第一個要求一樣，您必須在 Facebook 登入對話框中提供應用程式權限，應用程式才能存取您的電郵。 建立新的憑證後，請點擊提交。現在，要求中的所有欄位都會傳回。 |  |
嘗試獲取您的 Facebook 帖子。
回應中的連結
請注意，回應視窗中傳回的 id 值是連結。這些連結可以表示用戶、專頁或帖子等節點。如果點擊這些連結，該編號即會取代查詢字串欄位的內容。現在，您可以在該節點上執行要求。由於此節點已連接至母節點（用戶的帖子），您可能無需新增權限。您現在可以點擊帖子編號，因為我們會在下一個範例中用到此編號。
請注意：部分編號是母編號和新編號字串的組合。例如，用戶的帖子編號可以如下所示：1028223264288_102224043055529，其中 1028223264288 為用戶帳號。
獲取要求代碼
測試工具可作測試要求之用；取得成功回應後，您可以獲取代碼並將其插入應用程式代碼之中。點擊回應視窗底部的獲取代碼。測試工具提供 Android、iOS、JavaScript、PHP 和 cURL 代碼。代碼為預先選取，因此您只需複製並貼上即可。
建議您為應用程式執行 Facebook SDK。此 SDK 將會包含 Facebook 登入，可讓您的應用程式要求權限並取得存取憑證。