Facebook Pages API

Mengelola Halaman

Dokumen ini menunjukkan kepada Anda cara melakukan tugas-tugas berikut untuk Halaman Facebook:

  • Dapatkan daftar halaman tempat Anda dapat melakukan tugas termasuk:
    • Tugas spesifik yang dapat Anda lakukan di setiap Halaman
    • Token akses Halaman untuk setiap Halaman yang dapat Anda gunakan untuk menguji panggilan API
  • Mendapatkan dan memperbarui detail tentang Halaman
  • Mendapatkan dan memperbarui pengaturan untuk Halaman
  • Mendapatkan notifikasi tentang perubahan yang disarankan yang akan diterapkan oleh Meta di Halaman
    • Menerima atau menolak perubahan yang disarankan ini
  • Mendapatkan ulasan untuk Halaman
  • Memblokir seseorang dari Halaman

Sebelum memulai

Panduan ini berasumsi Anda telah membaca Ringkasan Pages API .

Untuk orang yang dapat melakukan tugas di halaman, Anda harus menerapkan Facebook Login untuk meminta izin berikut dan menerima token akses Pengguna atau Halaman:

  • pages_manage_engagement
  • pages_manage_metadata
  • pages_manage_posts
  • pages_read_engagement
  • pages_read_user_engagement
  • pages_show_list
  • Izin publish_video, jika Anda menerbitkan video ke Halaman

Jika menggunakan pengguna sistem bisnis dalam permintaan API Anda, izin business_management diperlukan.

Pengguna aplikasi Anda harus dapat melakukan tugas CREATE_CONTENT, MANAGE, dan/atau MODERATE pada Halaman dalam permintaan API.

Praktik terbaik

Saat menguji panggilan API, Anda dapat menyertakan parameter access_token ke token akses Anda. Namun, saat melakukan panggilan aman dari aplikasi Anda, gunakan kelas token akses.

Contoh permintaan diformat agar mudah dibaca. Ganti nilai yang dicetak tebal, dicetak miring, seperti page_id, dengan nilai Anda.

Halaman, tugas, dan token

Panggilan API tunggal dapat memberi Anda banyak informasi untuk Halaman tempat Anda dapat melakukan tugas.

Mendapatkan Halaman Anda

Untuk mendapatkan daftar semua Halaman tempat Anda dapat melakukan tugas, tugas yang dapat Anda lakukan di setiap halaman, dan token akses Halaman berdurasi singkat untuk setiap Halaman, kirim permintaan GET ke endpoint /user_id/accounts menggunakan token akses Pengguna.

Contoh permintaan

curl -i -X GET 
     "https://graph.facebook.com/user_id/accounts"

Setelah berhasil, aplikasi Anda akan menerima tanggapan JSON dengan array objek Halaman. Setiap objek Halaman berisi:

  • Nama Halaman
  • ID Halaman
  • Kategori, nama kategori dan ID Halaman
  • Token akses Halaman berdurasi singkat
  • Semua tugas yang dapat dilakukan pengguna di Halaman

Contoh tanggapan

{
  "data": [
    {
      "access_token": "{facebook-for-developers-page-access-token}",
      "category": "Internet Company",
      "category_list": [
        {
          "id": "2256",
          "name": "Internet Company"
        }
      ],
      "name": "Facebook for Developers",
      "id": "{facebook-for-developers-page-id}",
      "tasks": [
        "ANALYZE",
        "ADVERTISE",
        "MODERATE",
        "CREATE_CONTENT"
      ]
    },
    {
      "access_token": "{my-outlandish-stories-page-access-token}",
      "category": "Blogger",
      "category_list": [
        {
          "id": "361282040719868",
          "name": "Blogger"
        }
      ],
      "name": "My Outlandish Stories",
      "id": "{my-outlandish-stories-page-id}",
      "tasks": [
        "ANALYZE",
        "ADVERTISE",
        "MODERATE",
        "CREATE_CONTENT",
        "MANAGE"
      ]
    },
...
  ]
}

Mendapatkan tugas untuk orang lain

Jika Anda dapat melakukan tugas MANAGE di Halaman, Anda bisa mendapatkan daftar orang lain yang dapat melakukan tugas di Halaman tersebut, termasuk tugas yang dapat dilakukan setiap orang.

Untuk mendapatkan daftar orang dan tugas yang dapat mereka lakukan di Halaman, kirim permintaan GET ke endpoint /page_id/roles.

Contoh permintaan

curl -i -X GET "https://graph.facebook.com/page_id/roles"

Setelah berhasil, aplikasi Anda menerima tanggapan JSON dengan nama orang tersebut, ID lingkup Halaman, dan tugas yang dapat dilakukan setiap orang di Halaman.

Contoh tanggapan

{
  "data": [
    {
      "name": "Person One",
      "id": "page_scoped_id_for_one"
        "tasks": [
          "ANALYZE"
        ]
    },
    {
      "name": "Person Two",
      "id": "page_scoped_id_for_two",
      "tasks": [
        "ANALYZE",
        "ADVERTISE",
        "MODERATE",
        "CREATE_CONTENT",
        "MANAGE"
      ]
    },
...
  ],
}

Detail halaman

Jika Anda dapat melakukan tugas MANAGE di Halaman, Anda dapat menggunakan token akses Halaman atau jika aplikasi Anda telah disetujui untuk fitur Akses Konten Publik Halaman, Anda dapat menggunakan token akses Pengguna, untuk melihat detail Halaman seperti tentang, email, jam buka, dll.

Mendapatkan detail

Untuk mendapatkan detail tentang Halaman, kirim permintaan GET ke endpoint /page_id dengan parameter fields diatur ke detail Halaman yang ingin Anda lihat.

Catatan: Anda dapat menggunakan endpoint /pages/search untuk menemukan ID Halaman saat menggunakan fitur Akses Konten Publik Halaman.

Contoh permintaan

curl -i -X GET "https://graph.facebook.com/page_id \
     ?fields=about,attire,bio,location,parking,hours,emails,website"

Setelah berhasil, aplikasi Anda menerima tanggapan JSON dengan nilai kolom yang Anda minta. Ingat, jika kolom tidak diberikan dalam tanggapan, Halaman belum menetapkan nilai ini. Contoh: jika Halaman belum mengatur kolom attire, kolom ini tidak akan dikembalikan dalam tanggapan.

Memperbarui detail

Jika Anda dapat melakukan tugas MANAGE di Halaman, Anda dapat menggunakan token akses Halaman untuk mengirim permintaan POST ke endpoint /page_id dengan parameter yang ingin Anda perbarui, seperti parameter about.

Contoh permintaan

curl -i -X POST "https://graph.facebook.com/v21.0/page_id" \
     -H "Content-Type: application/json" \
     -d '{
           "about":"This is an awesome cafe located downtown!",
         }'

Setelah berhasil, aplikasi Anda akan menerima tanggapan JSON dengan success diatur ke true.

Perubahan yang diusulkan oleh Meta

Terkadang, Meta akan mengusulkan perubahan pada detail Halaman Anda, seperti memperbaiki kesalahan tulis, atau memperbarui kategori di Halaman Anda untuk membantu orang menemukan Halaman Anda dengan lebih baik. Untuk mendapatkan notifikasi ini, Anda harus berlangganan Webhooks page_upcoming_change dan/atau page_change_proposal.

Setelah Anda menerima notifikasi, lakukan salah satu hal berikut:

  • Jika tidak melakukan apa pun, perubahan akan diterapkan pada waktu yang telah ditentukan dalam notifikasi
  • Terima perubahan secara aktif, mala perubahan akan segera diterapkan
  • Tolak perubahan secara aktif, dan tidak ada perubahan yang dilakukan

Menerima atau menolak perubahan yang diusulkan

Untuk secara aktif menerima atau menolak perubahan yang diusulkan, kirim permintaan POST ke endpoint /page_change_proposal_id dengan kolom accept diatur ke true untuk menerima perubahan atau diatur ke false untuk menolak perubahan. page_change_proposal_id adalah nilai proposal.id yang Anda terima di notifikasi Webhooks page_upcoming_change atau nilai value.id yang Anda terima di notifikasi Webhooks page_change_proposal.

curl -i -X POST "https://graph.facebook.com/v21.0/page_change_proposal_id" \
     -H "Content-Type: application/json" \
     -d '{
           "accept":"true",
         }'

Setelah berhasil, aplikasi Anda akan menerima tanggapan JSON dengan success diatur ke true.

Pengaturan halaman

Jika Anda dapat melakukan tugas MANAGE di Halaman, Anda dapat menggunakan token akses Halaman untuk mengirim permintaan GET ke endpoint /page_id/settings untuk mendapatkan daftar semua pengaturan untuk Halaman tersebut.

Contoh permintaan

curl -i -X GET "https://graph.facebook.com/v21.0/page_id/settings"

Setelah berhasil, aplikasi Anda akan menerima tanggapan JSON dengan array objek, dan setiap objek adalah setting yang diatur ke pengaturan Halaman dan nilainya: true atau false.

Contoh tanggapan

{
  "data": [
    {
      "setting": "USERS_CAN_POST",
      "value": false
    },
    {
      "setting": "USERS_CAN_MESSAGE",
      "value": true
    },
    {
      "setting": "USERS_CAN_POST_PHOTOS",
      "value": true
    },
    ...
  ]
}

Memperbarui pengaturan

Untuk memperbarui pengaturan Halaman, kirim permintaan POST ke endpoint /page_id/settings dengan parameter option diatur ke pengaturan yang ingin diperbarui.

Contoh permintaan

curl -i -X POST "https://graph.facebook.com/v21.0/page_id/settings" \
     -H "Content-Type: application/json" \
     -d '{
           "option":{"USERS_CAN_MESSAGE": "true"},
         }'

Setelah berhasil, aplikasi Anda akan menerima tanggapan JSON dengan success diatur ke true.

Mendapatkan ulasan

Anda bisa mendapatkan ulasan untuk Halaman, termasuk nama peninjau, ID lingkup Halaman, apakah itu rekomendasi positif atau negatif, dan teks ulasan, kirim permintaan GET ke endpoint /page_id/ratings.

Contoh permintaan

curl -i -X GET "https://graph.facebook.com/page_id/ratings"

Setelah berhasil, aplikasi Anda menerima array JSON dengan objek ulasan. Setiap objek berisi:

  • created_time diatur ke waktu ulasan dibuat,
  • recommendation_type diatur ke positive atau negative
  • review_text diatur ke konten ulasan
  • objek reviewer dengan name dan id untuk orang yang menulis ulasan itu
{
  "data": [
    {
      "created_time": "unixtimestamp",
      "recommendation_type": "positive",
      "review_text": "I love this page!",
      "reviewer": {
        "name": "Person One",
        "id": "psid_for_one"
      }
    },
    {
      "created_time": "unixtimestamp",
      "recommendation_type": "positive",
      "review_text": "This page is wonderful!",
      "reviewer": {
        "name": "Person Two",
        "id": "psid_for_two"
      }
    },
...
  ]
}

Memblokir seseorang

Untuk memblokir seseorang agar tidak berkomentar di Halaman, kirim permintaan POST ke endpoint /page_id/blocked dengan parameter user yang diatur ke ID lingkup Halaman untuk orang yang ingin diblokir.

Contoh permintaan

curl -i -X POST "https://graph.facebook.com/v21.0/page_id/blocked"
     -H "Content-Type: application/json" \
     -d '{
           "user":"psid_to_block",
         }'

Setelah berhasil, aplikasi Anda menerima tanggapan JSON dengan ID lingkup Halaman diatur ke true.

{
 "psid_to_block": true
}

Langkah berikutnya

Pelajari cara untuk menerbitkan tautan, foto, dan video ke Halaman Anda.

Lihat juga

Referensi