Facebook Pages API

Postingan

Panduan ini menjelaskan cara membuat, menerbitkan, dan memperbarui postingan, dan membalas postingan di Halaman Facebook Anda sebagai Halaman, dan menghapus postingan menggunakan Pages API dari Meta.

Sebelum Anda memulai

This guide assumes you have read the Overview

For a person who can perform tasks on the page, you will need to implement Facebook Login to ask for the following permissions and receive a Page access token:

  • pages_manage_engagement
  • pages_manage_posts
  • pages_read_engagement
  • pages_read_user_engagement
  • publish_video permission, if you are publishing a video to the Page

Your app user must be able to perform the CREATE_CONTENT, MANAGE, and MODERATE tasks on the Page in the API requests.

If your app users do not own or manage the Page in the API requests, your app will need a User access token and the following features:

  • Page Public Content Access

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.

Menerbitkan postingan

Untuk menerbitkan postingan ke Halaman, kirim permintaan POST ke endpoint /page_id/feed, dengan page_id adalah ID Halaman Anda, dengan parameter berikut:

  • message diatur ke teks postingan Anda
  • link diatur ke URL Anda jika Anda ingin memposting tautan
  • published diatur ke true untuk langsung menerbitkan postingan (default) atau false untuk menerbitkan nanti
    • Sertakan scheduled_publish_time jika diatur ke false dengan tanggal dalam salah satu format berikut:
      • Cap waktu UNIX bilangan bulat [dalam detik] (misalnya 1530432000)
      • String cap waktu ISO 8061 (misalnya 2018-09-01T10:15:30+01:00)
      • String apa pun yang dapat di-parse oleh strtotime() PHP (misalnya: +2 weeks, tomorrow)

Catatan tentang postingan terjadwal

  • Tanggal terbit harus antara 10 menit dan 30 hari dari waktu permintaan API.
  • Jika Anda mengandalkan string tanggal relatif strtotime(), Anda dapat read-after-write (RAW)scheduled_publish_time dari postingan yang dibuat untuk memastikan itu sesuai yang diharapkan.

Contoh Permintaan

Diformat agar mudah dibaca. Ganti nilai yang dicetak tebal dan miring, seperti page_id, dengan nilai Anda.
curl -X POST "https://graph.facebook.com/v20.0/page_id/feed" \
     -H "Content-Type: application/json" \
     -d '{
           "message":"your_message_text",
           "link":"your_url",
           "published":"false",
           "scheduled_publish_time":"unix_time_stamp_of_a_future_date",
         }'

Setelah berhasil, aplikasi Anda akan menerima tanggapan JSON berikut dengan ID postingan:

{
  "id": "page_post_id" 
}

Menambahkan penargetan pemirsa

Untuk membatasi siapa yang dapat melihat postingan Halaman, Anda dapat menambahkan objek targeting.geo_locations atau parameter feed_targeting.geo_locations dalam permintaan POST Anda.

-d '{
      ...
      "targeting": {
        "geo_locations": {
          "countries": [
            "CA"
          ],
          "cities": [
            {
              "key": "296875",
              "name": "Toronto"
            }
          ]
        }
      },
      ...
    }'

Pemecahan Masalah

Dalam beberapa kasus, menggunakan negara maupun wilayah dalam negara itu akan menyebabkan kesalahan: "Sebagian lokasi Anda tumpang tindih. Coba hapus salah satu lokasi." Dalam kasus tersebut, target wilayah atau negara sesuai cakupan yang Anda inginkan.

Menerbitkan Postingan Media

Anda dapat menerbitkan foto dan video ke Halaman.

Menerbitkan foto

Untuk menerbitkan foto ke Halaman, kirim permintaan POST ke endpoint /page_id/photos, dengan page_id adalah ID Halaman Anda, dengan parameter url diatur ke foto untuk postingan Anda.

Contoh Permintaan

Diformat agar mudah dibaca. Ganti nilai yang dicetak tebal dan miring, seperti page_id, dengan nilai Anda.
curl -X POST "https://graph.facebook.com/v20.0/page_id/photos" \
     -H "Content-Type: application/json" \
     -d '{
           "url":"path_to_photo",

Setelah berhasil, aplikasi Anda akan menerima tanggapan JSON berikut dengan ID foto dan ID postingan:

{
  "id":"photo_id",
  "post_id":"page_post_id" 
}

Menerbitkan video

Silakan kunjungi Dokumentasi Video API untuk menerbitkan postingan video ke Halaman Anda.

Mendapatkan Postingan

Untuk mendapatkan daftar postingan Halaman, kirim permintaan GET ke endpoint /page_id/feed.

Contoh Permintaan

Diformat agar mudah dibaca. Ganti nilai yang dicetak tebal dan miring, seperti page_id, dengan nilai Anda.
curl -i -X GET "https://graph.facebook.com/v20.0/page_id/feed"

Jika berhasil, aplikasi Anda menerima tanggapan JSON berikut dengan array objek yang mencakup ID postingan, waktu postingan dibuat, dan konten postingan, untuk setiap postingan di Halaman Anda:

{
  "data": [
    {
      "created_time": "2019-01-02T18:31:28+0000",
      "message": "This is my test post on my Page.",
      "id": "page_post_id"
    }
  ],
...
}

Batasan

  • Video Siaran Langsung - Jika sebuah postingan Halaman berisi video yang telah kedaluwarsa, seperti siaran langsung, Anda bisa mendapatkan beberapa kolom postingan tetapi bukan kolom yang terkait dengan video itu. Video memiliki aturan privasinya sendiri. Jika video telah kedaluwarsa, Anda harus merupakan admin halaman untuk melihat informasinya.
  • CTA Pesan - Token akses apa pun dapat digunakan untuk meminta postingan Halaman yang dibagikan secara publik selama aplikasi Anda telah disetujui untuk Fitur Akses Konten Publik Halaman. Namun, postingan dengan CTA pesan tidak dapat diakses menggunakan token akses Halaman lain karena halaman tidak dapat mengirim pesan ke halaman lain.

URL Postingan Halaman

URL, atau permalink, untuk postingan Halaman adalah https://www.facebook.com/page_post_id.

Memperbarui Postingan

Untuk memperbarui postingan Halaman, kirim permintaan POST ke endpoint /page_post_id dengan parameter yang ingin Anda perbarui diatur ke konten baru.

Contoh Permintaan

Diformat agar mudah dibaca. Ganti nilai yang dicetak tebal, dicetak miring, seperti page_post_id, dengan nilai Anda.
curl -X POST "https://graph.facebook.com/v20.0/page_post_id" \
     -H "Content-Type: application/json" \
     -d '{
           "message":"I am updating my Page post",
         }'

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

{
  "success": true
}

Batasan

Aplikasi hanya dapat memperbarui postingan Halaman jika postingan dibuat menggunakan aplikasi itu.

Menghapus Postingan

Untuk menghapus postingan Halaman, kirim permintaan DELETE ke endpoint /page_post_id dengan page_post_id adalah ID postingan yang ingin dihapus.

Contoh Permintaan

Diformat agar mudah dibaca. Ganti nilai yang dicetak tebal dan miring, seperti page_post_id, dengan nilai Anda.
curl -i -X DELETE "https://graph.facebook.com/v20.0/page_post_id"

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

{
  "success": true
}

Langkah Berikutnya

Pelajari cara mengomentari postingan Halaman dan @menyebutkan orang atau Halaman tertentu yang memposting atau mengomentari Halaman Anda.

Lihat Juga

Panduan Video API

Referensi