Hướng dẫn về Trình khám phá API Đồ thị

Cách dùng phổ biến

• Tạo nhanh mã truy cập
• Lấy mã mẫu cho truy vấn của bạn
• Tạo thông tin gỡ lỗi để đưa vào yêu cầu hỗ trợ
• Thử nghiệm truy vấn API với các cài đặt của ứng dụng chính thức mà bạn sở hữu, bao gồm cả quyền, tính năng và cài đặt cho trường hợp sử dụng của bạn
• Thử nghiệm truy vấn API với ứng dụng thử nghiệm/phát triển của bạn bằng cách sử dụng quyền và tính năng đối với người dùng thử nghiệm hoặc dữ liệu thử nghiệm

Yêu cầu

• Một Tài khoản nhà phát triển trên Facebook
• Một ứng dụng mà bạn có vai trò, chẳng hạn như vai trò quản trị viên, nhà phát triển hoặc người dùng thử

Thành phần

Mã truy cập

Khi bạn lấy một mã truy cập, mã đó sẽ hiển thị ở phía trên bên phải của công cụ. Đây là mã mà bạn đưa vào truy vấn API Đồ thị. Bạn có thể sao chép mã này rồi dùng nó trong ứng dụng của mình để thử nghiệm mã bạn có.

Hãy nhấp vào biểu tượng thông tin để xem thông tin về mã hiện tại, bao gồm cả ứng dụng liên kết với mã đó, cũng như bất kỳ quyền nào mà Người dùng ứng dụng (là bạn) đã cấp.

Bạn có thể tạo mã truy cập mới nếu mã nêu trên đã hết hạn hoặc nếu bạn thêm các quyền mới.

Ứng dụng trên Meta

Menu thả xuống Ứng dụng trên Meta ở phía trên bên phải sẽ hiển thị tất cả ứng dụng mà bạn có vai trò quản trị viên, nhà phát triển hoặc người dùng thử. Hãy dùng menu thả xuống này để chọn chế độ cài đặt ứng dụng mà bạn muốn thử nghiệm.

Người dùng hoặc Trang

Với menu thả xuống Người dùng hoặc Trang, bạn có thể lấy và trao đổi mã truy cập dành cho Ứng dụng, Người dùng và Trang đối với ứng dụng hiện được chọn. Bạn cũng có thể sử dụng menu thả xuống này để gỡ cài đặt ứng dụng khỏi nút Người dùng, từ đó hủy mã truy cập hiện tại.

Quyền

Bất cứ khi nào bạn yêu cầu mã truy cập dành cho Người dùng, theo mặc định, hệ thống cũng chỉ cấp một quyền public_profile. Với menu thả xuống Quyền, bạn có thể chọn Quyền truy cập dữ liệu người dùng (ví dụ: email và user_photos), Quyền truy cập Sự kiện, nhóm và Trang (ví dụ: manage_pages và ads_management), cũng như Các quyền khác (ví dụ: quyền instagram_basic và publish_video). Nhờ đó, Người dùng ứng dụng hiện tại (là bạn) có thể cấp các quyền dành riêng cho ứng dụng. Chỉ cấp các quyền mà ứng dụng của bạn thực sự cần.

Nếu ứng dụng của bạn ở chế độ phát triển, bạn có thể cấp cho ứng dụng này bất kỳ quyền nào. Các truy vấn bạn thực hiện sẽ tuân theo những quyền đó đối với dữ liệu thuộc sở hữu của người dùng có vai trò trong ứng dụng của bạn. Tuy nhiên, nếu ứng dụng ở chế độ chính thức, việc cấp một quyền mà ứng dụng chưa được phê duyệt thông qua quy trình Xét duyệt ứng dụng sẽ khiến truy vấn không thành công mỗi khi bạn gửi.

Trường Chuỗi truy vấn

Khi bạn mở công cụ lần đầu tiên, truy vấn mặc định sẽ hiển thị. Bạn có thể chỉnh sửa truy vấn bằng cách nhập một truy vấn mới hoặc tìm kiếm và chọn các trường trong trình xem trường sau khi thực hiện truy vấn. Bạn cũng có thể sử dụng menu thả xuống để chuyển đổi giữa các phương thức thao tác và nhắm mục tiêu các phiên bản API Đồ thị khác nhau.

Nếu bạn nhấp vào biểu tượng dấu sao ở cuối trường truy vấn, truy vấn sẽ được lưu làm mục yêu thích. Bạn có thể xem các truy vấn yêu thích bằng cách nhấp vào biểu tượng sách.

Trình xem trường nút

Khi bạn gửi truy vấn GET trên một nút, trình xem trường (nằm ở phía bên trái cửa sổ) sẽ hiển thị tên của nút đó và các trường do API Đồ thị trả về. Bạn có thể sửa đổi truy vấn bằng cách tìm kiếm và chọn các trường mới, nhấp vào biểu tượng dấu cộng rồi chọn trong số các trường có sẵn hoặc bỏ chọn các trường không cần thiết. Những hành động này sẽ tự động cập nhật truy vấn của bạn trong trường chuỗi truy vấn.

Cửa sổ phản hồi

Phản hồi (nằm ở bên dưới chuỗi truy vấn) sẽ hiển thị kết quả được trả về từ truy vấn bạn gửi gần đây nhất.

Lấy mã

Nếu bạn hài lòng với truy vấn của mình, hãy nhấp vào nút Lấy mã (nằm ở chính giữa dưới cùng bên dưới phản hồi) để tạo mã mẫu dựa trên truy vấn đó. Thông thường, bạn sẽ không thể sao chép và dán trực tiếp mã mẫu vào cơ sở mã của mình, nhưng mã mẫu này sẽ là một điểm khởi đầu hữu ích cho bạn.

Sao chép thông tin gỡ lỗi

Nếu truy vấn tiếp tục bị lỗi và bạn không thể tìm ra lý do, sau đó bạn quyết định liên hệ với Bộ phận hỗ trợ nhà phát triển, hãy nhấp vào nút này (nằm ở chính giữa dưới cùng) để sao chép thông tin chi tiết về truy vấn và phản hồi vào bộ nhớ tạm. Bạn có thể gửi thông tin này kèm theo yêu cầu hỗ trợ để giúp chúng tôi tìm ra vấn đề.

Lưu phiên

Nhấp vào nút Lưu phiên (nằm ở chính giữa dưới cùng) để lưu trạng thái của truy vấn, khi mã truy cập bị gỡ. Thêm liên kết tới phiên này nếu bạn quyết định liên hệ với Bộ phận hỗ trợ nhà phát triển.

Truy vấn mẫu

Hãy thử thực hiện truy vấn mặc định xuất hiện khi bạn tải Trình khám phá API Đồ thị lần đầu. Nếu chưa thực hiện việc này, hãy mở Trình khám phá API Đồ thị trong cửa sổ mới, chọn ứng dụng mà bạn muốn thử nghiệm từ menu thả xuống ứng dụng rồi lấy mã truy cập dành cho Người dùng.

Truy vấn mặc định sẽ xuất hiện trong trường thông tin chuỗi truy vấn:

GET https://developers.facebook.com/v19.0/me?fields=id,name

Truy vấn mặc định sẽ yêu cầu trường id và name trên nút /me. Đây là nút đặc biệt ánh xạ đến nút /User hoặc /Page do mã truy cập xác định. Vì bạn đang sử dụng mã truy cập dành cho Người dùng nên nút này sẽ đối ghép với nút Người dùng.

Trường id và name có sẵn công khai và có thể được trả về nếu Người dùng đã cấp cho ứng dụng của bạn quyền default hoặc public_profile. Những quyền này được phê duyệt trước cho tất cả các ứng dụng (bạn có thể xác nhận điều này bằng cách nhấp vào biểu tượng thông tin trong Trường mã truy cập), do đó, bạn sẽ không phải cấp cho ứng dụng bất kỳ quyền bổ sung nào để truy vấn hoạt động. Nhấp vào Lấy mã truy cập rồi xác nhận rằng bạn muốn cấp cho ứng dụng quyền truy cập vào thông tin Người dùng công khai của mình.

Gửi truy vấn và bạn sẽ nhìn thấy ID người dùng trong ứng dụng cùng với tên của mình trong cửa sổ phản hồi.