Tổng quan
API Trang là một nhóm điểm cuối API Đồ thị của Facebook mà các ứng dụng có thể dùng để tạo và quản lý nội dung cũng như các cài đặt của Trang.
Thành phần
Mã truy cập
Quá trình xác thực API được xử lý thông qua Mã truy cập. Hầu hết điểm cuối đều yêu cầu mã truy cập Trang. Đây là mã riêng biệt cho từng Trang, Người dùng ứng dụng và ứng dụng. Mã này có thời hạn. Để lấy mã từ một Người dùng ứng dụng, Người dùng ứng dụng này phải sở hữu hoặc có thể thực hiện một Tác vụ trên Trang.
Bạn có thể lấy mã truy cập từ Người dùng ứng dụng bằng cách triển khai phương thức Đăng nhập bằng Facebook.
Đối với những Trang đã được chuyển sang Trải nghiệm Trang mới, giờ đây, bạn cần có mã truy cập Trang để truy cập vào mọi điểm cuối hiện có, ngoại trừ những trường hợp sau đây:
API Đồ thị
Nếu bạn chưa quen dùng API Đồ thị, vui lòng đọc tài liệu về API Đồ thị của chúng tôi trước khi tiếp tục để tìm hiểm thêm về đồ thị mạng xã hội của Meta.
Đăng nhập bằng Facebook
Thông qua phương thức Đăng nhập bằng Facebook, người dùng ứng dụng có thể đăng nhập vào ứng dụng của bạn, cũng như để ứng dụng đó yêu cầu người dùng cấp quyền truy cập dữ liệu.
Đăng nhập bằng Facebook cho doanh nghiệp
Đăng nhập bằng Facebook cho doanh nghiệp là một giải pháp xác thực và ủy quyền ưu tiên dành cho những Nhà cung cấp công nghệ và nhà phát triển ứng dụng kinh doanh cần quyền truy cập vào tài sản của khách hàng doanh nghiệp
Tính năng
Một số điểm cuối yêu cầu Tính năng phải được phê duyệt thông qua quy trình Xét duyệt ứng dụng. Như vậy, ứng dụng của bạn mới dùng được tính năng đó khi phát hành chính thức. Với các tính năng, bạn có thể truy cập dữ liệu Trang công khai mà không cần có quyền hoặc khả năng thực hiện một tác vụ trên Trang. Hãy xem tài liệu tham khảo của từng điểm cuối để xác định Tính năng trên Trang mà điểm cuối đó yêu cầu.
Lượt nhắc
Với công cụ @nhắc đến, Trang của bạn có thể trả lời công khai một người dùng cụ thể - người đã đăng bài trên Trang hoặc bình luận về bài viết trên Trang đó - trong bình luận hoặc tin trả lời.
ID người dùng trong Trang
Người dùng tương tác với Trang được xác định theo ID người dùng trong Trang (PSID). PSID là ID riêng biệt cho mỗi cặp Trang-Người dùng. Các điểm cuối API Trang và Nền tảng Messenger dựa vào PSID. Do đó, bạn có thể dùng PSID để xác định hoạt động tương tác của một Người dùng với Trang, cũng như các cuộc trò chuyện công khai trên Messenger của Người dùng này với Trang đó.
Quyền
Hầu hết điểm cuối đều yêu cầu người dùng ứng dụng phải cấp cho ứng dụng của bạn một hoặc nhiều quyền. Thông thường, bạn có thể thực hiện việc này thông qua phương thức Đăng nhập bằng Facebook. Tuy nhiên, bạn cũng có thể sử dụng Trình quản lý kinh doanh nếu ứng dụng của bạn đã được một Doanh nghiệp xác nhận quyền sở hữu.
Tất cả các quyền đều phải trải qua quy trình Xét duyệt ứng dụng thì người dùng ứng dụng mới có thể cấp các quyền đó cho ứng dụng của bạn khi ứng dụng ở chế độ chính thức. Đối với ứng dụng dành cho Doanh nghiệp (không có chế độ ứng dụng), các quyền phải được phê duyệt Quyền truy cập nâng cao thì người dùng ứng dụng mới có thể cấp các quyền đó cho ứng dụng của bạn mà không cần có vai trò trên chính ứng dụng đó hoặc trong Doanh nghiệp đã xác nhận quyền sở hữu ứng dụng.
Tìm kiếm trên Trang
Tìm thông tin về Trang Facebook (bao gồm cả tên, vị trí), tìm Trang để @Nhắc đến, vị trí trên Trang và gắn thẻ Trang để hiển thị nội dung có thương hiệu.
Giới hạn tốc độ
Mọi yêu cầu đến điểm cuối Trang đều bị Giới hạn tốc độ. Bạn có thể xem số lần sử dụng lệnh gọi hiện tại của ứng dụng trong Bảng điều khiển ứng dụng.
Tác vụ
Với các tác vụ, Người dùng có thể thực hiện những hành động cụ thể trên Trang. Khi Người dùng sử dụng một ứng dụng để tương tác với Trang, tùy vào hành động mà người dùng này cố gắng thực hiện, trước tiên, chúng tôi sẽ kiểm tra xem Người dùng có được phép thực hiện một tác vụ cho phép loại hành động đó hay không.
Bạn có thể cho phép từng người dùng thực hiện các tác vụ sau đây:
| Tác vụ | Hành động được phép |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Nếu một người dùng được cấp Quyền truy cập quản trị vào Trang trong giao diện người dùng, người dùng này có thể thực hiện mọi tác vụ trên Trang đó.
Nền tảng Messenger
Trò chuyện trên Messenger với khách hàng hoặc những người quan tâm đến Trang của bạn.
Webhooks cho Trang của Meta
Nhận thông báo theo thời gian thực khi một người dùng bình luận về bài viết bất kỳ trên Trang hoặc bày tỏ cảm xúc với bài viết của bạn trên Trang.
Xét duyệt ứng dụng
Tất cả các Quyền và Tính năng liên quan đến Trang đều phải được phê duyệt thông qua quy trình Xét duyệt ứng dụng. Như vậy, ứng dụng của bạn mới dùng được các quyền và tính năng đó khi phát hành chính thức.
Các ứng dụng ở Chế độ phát triển có thể yêu cầu bất kỳ Quyền nào từ mọi Người dùng ứng dụng đang đảm nhiệm một Vai trò trong ứng dụng đó.
Cách hoạt động
Dưới đây là quy trình thông thường để truy cập vào API Trang:
- Lấy Mã truy cập dành cho người dùng từ Người dùng ứng dụng thông qua phương thức Đăng nhập bằng Facebook.
- Truy vấn điểm cuối
/me/accountsđể lấy ID và Mã truy cập Trang của Trang mà Người dùng ứng dụng đã cho phép ứng dụng của bạn truy cập. - Chụp ID Trang và Mã truy cập Trang được trả về.
- Sử dụng ID và mã đó để truy vấn nút Trang.
Lưu ý rằng trong một số trường hợp, Người dùng ứng dụng có thể cấp cho ứng dụng quyền truy cập vào nhiều Trang. Trong trường hợp này, bạn nên thu thập từng ID Trang và mã tương ứng, đồng thời cung cấp cách thức để Người dùng ứng dụng nhắm mục tiêu đến từng Trang đó.
Bước tiếp theo
Làm theo hướng dẫn Bắt đầu của chúng tôi để biết cách đăng một bài viết trên Trang bằng API Trang.
Xem thêm
Cùng Meta phát triển ứng dụngXác thực và ủy quyền | Hướng dẫn về TrangTài liệu tham khảo |