Berbagi

Menggunakan Objek

Topik Terkait

Facebook memungkinkan Anda memposting cerita yang kaya dan terstruktur dari aplikasi Anda menggunakan API objek dan tindakan dengan aturan tipe data yang ketat. Objek adalah "kata benda" atau sasaran bagi tindakan yang diambil orang di aplikasi Anda.

Objek ditentukan oleh markup HTML Graf Terbuka di halaman web.

Membuat Objek

Objek dibuat dengan menambahkan tanda meta Graf Terbuka ke halaman tempat konten Anda dihosting.

Ada tanda dasar wajib untuk mengubah halaman Anda menjadi objek. Tambahkan tanda itu ke <head> dari HTML halaman Anda.

<meta property="fb:app_id"          content="1234567890" /> 
<meta property="og:type"            content="article" /> 
<meta property="og:url"             content="http://newsblog.org/news/136756249803614" /> 
<meta property="og:title"           content="Introducing our New Site" /> 
<meta property="og:image"           content="https://scontent-sea1-1.xx.fbcdn.net/hphotos-xap1/t39.2178-6/851565_496755187057665_544240989_n.jpg" /> 
<meta property="og:description"    content="http://samples.ogp.me/390580850990722" />

Di beberapa platform hosting dan pengembangan yang Anda gunakan untuk membuat halaman objek dan menerbitkan objek ke Graf Terbuka secara bersamaan, Anda mungkin akan mendapatkan kesalahan yang mengatakan bahwa objek tidak ada. Hal ini disebabkan oleh race condition yang terjadi di beberapa sistem. Kami menyarankan agar Anda memverifikasi halaman objek yang dibuat sebelum Anda menerbitkan tindakan ke Graf Terbuka atau menggunakan penundaan kecil pada akun untuk lag replikasi (misalnya: 15-30 detik).


Pengujian

Anda dapat menguji markup Anda dengan meneruskan URL ke Sharing Debugger. Proses ini akan menampilkan tanda yang di-scraping oleh crawler dan juga kesalahan atau peringatan.

Memperbarui Objek

Crawler Facebook akan melakukan scraping ulang (dan memperbarui) objek:

  • Saat URL objek dimasukkan ke Sharing Debugger
  • Setiap 30 hari setelah scraping pertama
  • Saat aplikasi memicu scraping menggunakan endpoint API

Endpoint Graph API ini hanyalah panggilan ke:

POST /?id={object-instance-id or object-url}&scrape=true

Tanggapan dari endpoint ini akan berupa objek JSON yang berisi semua informasi tentang objek yang di-scraping (sama dengan data yang dihasilkan saat ID Objek dibaca dari Graph API).

Parameter id dapat berupa URL kanonis objek Anda atau ID instance objek di graf.

Anda selalu dapat mengedit properti objek dengan dua pengecualian:

  • Judul: Setelah 50 tindakan (seperti suka, dibagikan, dan komentar) dihubungkan dengan objek, Anda tidak akan dapat memperbarui judulnya
  • Jenis: Jenis objek tidak bisa diubah setelah digunakan di sebuah cerita. Lihat Jenis Graf Terbuka untuk informasi selengkapnya.

Jika Anda ingin memperbarui gambar untuk objek, kami sangat menyarankan agar URL gambar berbeda dengan URL gambar yang asli. Proses caching dapat mencegah pembaruan gambar.

Migrasi Halaman dan Mengubah URL

Untuk memindahkan sebuah halaman ke URL baru, Anda dapat menggunakan URL lama sebagai sumber kanonis untuk URL baru sehingga mempertahankan suka, komentar, dan jumlah bagikan untuk objek itu. Pelajari caranya di panduan bagikan untuk webmaster.