立即開始

本指南說明如何開始從 Facebook 社交關係圖接收資料。

準備工作

必備項目:

您的第一項要求

步驟 1:開啟圖形 API 測試工具

在新的瀏覽器視窗中開啟圖形 API 測試工具。這樣您就可以一邊執行範例,一邊查看本教學導覽。

測試工具會載入預設查詢,包括 GET 方法、最新版的圖形 API、查詢字串欄位中的 /me 節點與 idname 欄位,以及您的 Facebook 應用程式。

步驟 2:產生存取權杖

點擊產生存取權杖按鈕。使用 Facebook 帳號登入視窗隨即彈出。此彈出視窗是您的應用程式要求您允許從 Facebook 取得您的姓名和大頭貼照。

此流程是我們的 Facebook 登入產品,可讓用戶使用 Facebook 憑證登入應用程式。Facebook 登入可讓應用程式要求用戶存取自己的 Facebook 資料,並可讓用戶接受或拒絕存取。您的姓名和大頭貼照是公開資訊,可讓其他用戶在 Facebook 上找到您,所以不需要其他條件即可執行此要求。

點擊以…的身分繼續

用戶存取權杖隨即建立。此權杖包含如下資訊:提出要求的應用程式、使用應用程式提出要求的用戶、存取權杖是否仍有效(大約一小時內到期)、到期時間,以及應用程式可以要求的資料範圍。在此要求中,範圍為 public_profile,其中包括您的姓名和大頭貼照。

點擊存取權杖旁邊的資訊圓圈圖示,可檢視權杖的資訊。

步驟 3:提交要求

點擊右上角的提交按鈕。

您應該會看到的內容

回應視窗中,您會看到 JSON 回應顯示您的 Facebook 用戶編號和姓名。

如果您從查詢字串欄位中移除 ?fields=id,name,並點擊提交,仍會看到相同的結果,因為 nameid 是預設傳回的用戶節點欄位。

您的第二項要求

步驟 1:讓我們來新增欄位

我們再新增另一個欄位 email,讓第一項要求變複雜一點。新增欄位的方式有兩種:

  • 點擊回應視窗左側節點欄位檢視器中的搜尋下拉式功能表
  • 開始輸入查詢字串欄位。

新增 email 欄位並點擊提交

您應該會看到的內容

如果呼叫未失敗,則只有 nameid 欄位會隨著偵錯訊息傳回。點擊「(顯示)」連結,以偵錯要求。

幾乎所有節點和欄位都需要特定權限才能存取。偵錯訊息表示,您需要提供應用程式權限,才能存取 Facebook 帳號連結的電子郵件地址。

步驟 2:新增權限

在右側窗格中的權限下,點擊新增權限下拉式功能表。點擊用戶資料權限,並選擇 email

產生新的用戶存取權杖

因為您要變更存取權杖的範圍,所以需要建立新的存取權杖。請點擊產生存取權杖。就像第一項要求,您必須提供應用程式權限,才能在「Facebook 登入」對話方塊中存取電子郵件。

建立新的權杖後,請點擊提交。現在要求中的所有欄位都會傳回。

嘗試取得您的 Facebook 貼文。

查看步驟。

回應中的連結

請注意,回應視窗中傳回的 id 值是連結。這些連結可能代表節點,例如用戶、網頁或貼文。如果您點擊連結,該編號就會取代字串查詢欄位的內容。現在您可以在該節點上執行要求。由於此節點是連結至上層節點(用戶的貼文),所以您不需要新增權限。您現在可以點擊貼文編號,因為我們在下一個範例中會用到它。

注意:有些編號是上層編號與新編號字串的組合。例如,用戶貼文的貼文編號類似這樣:1028223264288_102224043055529,其中 1028223264288 是用戶編號。

我們來看看關係連線

用戶節點並沒有很多可以傳回資料的關係連線。只有擁有物件的用戶可以提供用戶物件的存取權限。在大部分情況下,建立物件的用戶即擁有該物件。

舉例來說,如果您發佈貼文,就可以查看該貼文的相關資訊,例如貼文的建立時間;貼文中分享的文字、相片和連結;以及貼文收到的心情數量。如果您在自己的貼文上留言,就能夠取得該留言,但如果其他人在您的貼文上發佈留言,您就看不到該留言或誰發佈留言。

嘗試取得自己任一貼文的心情數量。您可以查看

物件心情參考資料。

查看步驟。

取得要求的程式碼

測試工具可讓您測試要求,一旦您有了成功的回應,即可取得程式碼來插入您的應用程式程式碼中。點擊回應視窗底部的取得程式碼。測試工具提供 Android、iOS、JavaScript、PHP 和 cURL 程式碼。程式碼已預先選取,所以您只要複製並貼上即可。

建議您為應用程式實作 Facebook SDK。此 SDK 包含 Facebook 登入,可讓您的應用程式要求權限並取得存取權杖。

瞭解詳情

您可以使用圖形 API 測試工具來測試用戶、粉絲專頁、社團等的任何要求。請查看各節點或關係連線的參考資料,判斷所需的權限和存取權杖類型。