本指南說明如何開始從 Facebook 社交關係圖接收資料。
必備項目:
在新的瀏覽器視窗中開啟圖形 API 測試工具。這樣您就可以一邊執行範例,一邊查看本教學導覽。
測試工具會載入預設查詢,包括 GET
方法、最新版的圖形 API、查詢字串欄位中的 /me
節點與 id
和 name
欄位,以及您的 Facebook 應用程式。
點擊產生存取權杖按鈕。使用 Facebook 帳號登入視窗隨即彈出。此彈出視窗是您的應用程式要求您允許從 Facebook 取得您的姓名和大頭貼照。
此流程是我們的 Facebook 登入產品,可讓用戶使用 Facebook 憑證登入應用程式。Facebook 登入可讓應用程式要求用戶存取自己的 Facebook 資料,並可讓用戶接受或拒絕存取。您的姓名和大頭貼照是公開資訊,可讓其他用戶在 Facebook 上找到您,所以不需要其他條件即可執行此要求。 點擊以…的身分繼續 用戶存取權杖隨即建立。此權杖包含如下資訊:提出要求的應用程式、使用應用程式提出要求的用戶、存取權杖是否仍有效(大約一小時內到期)、到期時間,以及應用程式可以要求的資料範圍。在此要求中,範圍為 |
點擊存取權杖旁邊的資訊圓圈圖示,可檢視權杖的資訊。 |
點擊右上角的提交按鈕。
在回應視窗中,您會看到 JSON 回應顯示您的 Facebook 用戶編號和姓名。
如果您從查詢字串欄位中移除 ?fields=id,name
,並點擊提交,仍會看到相同的結果,因為 name
和 id
是預設傳回的用戶節點欄位。
我們再新增另一個欄位 email
,讓第一項要求變複雜一點。新增欄位的方式有兩種:
新增 email
欄位並點擊提交。
如果呼叫未失敗,則只有 name
和 id
欄位會隨著偵錯訊息傳回。點擊「(顯示)」連結,以偵錯要求。
幾乎所有節點和欄位都需要特定權限才能存取。偵錯訊息表示,您需要提供應用程式權限,才能存取 Facebook 帳號連結的電子郵件地址。
在右側窗格中的權限下,點擊新增權限下拉式功能表。點擊用戶資料權限,並選擇 email。 產生新的用戶存取權杖因為您要變更存取權杖的範圍,所以需要建立新的存取權杖。請點擊產生存取權杖。就像第一項要求,您必須提供應用程式權限,才能在「Facebook 登入」對話方塊中存取電子郵件。 建立新的權杖後,請點擊提交。現在要求中的所有欄位都會傳回。 |
嘗試取得您的 Facebook 貼文。
請注意,回應視窗中傳回的 id
值是連結。這些連結可能代表節點,例如用戶、網頁或貼文。如果您點擊連結,該編號就會取代字串查詢欄位的內容。現在您可以在該節點上執行要求。由於此節點是連結至上層節點(用戶的貼文),所以您不需要新增權限。您現在可以點擊貼文編號,因為我們在下一個範例中會用到它。
注意:有些編號是上層編號與新編號字串的組合。例如,用戶貼文的貼文編號類似這樣:1028223264288_102224043055529
,其中 1028223264288
是用戶編號。
測試工具可讓您測試要求,一旦您有了成功的回應,即可取得程式碼來插入您的應用程式程式碼中。點擊回應視窗底部的取得程式碼。測試工具提供 Android、iOS、JavaScript、PHP 和 cURL 程式碼。程式碼已預先選取,所以您只要複製並貼上即可。
建議您為應用程式實作 Facebook SDK。此 SDK 包含 Facebook 登入,可讓您的應用程式要求權限並取得存取權杖。