Dialog Beranda

Anda dapat menambahkan Dialog Beranda ke aplikasi Anda sehingga orang-orang dapat menerbitkan cerita individu dengan komentar ke linimasa mereka.

Membagikan cerita melalui dialog bagikan tidak perlu meminta izin tambahan apa pun.

Integrasi

Dialog ini dapat digunakan dengan Facebook SDK for JavaScript, Facebook SDK untuk iOS, Facebook SDK untuk Android dengan melakukan pengalihan sepenuhnya ke URL. Berikut adalah beberapa contoh snippet kode yang dapat digunakan untuk memicu dialog ini.

JavaScript

Untuk memicu Dialog Beranda, panggil FB.ui dan gunakan nilai feed untuk parameter method.

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

iOS

Baca panduan Dialog Bagikan di iOS kami yang juga mengizinkan Anda menerbitkan cerita Graf Terbuka.

Android

Baca tentang Dialog Bagikan di Android yang juga mengizinkan Anda untuk menerbitkan cerita Graf Terbuka.

Pengalihan 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

Catatan

Jika pengaturan "Siapa yang dapat memposting di linimasa Anda?" diatur ke "Hanya saya" dan orang lain mencoba memposting ke linimasa orang tersebut menggunakan dialog Beranda, kesalahan "Tidak dapat memposting" akan ditampilkan.

Parameter

Catatan: Jika aplikasi Anda membagikan tautan ke iTunes atau Google Play Store, atau ke profil atau halaman Facebook, kami tidak memposting gambar atau deskripsi apa pun yang Anda tentukan dalam berbagi dengan parameter di bawah ini. Sebagai gantinya, kami memposting beberapa informasi aplikasi yang kami scraping dari toko aplikasi atau halaman Facebook langsung dengan Webcrawler. Informasi ini mungkin tidak termasuk gambar. Untuk mempratinjau berbagi tautan ke iTunes atau Google Play, masukkan URL Anda ke dalam Sharing Debugger.

Parameter Deskripsi

app_id

Pengidentifikasi unik aplikasi Anda. Wajib.

redirect_uri

URL untuk mengalihkan setelah pengirim mengeklik tombol di dialog. Diperlukan saat menggunakan pengalihan URL.

display

Menentukan cara dialog di-render.

  • Jika Anda menggunakan penerapan dialog pengalihan URL, maka ini akan berupa tampilan halaman penuh, yang diperlihatkan di dalam Facebook.com. Jenis tampilan ini disebut page.
  • Jika Anda menggunakan Facebook untuk iOS atau Facebook SDK untuk Android untuk menjalankan dialog, ini secara otomatis ditentukan dan memilih jenis tampilan yang sesuai untuk perangkat.
  • Jika Anda menggunakan Facebook SDK for JavaScript, default-nya adalah jenis iframe modal untuk orang-orang yang masuk ke aplikasi Anda atau async saat menggunakan dalam game di Facebook.com, dan jendela popup untuk orang-orang lainnya. Anda juga dapat menerapkan jenis popup atau page saat Anda menggunakan Facebook SDK for JavaScript, jika diperlukan.
  • Default aplikasi web seluler akan selalu jenis tampilan touch.

from

ID orang yang memposting pesan. Jika ini tidak ditentukan, default-nya adalah orang saat ini. Jika ditentukan, itu harus ID orang atau halaman yang dikelola orang tersebut.

to

ID profil tempat cerita ini akan diterbitkan. Jika ini tidak ditentukan, default-nya adalah nilai from. ID haruslah teman yang juga menggunakan aplikasi Anda.

link

Tautan yang dilampirkan ke postingan ini.

source

URL file media (baik SWF atau MP3) yang dilampirkan pada postingan ini. Jika SWF, Anda juga harus menentukan picture untuk memberikan gambar mini video.

ref

Argumen ini adalah daftar yang dipisahkan koma, terdiri dari paling banyak 5 item berbeda, masing-masing panjangnya setidaknya 1 dan paling banyak 15 karakter yang diambil dari set '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz_'. Setiap kategori yang digunakan di Facebook Insights untuk membantu Anda mengukur kinerja berbagai jenis postingan

Parameter yang Tidak Berlaku Lagi

Parameter Deskripsi

post_id

ID cerita yang diposting, jika orang tersebut memilih untuk menerbitkan ke linimasanya.

properties

Objek JSON dari pasangan kunci/nilai yang akan muncul di lampiran aliran di bawah deskripsi, dengan setiap properti pada barisnya sendiri. Kunci harus berupa string, dan nilainya dapat berupa string atau objek JSON dengan kunci text dan href.

actions

Array JSON yang berisi satu objek yang mendeskripsikan tautan tindakan yang akan muncul di sebelah tautan "Komentar" dan "Suka" di bawah postingan. Objek yang terkandung harus memiliki kunci name dan link.

picture

URL gambar yang terlampir ke postingan ini. Ukuran gambar minimal harus 200x200 piksel. Lihat dokumentasi kami di membagikan praktik terbaik untuk informasi selengkapnya tentang ukuran.

name

Nama lampiran tautan.

caption

Keterangan tautan (muncul di bawah nama tautan). Jika tidak ditentukan, kolom ini secara otomatis diisi dengan URL tautan.

description

Deskripsi tautan (muncul di bawah keterangan tautan). Jika tidak ditentukan, kolom ini akan diisi secara otomatis dengan informasi hasil scraping dari tautan, khususnya judul halaman.

thumbnail

File gambar lokal yang diunggah, .jpg.jpeg.gif atau .png.