Beranda Halaman

Gunakan endpoint ini untuk mendapatkan dan mempublikasikan ke Halaman. Kabar Halaman mencakup semua interaksi dengan Halaman Facebook termasuk: postingan dan tautan yang diterbitkan oleh Halaman ini, pengunjung Halaman ini, dan postingan publik yang telah menandai Halaman tersebut.

Lihat Juga

• Endpoint /{page-post-id} memungkinkan Anda untuk memperbarui postingan Halaman tertentu.
• Endpoint /{page-id}/taggeduntuk hanya mengambil postingan publik yang menandai Halaman tersebut.

Membaca

Postingan Halaman Facebook.

Pengalaman Halaman Baru

API ini didukung untuk Pengalaman Halaman Baru.

Persyaratan

Orang yang meminta token akses harus dapat melakukan salah satu tugas berikut di Halaman:

• CREATE_CONTENT – Menerbitkan konten sebagai Halaman di Halaman tersebut
• MANAGE – Menetapkan dan mengelola tugas Halaman
• MEMODERASI

  • Menanggapi komentar di postingan Halaman sebagai Halaman tersebut
  • Menghapus komentar di postingan Halaman
  • Jika akun Instagram terhubung ke Halaman, mempublikasikan konten dari Facebook ke Instagram, membalas dan menghapus komentar, mengirim pesan Langsung, menyinkronkan info kontak bisnis, dan membuat iklan.

Dan telah memberi aplikasi izin berikut yang diperlukan:

• Izin pages_read_engagement
• Izin pages_read_user_content

Jika Anda tidak memiliki atau mengelola Halaman, Anda memerlukan:

• Fitur Akses Konten Publik Halaman

Contoh Permintaan

GET /v21.0/{page-id}/feed HTTP/1.1
Host: graph.facebook.com

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '/{page-id}/feed',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */

/* make the API call */
FB.api(
    "/{page-id}/feed",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{page-id}/feed",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{page-id}/feed"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Contoh Tanggapan JSON

{
  "data": [
    {
      "created_time": "2019-05-17T16:24:04+0000",
      "message": "Become a Facebook developer!",
      "id": "{page-id}_2191966997525824"
    },
    {
      "created_time": "2019-02-26T21:35:42+0000",
      "message": "Hello world!",
      "id": "{page-id}_2072371269485398"
    },
...
    {
      "created_time": "2018-01-26T20:57:22+0000",
      "message": "Friday Funday!",
      "id": "{page-id}_1569752556413941"
    }
  ],
  "paging": {
    "cursors": {
      "before": "Q2c4U1pXNT...",
      "after": "Q2c4U1pXNT..."
    },
    "next": "https://graph.facebook.com/vX.X/{page-id}/feed?access_token={your-page-access-token}&pretty=0&limit=25&after=Q2c4U1pXNT..."
  }
}

Batasan

• Postingan Kedaluwarsa—Jika Postingan telah kedaluwarsa, Anda tidak akan dapat lagi melihat konten menggunakan Graph API.
• Postingan Maksimum

  • API akan menampilkan sekitar 600 postingan yang dipublikasikan dan diberi peringkat setiap tahunnya.
  • Anda hanya dapat membaca maksimal sebanyak 100 postingan kabar dengan kolom limit. Jika Anda mencoba membaca lebih banyak dari jumlah tersebut, Anda akan menerima pesan kesalahan untuk tidak melampaui 100.
• CTA Pesan - Postingan dengan CTA pesan tidak dapat diakses menggunakan token akses Halaman lainnya karena Halaman tidak dapat mengirimkan pesan kepada Halaman lainnya.
• Informasi Identifikasi Publik - Informasi pengguna tidak akan diikutsertakan dalam tanggapan, kecuali jika Anda membuat permintaan dengan token akses Halaman.
• Postingan yang Diterbitkan – Postingan yang diterbitkan dan batalkan diterbitkan akan diberikan saat melakukan kueri endpoint `/{page-id}/feed`. Gunakan kolom 'is_published` untuk hanya menampilkan postingan yang diterbitkan.
• Postingan yang Dibagikan - Postingan Halaman yang membagikan postingan dari Halaman atau orang lain mungkin tidak terlihat jika postingan asli tidak terlihat dengan token akses yang digunakan.
• Postingan Berlabel - Saat Anda menggunakan /{page-id}/tagged untuk menampilkan postingan yang melabeli Halaman ini, hasilnya akan menyertakan postingan dari Halaman lain hanya jika Halaman tersebut autentik.
• Agen Pengguna - Agen pengguna yang diperbolehkan untuk panggilan Graph API ini dapat berubah sewaktu-waktu. Jika Anda mengalami masalah, Anda mungkin ingin mengubah agen pengguna khusus Anda ke versi yang lebih baru.
• Postingan Video - Untuk mendapatkan daftar postingan video, orang yang membuat permintaan harus adalah admin Halaman.
• Reels Untuk mendapatkan daftar Reels yang diterbitkan ke Halaman Anda, gunakan edge VideoReels Halaman.

Batasan: Semua postingan (diterbitkan dan batalkan diterbitkan) akan ditarik di kabar endpoint tersebut. Satu-satunya perbedaan adalah postingan yang batal diterbitkan tidak akan tercantum di kabar fisik. Namun, ada kolom is_published yang dapat ditambahkan ke endpoint /feed untuk memberi tahu developer apakah postingan yang tercantum di endpoint /feed diterbitkan atau tidak

Kolom

curl -i -X GET \
 "https://graph.facebook.com/{your-page-id}/feed
    ?fields=is_eligible_for_promotion,promotable_id
        &access_token={your-page-access-token}"

GraphRequest request = GraphRequest.newGraphPathRequest(
  accessToken,
  "/{your-page-id}/feed",
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});

Bundle parameters = new Bundle();
parameters.putString("fields", "is_eligible_for_promotion,promotable_id");
request.setParameters(parameters);
request.executeAsync();

FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/{your-page-id}/feed"
           parameters:@{ @"fields": @"is_eligible_for_promotion,promotable_id",}
           HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];

FB.api(
  '/{your-page-id}/feed',
  'GET',
  {"fields":"is_eligible_for_promotion,promotable_id"},
  function(response) {
      // Insert your code here
  }
);

try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->get(
    '/{your-page-id}/feed?fields=is_eligible_for_promotion,promotable_id',
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

{
  "data": [
    {
      "is_eligible_for_promotion": true,
      "promotable_id": "1353269864728879_1943344825721377",
      "id": "1353269864728879_1943344825721377"
    },
    {
      "is_eligible_for_promotion": true,
      "promotable_id": "1353269864728879_1943313139057879",
      "id": "1353269864728879_1943378089051384"
    },
    {
      "is_eligible_for_promotion": false,
      "promotable_id": "1353269864728879_1942095249179668",
      "id": "1353269864728879_1942095249179668"
    },
...

Penerbitan

Anda dapat menerbitkan ke Halaman menggunakan edge ini. link atau message harus disediakan.

Pengalaman Halaman Baru

API ini didukung untuk Pengalaman Halaman Baru.

Persyaratan

Jika Anda dapat melakukan tugas CREATE_CONTENT, Anda memerlukan:

• Token akses Halaman
• Izin pages_manage_posts
• Izin pages_read_engagement
• Izin pages_show_list

Postingan akan muncul di suara Halaman.

Izin

• Token akses Halaman diminta oleh seseorang yang dapat melakukan

  Tugas CREATE_CONTENT

  di Halaman yang sedang di-kueri

• Izin pages_manage_posts

Catatan: Jika pemirsa atau aplikasi tidak dapat melihat URL link, postingan akan gagal.

POST /v21.0/{page-id}/feed HTTP/1.1
Host: graph.facebook.com

message=This+is+a+test+message

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->post(
    '/{page-id}/feed',
    array (
      'message' => 'This is a test message',
    ),
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */

/* make the API call */
FB.api(
    "/{page-id}/feed",
    "POST",
    {
        "message": "This is a test message"
    },
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

Bundle params = new Bundle();
params.putString("message", "This is a test message");
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{page-id}/feed",
    params,
    HttpMethod.POST,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

NSDictionary *params = @{
  @"message": @"This is a test message",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{page-id}/feed"
                                      parameters:params
                                      HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Tanggapan

{"id":"post-id"}

Endpoint ini mendukung baca-setelah-tulis dan dapat langsung menampilkan kolom yang diberikan oleh operasi baca.

Contoh Fitur Penjelajah Graf

Pengujian dalam Fitur Penjelajah Graf dengan menggunakan POST {page-id}/feed:

Kolom

POST /v21.0/page-id/feed HTTP/1.1
Host: graph.facebook.com

message=This+is+a+test+activity&og_action_type_id=383634835006146&og_object_id=136050896551329&og_icon_id=609297155780549

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->post(
    '/page-id/feed',
    array (
      'message' => 'This is a test activity',
      'og_action_type_id' => '383634835006146',
      'og_object_id' => '136050896551329',
      'og_icon_id' => '609297155780549',
    ),
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */

/* make the API call */
FB.api(
    "/page-id/feed",
    "POST",
    {
        "message": "This is a test activity",
        "og_action_type_id": "383634835006146",
        "og_object_id": "136050896551329",
        "og_icon_id": "609297155780549"
    },
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

Bundle params = new Bundle();
params.putString("message", "This is a test activity");
params.putString("og_action_type_id", "383634835006146");
params.putString("og_object_id", "136050896551329");
params.putString("og_icon_id", "609297155780549");
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/page-id/feed",
    params,
    HttpMethod.POST,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

NSDictionary *params = @{
  @"message": @"This is a test activity",
  @"og_action_type_id": @"383634835006146",
  @"og_object_id": @"136050896551329",
  @"og_icon_id": @"609297155780549",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/page-id/feed"
                                      parameters:params
                                      HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Postingan Halaman yang Tidak Diterbitkan

Kami mendukung jenis berikut untuk Postingan Halaman yang Tidak Diterbitkan:

Postingan Halaman yang tidak diterbitkan diperlakukan sama seperti postingan Halaman yang diterbitkan, kecuali bahwa postingan tersebut tidak muncul di /feed.

Untuk melihat daftar postingan Halaman yang tidak diterbitkan, kirimkan kueri kolom is_published.

curl -i -X GET \
 "https://graph.facebook.com/{page-id}/feed
 ?fields=is_published
 &access_token={your-page-access-token}"

GraphRequest request = GraphRequest.newGraphPathRequest(
  accessToken,
  "/{page-id}/feed",
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});

Bundle parameters = new Bundle();
parameters.putString("fields", "is_published");
request.setParameters(parameters);
request.executeAsync();

FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/{page-id}/feed"
           parameters:@{ @"fields": @"is_published",}
           HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];

FB.api(
  '/{page-id}/feed',
  'GET',
  {"fields":"is_published"},
  function(response) {
      // Insert your code here
  }
);

try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->get(
    '/{page-id}/feed?fields=is_published',
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

Untuk melihat postingan di Facebook.com, Anda dapat membuka https://www.facebook.com/{post-id} untuk sebagian besar jenis postingan, atau mengambil kolom actions postingan, yang berisi URL yang memungkinkan pengguna untuk menyukai atau mengomentari postingan.

Postingan Halaman call_to_action

Anda dapat menyempurnakan postingan halaman tautan dengan tombol ajakan bertindak. Kolom call_to_action berikut dapat ditambahkan ke Postingan Halaman tautan yang baru.

Gambar Postingan Halaman Tautan Khusus

Memposting tautan ke Halaman dengan gambar tautan khusus. Lampiran cerita tersebut menampilkan gambar yang diambil dari tautan. Saat ini, Anda dapat menimpa gambar tersebut dengan memberikan parameter picture opsional dengan URL ke gambar baru. Parameter thumbnail menawarkan fungsi yang mirip. Perbedaan utamanya adalah parameter ini menerima file gambar lokal yang diunggah ke Facebook dalam panggilan API.

Izin

• Diperlukan token akses Halaman.
• Tautan harus dimiliki oleh Halaman yang memposting.

Batasan

• Parameter thumbnail hanya tersedia untuk postingan tautan pada Halaman Facebook.
• Parameter thumbnail lebih diutamakan daripada parameter picture. Jika keduanya ada, maka parameter picture tidak digunakan.
• Parameter thumbnail menerima gambar dengan ekstensi .jpg.jpeg.gif atau .png.
• Parameter thumbnail tidak didukung untuk permintaan batch.

Memposting Tautan ke Halaman

Memposting tautan ke Halaman dengan mengirimkan permintaan POST ke edge /page/feed. Atur parameter publish ke 1 untuk segera menerbitkan postingan atau ke 0 untuk membuat postingan yang tidak diterbitkan tetapi akan diterbitkan nanti.

Contoh Permintaan

curl -i -X POST "https://graph.facebook.com/{your-page-id}/feed
  ?message=Become%20a%20Facebook%20developer!
  &link=https%3A%2F%2Fdevelopers.facebook.com
  &published=1
  &access_token={your-page-access-token}"

GraphRequest request = GraphRequest.newPostRequest(
  accessToken,
  "/{your-page-id}/feed",
  new JSONObject("{\"message\":\"Become a Facebook developer!\",\"link\":\"https://developers.facebook.com\",\"published\":\"1\"}"),
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});
request.executeAsync();

FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/{your-page-id}/feed"
           parameters:@{ @"message": @"Become a Facebook developer!",@"link": @"https://developers.facebook.com",@"published": @"1",}
           HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];

FB.api(
  '/{your-page-id}/feed',
  'POST',
  {"message":"Become a Facebook developer!","link":"https://developers.facebook.com","published":"1"},
  function(response) {
      // Insert your code here
  }
);

try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->post(
    '/{your-page-id}/feed',
    array (
      'message' => 'Become a Facebook developer!',
      'link' => 'https://developers.facebook.com',
      'published' => '1'
    ),
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

Contoh Tanggapan

{"id":"{post-id}"}

Menautkan Postingan Halaman dengan Ajakan Bertindak

Kolom call_to_action menentukan tindakan yang diperlukan dan tautan yang relevan. Tautan ini harus sama dengan parameter link Postingan Halaman. Dalam panggilan ini, title, description, caption, dan picture bersifat opsional, dan jika tidak disediakan, Facebook akan membaca properti yang ekuivalen dari metadata Graf Terbuka tautan tersebut. Jika halaman web yang tertaut tidak memiliki metadata Graf Terbuka, Facebook akan mencoba menebak properti ini dengan mengambil konten halaman web tersebut.

Contoh Permintaan

curl -i -X POST "https://graph.facebook.com/{your-page-id}/feed
  ?message=Become a Facebook developer!
  &link=https://developers.facebook.com
  &call_to_action={"type":"SIGN_UP","value":{"link":"https://developers.facebook.com"}}
  &published=1
  &access_token={your-page-access-token}"

GraphRequest request = GraphRequest.newPostRequest(
  accessToken,
  "/{your-page-id}/feed",
  new JSONObject("{\"message\":\"Become a Facebook developer!\",\"link\":\"https://developers.facebook.com\",\"published\":\"1\",\"call_to_action\":\"{\\\"type\\\":\\\"SIGN_UP\\\",\\\"value\\\":{\\\"link\\\":\\\"https://developers.facebook.com\\\"}}\"}"),
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});
request.executeAsync();

FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/{your-page-id}/feed"
           parameters:@{ @"message": @"Become a Facebook developer!",@"link": @"https://developers.facebook.com",@"published": @"1",@"call_to_action": @"{"type":"SIGN_UP","value":{"link":"https://developers.facebook.com"}}",}
           HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];

FB.api(
  '/{your-page-id}/feed',
  'POST',
  {"message":"Become a Facebook developer!","link":"https://developers.facebook.com","published":"1","call_to_action":"{\"type\":\"SIGN_UP\",\"value\":{\"link\":\"https://developers.facebook.com\"}}"},
  function(response) {
      // Insert your code here
  }
);

try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->post(
    '/{your-page-id}/feed',
    array (
      'message' => 'Become a Facebook developer!',
      'link' => 'https://developers.facebook.com',
      'published' => '1',
      'call_to_action' => '{"type":"SIGN_UP","value":{"link":"https://developers.facebook.com"}}'
    ),
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

Contoh Tanggapan

{"id":"{post-id}"}

Menautkan Postingan dengan Gambar yang Diunggah Khusus

Menggunakan file lokal:

curl -F 'link=http://www.example.com' \
     -F 'thumbnail=@/local/path/to/file/on/hard/drive/image.jpg' \
     -F 'access_token=page-access-token'\
  https://graph.facebook.com/v2.11/page-id/feed

Nilai Hasil

{"id":"post-id"}

Menggunakan Gambar melalui URL:

curl -F 'link=http://www.example.com' \
     -F 'picture=https://www.example.com/path/to/image.jpg' \
     -F 'access_token=page-access-token'\
  https://graph.facebook.com/v2.11/page-id/feed

Nilai Hasil

{"id":"post-id>"}

Postingan Halaman Foto

Kunjungi Referensi Node Foto kami untuk informasi selengkapnya.

Postingan Halaman Video

Kunjungi Referensi Video Halaman untuk informasi selengkapnya.

Insight Postingan Halaman

Kunjungi Referensi Insight Postingan Halaman untuk informasi selengkapnya.

Memperbarui

Anda tidak bisa memperbarui dengan edge ini, tetapi Anda bisa memperbarui postingan menggunakan node /{post-id}.

Menghapus

Anda tidak bisa menghapus dengan edge ini, tetapi Anda bisa menghapus postingan menggunakan node /{post-id}.