Hộp thoại Nguồn cấp dữ liệu

Bạn có thể thêm Hộp thoại Nguồn cấp dữ liệu vào ứng dụng của mình để mọi người có thể đăng từng tin kèm bình luận lên dòng thời gian của họ.

Việc chia sẻ tin qua hộp thoại nguồn cấp dữ liệu không yêu cầu bất kỳ quyền mở rộng nào.

Tiện ích tích hợp

Hộp thoại này có thể được dùng với Facebook SDK dành cho JavaScript, iOS và Android bằng cách thực hiện chuyển hướng toàn bộ đến một URL. Dưới đây là một số đoạn mã mẫu có thể dùng để kích hoạt hộp thoại này.

JavaScript

Để kích hoạt Hộp thoại Nguồn cấp dữ liệu, hãy gọi hàm FB.ui và sử dụng giá trị feed cho thông số method.

FB.ui({
  method: 'feed',
  link: 'https://developers.facebook.com/docs/'
}, function(response){});

iOS

Hãy đọc hướng dẫn về Hộp thoại chia sẻ dành cho iOS của chúng tôi. Hướng dẫn này cũng hỗ trợ bạn đăng tin bằng Open Graph.

Android

Hãy đọc hướng dẫn về Hộp thoại chia sẻ dành cho Android của chúng tôi. Hướng dẫn này cũng hỗ trợ bạn đăng tin bằng Open Graph.

Chuyển hướng URL

https://www.facebook.com/dialog/feed?
  app_id=145634995501895
  &display=popup
  &link=https%3A%2F%2Fdevelopers.facebook.com%2Fdocs%2F
  &redirect_uri=https://developers.facebook.com/tools/explorer

Lưu ý

Nếu một người đã đặt thành "Chỉ mình tôi" cho cài đặt "Ai có thể đăng lên dòng thời gian của bạn?" và một người khác cố đăng tin lên dòng thời gian của người thứ nhất bằng hộp thoại Nguồn cấp dữ liệu, lỗi "Không thể đăng" sẽ hiển thị.

Thông số

Lưu ý: Nếu nội dung chia sẻ ứng dụng của bạn liên kết đến iTunes hoặc cửa hàng Google Play hay một trang hoặc trang cá nhân trên Facebook, chúng tôi sẽ không đăng bất kỳ hình ảnh hoặc nội dung mô tả nào mà bạn chỉ định trong nội dung chia sẻ có các thông số dưới đây. Thay vào đó, chúng tôi sẽ đăng trực tiếp một số thông tin ứng dụng mà chúng tôi thu thập được từ cửa hàng ứng dụng hoặc trang Facebook bằng Webcrawler. Thông tin này có thể không bao gồm hình ảnh. Nếu muốn xem trước nội dung chia sẻ liên kết với iTunes hoặc Google Play, hãy nhập URL của bạn vào Trình gỡ lỗi chia sẻ.

Thông số	Mô tả
`app_id`	Thông tin nhận dạng duy nhất của ứng dụng. Bắt buộc.
`redirect_uri`	URL sẽ chuyển hướng đến sau khi một người nhấp vào nút trên hộp thoại. Bắt buộc khi sử dụng chuyển hướng URL.
`display`	Xác định cách hiển thị hộp thoại. Nếu bạn đang triển khai hộp thoại chuyển hướng URL, hộp thoại này sẽ là màn hình toàn trang hiển thị trong Facebook.com. Kiểu hiển thị này được gọi là `page`. Nếu bạn đang sử dụng Facebook SDK dành cho iOS hoặc Android để gọi hộp thoại, hộp thoại này sẽ tự động được chỉ định và chọn kiểu hiển thị phù hợp cho thiết bị. Nếu bạn đang sử dụng Facebook SDK for Javascript, hộp thoại này sẽ mặc định là kiểu `iframe` cho những người đã đăng nhập vào ứng dụng của bạn hoặc là `async` khi sử dụng trong một game trên Facebook.com và là cửa sổ `popup` cho những người khác. Nếu cần thiết, bạn cũng có thể buộc hiển thị theo kiểu `popup` hoặc `page` khi sử dụng Facebook SDK for JavaScript. Các ứng dụng web di động luôn mặc định là kiểu hiển thị `touch`.
`from`	ID của người đăng tin nhắn. Nếu không được chỉ định, ID này mặc định sẽ là ID của người dùng hiện tại. Nếu được chỉ định, ID này phải là ID của người đó hoặc của trang mà người đó quản lý.
`to`	ID của trang cá nhân sẽ đăng tin này lên. Nếu không được chỉ định, ID này mặc định sẽ là giá trị `from`. ID này phải là ID của một người bạn cũng dùng ứng dụng của bạn.
`link`	Liên kết được đính kèm vào bài viết này.
`source`	URL của file phương tiện (SWF hoặc MP3) được đính kèm vào bài viết này. Nếu là SWF, bạn cũng phải chỉ định `picture` để cung cấp hình thu nhỏ của video.
`ref`	Đối số này là một danh sách được phân tách bằng dấu phẩy, gồm tối đa 5 mục riêng biệt, mỗi mục có độ dài tối thiểu là 1 và tối đa là 15 ký tự được lấy từ tập hợp "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz_". Mỗi hạng mục đều được sử dụng trong Thông tin chi tiết trên Facebook nhằm giúp bạn đo lường hiệu quả của các loại bài viết khác nhau

Thông số không còn dùng nữa

Thông số	Mô tả
`post_id`	ID của tin đã đăng, nếu người dùng chọn đăng lên dòng thời gian của mình.
`properties`	Đối tượng JSON của cặp khóa/giá trị sẽ xuất hiện trong file đính kèm luồng bên dưới phần mô tả, mỗi thuộc tính nằm trên một dòng. Khóa phải là chuỗi và giá trị có thể là chuỗi hoặc đối tượng JSON có các khóa `text` và `href`.
`actions`	Mảng JSON chứa một đối tượng mô tả liên kết hành động sẽ xuất hiện bên cạnh liên kết "Bình luận" và "Thích" phía dưới bài viết. Đối tượng phụ thuộc phải có các khóa `name` và `link`.
`picture`	URL của ảnh được đính kèm vào bài viết này. Ảnh phải có kích thước tối thiểu là 200 pixel x 200 pixel. Hãy xem tài liệu của chúng tôi về cách chia sẻ tốt nhất để biết thêm thông tin về kích thước hình ảnh.
`name`	Tên của file đính kèm liên kết.
`caption`	Chú thích của liên kết (xuất hiện bên dưới tên liên kết). Nếu không được chỉ định, trường này sẽ tự động điền URL của liên kết.
`description`	Mô tả của liên kết (xuất hiện bên dưới chú thích liên kết). Nếu không được chỉ định, trường này sẽ tự động điền thông tin thu thập được từ liên kết, thường là tiêu đề trang.
`thumbnail`	File hình ảnh cục bộ đã tải lên,`.jpg.jpeg.gif` hoặc `.png`.