Berbagi

Berbagi untuk Perangkat

Endpoint ini dihentikan 2 November 2020.

Dengan Berbagi untuk Perangkat, orang dapat dengan mudah membagikan konten dari perangkat ke Facebook. Ini termasuk Smart TV, bingkai foto digital, atau perangkat Internet of Things.

Dengan berbagi perangkat, perangkat Anda menampilkan kode alfanumerik dan meminta orang memasukkannya di halaman web di PC desktop atau smartphone-nya. Orang-orang yang menggunakan aplikasi atau layanan Anda kemudian dapat membagikan konten ke Facebook dengan dialog bagikan yang terhubung dengan kode tersebut.

Jika Anda membuat aplikasi untuk Apple TV atau perangkat Android, Anda harus menggunakan SDK untuk tvOS atau SDK untuk Android, yang sesuai.

Panduan ini menjelaskan berikut ini:

Pengalaman Pengguna

1. Ajakan Bertindak

Pertama, pertimbangkan di mana dalam pengalaman pengguna, Anda ingin meminta orang untuk berbagi konten ke Facebook. Untuk memastikan pengalaman terbaik, rancang tombol agar terlihat semirip mungkin dengan tombol Bagikan dari Facebook resmi. Secara umum, tombol tersebut harus berada di sebelah konten yang akan dibagikan.

Dari perspektif desain visual, ini artinya Anda harus

  1. Melabeli tombol dengan "Bagikan" atau "Bagikan ke Facebook".
  2. Menggunakan warna putih dan warna biru logo Facebook yang resmi: #3B5998.
  3. Jika perangkat Anda mendukung tampilan grafis, Anda juga dapat menggabungkan logo resmi “f”. Sesuai dengan pedoman merek Facebook, logo harus selalu berwarna putih atau biru Facebook (#3B5998).

2. Menampilkan Kode

Saat seseorang mengeklik ajakan bertindak, perangkat Anda membuat panggilan ke API Facebook yang mengembalikan kode.

Di antarmuka Anda, beri tahu orang-orang bahwa mereka harus mengunjungi situs web dan memasukkan kode dengan pesan berikut, “Selanjutnya, kunjungi facebook.com/device (http://facebook.com/device) di desktop atau smartphone Anda dan masukkan kode ini”. Tampilkan kode lengkap yang Anda terima dari API Berbagi Perangkat dari Facebook. Kode ini berisi 6 hingga 12 karakter.

Sertakan tombol Close atau Done agar orang-orang dapat menyelesaikan alur Berbagi Perangkat.

3. Membagikan

Inilah alur yang dilihat orang-orang saat mereka membuka facebook.com/device di browser desktop atau seluler. Pertama, mereka melihat kolom teks untuk memasukkan kode:

Setelah memasukkan kode dan mengeklik Continue, mereka akan diberikan Dialog Bagikan:

Agar mengetahui bahwa proses berbaginya berhasil, orang akan melihat pesan konfirmasi:

Menerapkan Berbagi untuk Perangkat

Facebook Berbagi untuk Perangkat adalah untuk perangkat yang dapat melakukan panggilan HTTP melalui internet. Berikut ini adalah panggilan API dan tanggapan yang dapat dilakukan perangkat Anda.

1. Mengaktifkan Login untuk Perangkat

Muat dasbor aplikasi Anda dan ubah Pengaturan > Lanjutan > Pengaturan Oauth > Login dari Perangkat menjadi 'Ya'.

2. Membuat Kode

Saat seseorang mengeklik ajakan bertindak Share, perangkat Anda harus membuat HTTP POST ke:

POST https://graph.facebook.com/device/share
       access_token=<APPID|CLIENT_TOKEN>
       href=<LINK_TO_SHARE>

CLIENT_TOKEN berada di Pengaturan Aplikasi Anda -> Lanjutan, dan harus dipadukan dengan ID aplikasi Anda (dipisahkan dengan tanda pipa, |) untuk membentuk access_token yang lengkap.

API juga mendukung parameter action_type dan action_properties sebagai ganti href jika Anda ingin membagikan cerita Graf Terbuka (dengan cara yang sama seperti tindakan Graf Terbuka dalam Dialog Bagikan).

API juga mendukung parameter quote dan hashtag (dengan cara yang sama seperti parameter Dialog Bagikan).

Tanggapannya dalam bentuk berikut:

{
  "user_code": "A1NWZ9",
  "verification_uri": "https://www.facebook.com/device",
  "expires_in": 420,
}

Tanggapan ini berarti:

  1. Tampilkan string “A1NWZ9” di perangkat Anda.
  2. Minta orang tersebut membuka “facebook.com/device” dan memasukkan kode ini.
  3. Kode akan kedaluwarsa dalam 420 detik. Tutuplah tampilan kode setelah waktu yang ditentukan.

3. Menampilkan Kode

Perangkat Anda akan menampilkan user_code dan meminta orang mengunjungi verification_uri seperti facebook.com/device di PC atau smartphone-nya. Lihat Pengalaman Pengguna.

Pemecahan Masalah

Dapatkah saya membuat permintaan alur perangkat melalui HTTP?
Graph API dengan token memerlukan TLS/HTTPS.

Dapatkah saya membuat permintaan alur perangkat dengan metode GET?
Semua permintaan alur perangkat harus berupa permintaan POST.

Bisakah saya mengetahui jika orang tersebut telah selesai berbagi?
Tidak.

Bisakah saya memposting atas nama orang tersebut secara terprogram?
Tidak. Untuk melakukannya, Anda harus meminta pengguna untuk login dan memberikan izin kepada Anda untuk menerbitkan atas nama mereka. Lihat menerbitkan dengan Graph API untuk mempelajari selengkapnya.