Berbagi untuk Perangkat

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

Dengan berbagi perangkat, perangkat Anda akan menampilkan kode alfanumerik dan memberi tahu orang untuk memasukkannya ke halaman web di PC desktop atau smartphone mereka. Selanjutnya, orang-orang yang menggunakan aplikasi atau layanan Anda akan dapat membagikan konten ke Facebook dengan dialog bagikan yang terkait dengan kode tersebut.

Jika Anda membangun aplikasi untuk perangkat Apple TV atau Android, maka Anda harus menggunakan masing-masing SDK untuk tvOS atau SDK untuk Android.

Panduan ini menjelaskan berikut ini:

Pengalaman Pengguna

1. Ajakan-Bertindak

Pertama, pertimbangkan di mana, di pengalaman pengguna Anda, yang Anda inginkan agar orang membagikan konten ke Facebook. Untuk memastikan pengalaman terbaik, buat desain tombol agar terlihat semirip mungkin dengan tombol Bagikan Facebook resmi. Pada umumnya, tombol harus berada di samping konten yang akan dibagikan.

Dari perspektif desain visual, ini artinya Anda harus

  1. Memberi label pada 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 Facebook. Kode itu sepanjang 6 hingga 12 karakter.

Termasuk tombol Close atau Done sehingga orang dapat menyelesaikan alur Berbagi Perangkat.

3. Berbagi

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

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

Sehingga orang tahu bahwa mereka berhasil membagikan, selanjutnya mereka akan melihat pesan konfirmasi:

Menerapkan Berbagi untuk Perangkat

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

1. Mengaktifkan Masuk untuk Perangkat

Muat dasbor aplikasi Anda dan ubah Pengaturan > Lanjutan > Pengaturan OAuth > Masuk dari Perangkat ke 'Ya'.

2. Membuat Kode

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

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

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

API juga mendukung action_type dan action_properties alih-alih href jika Anda ingin membagikan cerita Graf Terbuka (dengan cara yang sama dengan tindakan Graf Terbuka di Dialog Bagikan).

API juga mendukung parameter quote dan hashtag (dengan cara yang sama dengan 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. Anda harus menutup tampilan kode setelah waktu tersebut.

3. Menampilkan Kode

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

Pemecahan Masalah

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

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

Dapatkah saya memberi tahu saat seseorang sudah selesai membagikan?
Tidak.

Dapatkah saya mengirimkan atas nama seseorang secara terprogram?
Tidak. Untuk melakukannya, Anda harus meminta pengguna masuk dan memberikan izin kepada Anda untuk menerbitkan atas nama mereka. Untuk mempelajari selengkapnya, lihat cara menerbitkan dengan API Graf.