Ringkasan

Pages API adalah set endpoint Graph API Facebook yang dapat digunakan aplikasi untuk membuat dan mengelola pengaturan dan konten Halaman.

Komponen

Token Akses

API autentikasi ditangani melalui Token Akses. Sebagian besar endpoint memerlukan token akses Halaman, yang unik untuk setiap Halaman, Pengguna aplikasi, dan aplikasi, dan memiliki waktu kedaluwarsa. Untuk mendapatkan token dari Pengguna aplikasi, Pengguna aplikasi harus memiliki atau dapat melakukan Tugas di Halaman.

Anda bisa mendapatkan token akses dari Pengguna aplikasi Anda dengan menerapkan Facebook Login.

Untuk Halaman yang telah dimigrasi ke Pengalaman Halaman Baru, token akses Halaman sekarang diperlukan untuk semua endpoint yang tersedia dengan pengecualian berikut:

Graph API

Jika Anda tidak terbiasa dengan Graph API, silakan baca dokumentasi Graph API kami sebelum melanjutkan untuk mempelajari selengkapnya tentang grafik sosial Meta.

Facebook Login

Facebook Login memungkinkan pengguna aplikasi untuk login ke aplikasi Anda dan untuk aplikasi Anda meminta izin mengakses data kepada pengguna Anda.

Facebook Login for Bisnis

Facebook Login for Business adalah solusi autentikasi dan validasi yang lebih disukai untuk Penyedia Layanan Teknologi dan developer aplikasi bisnis yang membutuhkan akses ke aset klien bisnis mereka

Fitur

Beberapa endpoint memerlukan Fitur yang harus disetujui melalui proses Tinjauan Aplikasi sebelum aplikasi Anda dapat menggunakannya saat aplikasi dialihkan ke mode live. Fitur memungkinkan Anda untuk mengakses data Halaman publik tanpa izin atau kemampuan untuk melakukan tugas di Halaman. Lihat referensi masing-masing endpoint untuk menentukan Fitur Halaman mana yang diperlukan.

Penyebutan

@Penyebutan memungkinkan Halaman Anda untuk membalas secara publik kepada orang tertentu, yang telah memposting di Halaman Anda atau mengomentari postingan Halaman Anda, dalam komentar atau balasan.

ID Pengguna Lingkup Halaman

Pengguna yang berinteraksi dengan Halaman diidentifikasi oleh ID Pengguna Lingkup Halaman (PSID). PSID adalah ID unik untuk setiap pasangan Pengguna-Halaman. Endpoint Pages API dan Platform Messenger mengandalkan PSID, jadi Anda dapat menggunakan PSID untuk mengidentifikasi interaksi Pengguna dengan Halaman, serta percakapan Messenger publik Pengguna dengan Halaman tersebut.

Izin

Sebagian besar endpoint memerlukan satu atau beberapa izin yang harus diberikan oleh aplikasi atau pengguna aplikasi Anda. Biasanya ini bisa dilakukan melalui Facebook Login, tetapi juga dapat dilakukan melalui Pengelola Bisnis, jika aplikasi Anda telah diklaim oleh Bisnis.

Semua izin memerlukan Tinjauan Aplikasi sebelum pengguna aplikasi dapat memberikannya ke aplikasi Anda setelah aplikasi beralih ke mode live. Untuk aplikasi Bisnis yang tidak memiliki mode aplikasi, izinnya harus disetujui untuk akses Lanjutan sebelum izin dapat diberikan ke aplikasi Anda oleh pengguna aplikasi tanpa peran di aplikasi itu sendiri atau peran dalam Bisnis yang telah mengeklaimnya.

Pencarian Halaman

Temukan informasi tentang Halaman Facebook termasuk nama, lokasi, dan temukan Halaman ke @Menyebutkan, lokasi Halaman, dan menandai Halaman untuk menampilkan konten bermerek.

Batas Laju

Semua permintaan endpoint Halaman tunduk pada Batas Laju. Konsumsi jumlah panggilan aplikasi Anda saat ini dapat dilihat di Dasbor Aplikasi.

Tugas

Tugas memungkinkan Pengguna melakukan tindakan tertentu di Halaman. Saat Pengguna menggunakan aplikasi untuk berinteraksi dengan Halaman, tergantung tindakan yang dicoba, pertama-tama kami akan memeriksa apakah Pengguna sudah disetujui untuk tugas yang memperbolehkan jenis tindakan tersebut.

Anda dapat menyetujui pengguna individual untuk tugas berikut:

Tugas	Tindakan yang Diizinkan
`ADVERTISE`	Membuat iklan Membuat Postingan Halaman yang tidak diterbitkan Membuat iklan jika akun Instagram terhubung ke Halaman
`ANALYZE`	Melihat Insight Halaman Melihat siapa admin Halaman yang menerbitkan postingan atau komentar
`CREATE_CONTENT`	Menerbitkan konten sebagai Halaman di Halaman tersebut
`MANAGE`	Menetapkan dan mengelola tugas Halaman
`MANAGE_LEADS`	Melihat dan mengelola prospek
`MESSAGING`	Mengirim pesan sebagai Halaman
`MODERATE`	Menanggapi komentar di postingan Halaman sebagai Halaman tersebut Menghapus komentar di postingan Halaman Jika akun Instagram terhubung ke Halaman, menerbitkan konten dari Facebook ke Instagram, membalas dan menghapus komentar, mengirim pesan langsung, menyinkronkan info kontak bisnis, dan membuat iklan.
`VIEW_MONETIZATION_INSIGHTS`	Melihat insight monetisasi

Jika seseorang diberi akses Admin ke Halaman di UI, orang tersebut dapat melakukan semua tugas di Halaman tersebut.

Platform Messenger

Lakukan percakapan Messenger dengan pelanggan Anda atau orang-orang yang tertarik dengan Halaman Anda.

Webhooks Meta untuk Halaman

Dapatkan notifikasi realtime saat pengguna berkomentar di postingan Halaman atau menanggapi postingan Halaman Anda.

Tinjauan Aplikasi

Semua Izin dan Fitur terkait Halaman memerlukan persetujuan melalui proses Tinjauan Aplikasi sebelum aplikasi Anda dapat menggunakannya saat aplikasi dialihkan ke mode live.

Aplikasi dalam Mode Pengembangan dapat meminta Izin apa pun dari Pengguna aplikasi apa pun yang memiliki Peran di aplikasi.

Cara Kerjanya

Ini adalah alur khas untuk mengakses Pages API:

Dapatkan Token Akses Pengguna dari Pengguna aplikasi melalui Facebook Login.
Kueri endpoint /me/accounts untuk mendapatkan ID dan Token Akses Halaman dari Halaman yang izin aksesnya telah Pengguna aplikasi berikan kepada aplikasi Anda.
Ambil gambar ID Halaman dan Token Akses Halaman yang diberikan.
Gunakan ID dan token untuk melakukan kueri node Halaman.

Perhatikan bahwa dalam beberapa kasus, Pengguna aplikasi dapat memberi aplikasi Anda akses ke lebih dari satu Halaman, dalam hal ini Anda harus mengambil gambar setiap ID Halaman dan token masing-masing, serta menyediakan cara bagi Pengguna aplikasi untuk menarget masing-masing Halaman tersebut.

Langkah Berikutnya

Ikuti Panduan Memulai kami untuk mempelajari cara menerbitkan postingan Halaman menggunakan Pages API.