API Đồ thị

Bắt đầu

Hướng dẫn này giải thích cách bắt đầu nhận dữ liệu từ Đồ thị mạng xã hội trên Facebook.

Trước khi bạn bắt đầu

Bạn sẽ cần:

Yêu cầu đầu tiên của bạn

Bước 1: Mở công cụ Trình khám phá API Đồ thị

Mở Trình khám phá API Đồ thị trong một cửa sổ trình duyệt mới. Như vậy, bạn có thể thực hiện các ví dụ khi đọc hướng dẫn này.

Trình khám phá này sẽ tải truy vấn mặc định bằng phương thức GET, phiên bản mới nhất của API Đồ thị, nút /me cũng như các trường id và name trong Trường chuỗi truy vấn cùng Ứng dụng trên Facebook của bạn.

Bước 2. Tạo mã truy cập

Nhấp vào nút Tạo mã truy cập. Cửa sổ Đăng nhập bằng Facebook sẽ bật lên. Trong cửa sổ bật lên này, ứng dụng của bạn đang yêu cầu bạn cấp quyền để lấy tên và ảnh đại diện của bạn trên Facebook.

Quy trình này là sản phẩm Đăng nhập bằng Facebook của chúng tôi, cho phép một người đăng nhập vào ứng dụng bằng thông tin đăng nhập Facebook của họ. Với phương thức Đăng nhập bằng Facebook, ứng dụng có thể yêu cầu một người truy cập vào dữ liệu trên Facebook của họ và để người đó chấp nhận hoặc từ chối quyền truy cập. Tên và ảnh đại diện của bạn hiển thị công khai để mọi người có thể tìm thấy bạn trên Facebook. Vì vậy, bạn có thể chạy yêu cầu này mà không cần thêm yêu cầu nào.

Nhấp vào Tiếp tục dưới tên...

Hệ thống sẽ tạo một Mã truy cập dành cho người dùng. Mã này chứa các thông tin như ứng dụng gửi yêu cầu, người dùng ứng dụng để gửi yêu cầu, mã truy cập còn hợp lệ hay không (mã truy cập sẽ hết hạn trong khoảng 1 giờ), thời gian hết hạn cũng như phạm vi dữ liệu mà ứng dụng có thể yêu cầu. Trong yêu cầu này, phạm vi là public_profile bao gồm tên và ảnh đại diện của bạn.

Nhấp vào biểu tượng nút tròn thông tin bên cạnh mã truy cập để xem thông tin của mã đó.

Bước 3. Gửi yêu cầu

Nhấp vào nút Gửi ở góc trên bên phải.

Nội dung bạn sẽ nhìn thấy

Trong Cửa sổ phản hồi, bạn sẽ thấy một phản hồi JSON có ID người dùng Facebook và tên của bạn.

Nếu bạn xóa ?fields=id,name khỏi trường chuỗi truy vấn và nhấp vào Gửi, bạn sẽ thấy kết quả tương tự vì name và id là các trường nút Người dùng được trả về theo mặc định.

Yêu cầu thứ hai của bạn

Bước 1. Thêm trường

Hãy làm cho Yêu cầu đầu tiên phức tạp hơn một chút bằng cách thêm trường khác - email. Có 2 cách thêm trường:

  • Nhấp vào menu tìm kiếm thả xuống trong Trình xem trường nút ở bên trái cửa sổ phản hồi
  • Bắt đầu nhập vào trường chuỗi truy vấn.

Hãy thêm trường email rồi nhấp vào Gửi.

Nội dung bạn sẽ nhìn thấy

Nếu lệnh gọi không thất bại, hệ thống chỉ trả về các trường name và id cùng với thông báo gỡ lỗi. Hãy nhấp vào liên kết (Hiển thị) để gỡ lỗi yêu cầu.

Bạn cần có quyền cụ thể thì mới truy cập được gần như tất cả các nút và trường. Thông báo gỡ lỗi này cho biết rằng bạn cần cấp quyền cho ứng dụng của mình để truy cập vào địa chỉ email mà bạn đã liên kết với tài khoản Facebook.

Bước 2. Thêm quyền

Tại phần Quyền trong bảng điều khiển bên phải, hãy nhấp vào menu thả xuống Thêm quyền. Hãy nhấp vào Quyền dữ liệu của người dùng rồi chọn email.

Tạo mã truy cập mới dành cho người dùng

Vì bạn đang thay đổi phạm vi của mã truy cập nên bạn cần tạo mã truy cập mới. Hãy nhấp vào Tạo mã truy cập. Cũng giống như yêu cầu đầu tiên, bạn phải cấp quyền cho ứng dụng của mình để truy cập vào email trong hộp thoại Đăng nhập bằng Facebook.

Sau khi hệ thống tạo mã mới, hãy nhấp vào Gửi. Bây giờ, tất cả các trường trong yêu cầu của bạn sẽ được trả về.

Hãy thử lấy bài viết trên Facebook của bạn.

Xem các bước.

Liên kết trong phản hồi

Lưu ý rằng giá trị id được trả về trong cửa sổ phản hồi là liên kết. Các liên kết này có thể đại diện cho nút, chẳng hạn như Người dùng, Trang hoặc Bài viết. Nếu bạn nhấp vào một liên kết, ID sẽ thay thế nội dung của trường chuỗi truy vấn. Bây giờ, bạn có thể chạy yêu cầu trên nút đó. Vì nút này được kết nối với nút chính là Bài viết của Người dùng nên có thể bạn không cần thêm quyền. Bây giờ, bạn có thể nhấp vào ID bài viết vì chúng tôi sẽ sử dụng ID đó trong ví dụ tiếp theo.

Lưu ý: Một số ID là tổ hợp của ID chính và một chuỗi ID mới. Ví dụ: Bài viết của Người dùng sẽ có ID bài viết có dạng như sau: 1028223264288_102224043055529, trong đó, 1028223264288 là ID người dùng.

Hãy xem xét cạnh

Nút Người dùng không có nhiều cạnh có thể trả về dữ liệu. Chỉ Người dùng sở hữu đối tượng mới có thể cấp quyền truy cập vào đối tượng của Người dùng đó. Trong hầu hết các trường hợp, Người dùng sẽ sở hữu đối tượng nếu họ là người tạo đối tượng đó.

Ví dụ: nếu đăng bài viết thì bạn có thể thấy thông tin về bài viết đó, chẳng hạn như thời điểm tạo bài viết, văn bản, ảnh và liên kết được chia sẻ trong bài viết, cũng như số lượt bày tỏ cảm xúc mà bài viết đó nhận được. Nếu bình luận trên bài viết của mình, bạn sẽ có thể thấy bình luận đó. Tuy nhiên, nếu người khác đăng bình luận trên bài viết của bạn, bạn sẽ không thể thấy bình luận hay người đăng bình luận đó.

Hãy thử lấy số lượt bày tỏ cảm xúc cho một trong các bài viết của bạn. Bạn sẽ muốn xem

Tài liệu tham khảo về Lượt bày tỏ cảm xúc với đối tượng.

Xem các bước.

Lấy mã cho yêu cầu của bạn

Với công cụ trình khám phá, bạn có thể thử nghiệm yêu cầu. Sau khi nhận được phản hồi thành công, bạn có thể lấy mã đó để thêm vào mã ứng dụng của mình. Ở cuối cửa sổ phản hồi, hãy nhấp vào Lấy mã. Trình khám phá này sẽ cung cấp mã cho Android, iOS, JavaScript và cURL. Mã này được chọn sẵn nên bạn chỉ cần sao chép và dán.

Bạn nên triển khai Facebook SDK cho ứng dụng của mình. SDK này sẽ bao gồm phương thức Đăng nhập bằng Facebook để ứng dụng của bạn có thể yêu cầu quyền và lấy mã truy cập.

Tìm hiểu thêm

Bạn có thể sử dụng Trình khám phá API Đồ thị để thử nghiệm yêu cầu bất kỳ đối với Người dùng, Trang, Nhóm và hơn thế nữa. Hãy truy cập vào tài liệu tham khảo cho từng nút hoặc cạnh để xác định quyền và loại mã truy cập cần có.