使用此端點存取和發佈內容至專頁。專頁動態消息包括與 Facebook 專頁的任何互動,例如:此專頁發佈的帖子和連結、此專頁的訪客和標註此專頁的公開帖子。
/{page-post-id} 端點更新特定的專頁帖子。/{page-id}/tagged 端點只會擷取標註此專頁的公開帖子。Facebook 專頁的帖子。
新版專頁體驗支援此 API。
要求獲取存取憑證的用戶必須能夠在專頁上執行以下其中一項任務:
此外,必須授予應用程式以下權限:
如果您不是專頁的擁有者或管理者,您將需要:
GET /v25.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
}];{
"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..."
}
}limit 欄位有所限制,您最多只能讀取 100 個動態消息帖子。如果嘗試讀取更多帖子,您會收到告知您不要超過 100 個帖子的錯誤訊息。/{page-id}/tagged 來顯示標註過此專頁的帖子時,顯示結果會包含來自其他專頁的帖子,但前提是這些專頁必須為真實。限制:所有已發佈和未發佈的帖子都將被納入動態消息端點。唯一分別在於未發佈的帖子將不會在實際動態消息中列出。但您可以向 /feed 端點新增一個 is_published 欄位,讓開發人員知道 /feed 端點中列出的帖子是否已經發佈
| 名稱 | 類型 | 說明 | ||
|---|---|---|---|---|
id | string | 帖子編號。 | ||
actions | object | 帖子上的動作連結:回應、讚好和分享。 | ||
admin_creator | object | 專頁帖子的管理員製作者。如果專頁只有一個管理員,則不會傳回任何數據。需要使用專頁存取憑證和 | ||
allowed_advertising_objects | string | 為此帖子刊登廣告時唯一可用的目標。 | ||
application | object | 有關發佈此帖子的應用程式之資訊。 | ||
attachments | object | 與此動態相關的任何附件。請參閱動態附件節點參考資料以了解 | ||
backdated_time | float | 追溯帖子的追溯時間。對於一般帖子,此欄位會設為 null。 | ||
call_to_action | object | 在流動應用程式互動廣告的所有專頁帖子中使用的呼籲字句類型。 | ||
can_reply_privately | boolean | 專頁瀏覽者能否向此帖子傳送私人回覆。需要使用 | ||
caption3.3 版及更新版本的專頁帖子已停用此欄位。 | string | 帖子中顯示在 | ||
child_attachments | object | 多連結分享帖子的子分享內容。 | ||
created_time | float | 最初發佈帖子的時間。若是有關人生大事的帖子,這將會是該人生大事的日期和時間。 | ||
description3.3 版及更新版本的專頁帖子已停用此欄位。請改用 | string | 帖子中連結的描述(在 | ||
feed_targeting | object | 控制此帖子動態消息目標設定的物件。這些群組中的所有用戶都較有可能看到此帖子,而不屬於這些群組的用戶則較少機會看到此帖子,但仍可能會看到它。您可以使用此處顯示的所有目標指定欄位,但這些欄位均不是必填項目(僅適用於專頁)。 | ||
from |
| 建立帖子的專頁、群組或活動之 | ||
full_picture | string | 在帖子中所發佈的相片之全尺寸版本網址,或從帖子中的連結所抓取的網址。如果相片的最大尺寸超過 720 像素,則系統會調整相片尺寸,將其最大尺寸設定為 720 像素。 | ||
icon | string | 代表帖子類型的圖示之連結。 | ||
instagram_eligibility | enum{} | 表明是否可以在 Instagram 推廣此帖子。如果可以推廣的話,則系統會傳回
| ||
is_eligible_for_promotion | boolean | 表明帖子是否符合資格參與推廣活動。 | ||
is_expired | boolean | 表明帖子是否具有已過期的到期時間。 | ||
is_hidden | boolean | 表明帖子是否標記為隱藏(僅適用於專頁)。隱藏帖子後,系統會將帖子隱藏在專頁的生活時報中,但是用戶仍可在 Facebook 的其他地方(如連結)中見到此帖子。 | ||
is_instagram_eligible | string | 表明是否可以在 Instagram 推廣此帖子。 | ||
is_popular | boolean | 表明帖子是否為熱門帖子。根據以接觸人數百分比表示的動作總數是否超過特定門檻來確定。 | ||
is_published | boolean | 表明是否發佈了經排定發佈的帖子(僅適用於排定發佈的專頁帖子;若是用戶帖子和即時發佈的帖子,此值一律為 | ||
is_spherical | boolean | 表明帖子是否為環繞式影片帖子。 | ||
link3.3 版及更新版本的專頁帖子已停用此欄位。 請改用 | string | 附加至此帖子的連結。 | ||
message | string | 帖子中的狀態訊息。 | ||
message_tags | array | 在 | ||
name3.3 版及更新版本的專頁帖子已停用此欄位。 請改用 | string |
| ||
object_id3.3 版及更新版本的專頁帖子已停用此欄位。 請改用 | string | 任何附加至帖子的已上載相片或影片之編號。 | ||
parent_id | string | 此帖子的母帖子編號(如有)。例如,如果此動態屬於「有一則帖子提及您的專頁」動態,則 | ||
permalink_url | string | 指向 www.facebook.com 帖子的永久靜態網址。範例:https://www.facebook.com/FacebookForDevelopers/posts/10153449196353553。 | ||
place | string | 與此帖子相關的位置編號。 | ||
privacy | object | 帖子的私隱設定。 | ||
promotable_id | string | 用於推廣無法直接推廣的動態之帖子編號。 | ||
promotion_eligibility已停用。請參閱 | boolean | |||
promotion_status已停用。請參閱 | string | |||
properties | object | 任何附加影片的屬性清單(如影片長度)。 | ||
sheduled_publish_time | float | 帖子的排定發佈時間之 UNIX 時戳。 | ||
shares | object | 此帖子的分享次數。分享次數或會包括已刪除的帖子,以及出於私隱原因無法讓您查看的帖子。 | ||
source3.3 版及更新版本的專頁帖子已停用此欄位。 請改用 | string | 任何附加至帖子的 Flash 影片或影片檔案之網址。 | ||
status_type | enum{} | 近況更新的類型。其值包含:
| ||
story | string | 用戶無意建立的動態文字,例如新增相片時建立的動態文字。您必須在應用程式中啟用「包含近期活動動態」轉移,才能檢索此欄位。 | ||
story_tags | array | 帖子說明中的一系列標籤。 | ||
subscribed | boolean | 表明用戶是否已訂閱帖子。 | ||
targeting | object | 限制此內容的廣告受眾之物件。只有屬於特定人口統計資料群組的廣告受眾可以查看此內容。人口統計資料為附加部分。每個附加值會將其廣告受眾加入累積目標廣告受眾中。這些值不會覆寫任何可能存在的專頁級別人口統計資料限制。 | ||
to |
| 帖子中提及或指定的個人檔案。如果您以用戶存取憑證讀取此欄位,則系統僅會傳回目前用戶。 | ||
type3.3 版及更新版本的專頁帖子已停用此欄位。 請改用 | enum{} | 表明此帖子物件類型的字串。
| ||
updated_time | float | 上次更新帖子的時間(即建立或編輯帖子的時間,或者用戶回應帖子的時間),以 UNIX 時戳表示。 | ||
video_buying_eligibility | array | 表明是否可以使用不同的影片購買選項來推廣帖子。此欄位會在影片符合資格時傳回空白清單,否則會傳回無法推廣帖子的原因清單。 | ||
with_tags |
| 獲帖子發佈者標註為與其同在的個人檔案。如果您以用戶存取憑證讀取此欄位,則系統僅會傳回目前用戶。 由 2019 年 4 月 30 日起,3.3 版及更新版本的 Graph API 和推廣 API 將無法使用此端點。應用程式如在過去 90 天內曾使用此端點,則可以在 2019 年 7 月 30 日或之前繼續透過 3.2 版及更舊版本的 API 使用此端點。應用程式如在過去 90 天內未曾使用此端點,則將無法在 2019 年 4 月 30 日或之後使用此端點。 |
在尋找可以加強推廣的帖子時,您必須使用 promotable_id 來建立廣告。在大多數情況下,此編號與 post_id 相同,但並不適用於所有情況。備註:帖子一經加強推廣,就必須透過已連結的廣告帳戶存取,以供編輯。
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}"{
"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"
},
...請瀏覽我們的幫助中心,了解無法加強推廣某個帖子的原因。
請瀏覽我們的帖子參考文件,了解所有可用的帖子欄位。
您可以使用此關係連線發佈內容至專頁。必須提供 link 或 message。
新版專頁體驗支援此 API。
如要執行 CREATE_CONTENT 任務,您需要以下權限:
系統將以專頁的身分展示帖子。
專頁存取憑證,由可以在所查詢專頁上執行
的用戶所要求
請注意:如果檢視器或應用程式無法查看 link 的網址,帖子將無法發佈。
POST /v25.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
}];{"id":"post-id"}此端點支援先寫後讀,並且可以即時傳回由讀取操作傳回的任何欄位。
使用 POST {page-id}/feed 在圖表測試工具中進行測試:

| 名稱 | 類型 | 說明 |
|---|---|---|
actions | array | 附加至帖子的動作連結。 |
backdated_time | float | 指定過去的某個時間,以將此帖子回溯到該時間。 |
backdated_time_granularity | enum{year, month, day, hour, minute} | 控制已回溯帖子出現時的展示方式。例如,如果您選擇 |
child_attachments | object | 用於在帖子中指定多個連結。最少可以指定 2 個物件,最多可以指定 5 個物件。如果您設定了 multi_share_optimized為「true」,則您最多可以上載 10 個物件,但 Facebook 只會顯示首 5 個。 |
feed_targeting | object | 控制此內容動態消息目標設定的物件。這些群組中的所有用戶都較有可能看到此內容,而不屬於這些群組的用戶則較少機會看到此內容,但仍有可能會看到。您可以使用此處顯示的所有目標指定欄位,但這些欄位不是必要項目。 |
link | string | 附加至帖子的連結網址。必須提供 |
message | string | 帖子的正文。此訊息或會包含 Facebook 專頁提及 |
multi_share_end_card | Boolean | 如果設定為 |
multi_share_optimized | Boolean | 如果設定為 |
object_attachment | string | 用戶相簿中用作為縮圖的現有相片 Facebook 編號。他們必須是相片的擁有者,並且該相片不能是訊息附件的一部分。 |
place | string | 此帖子相關位置的專頁編號。 |
published | Boolean | 系統有否展示關於最新發佈物件的限時動態。預設為 |
scheduled_publish_time | timestamp | UNIX 時戳,表示帖子應在何時發佈。時間須為 API 要求後 10 分鐘至 75 日之間。 |
tags | csv[string] | 逗號分隔清單,以列出標註於此帖子的用戶編號。您必須指定 |
targeting | object | 限制此內容的廣告受眾之物件。任何不屬於此等人口統計資料群組的用戶將無法查看此內容。這不會覆寫任何可能存在的專頁級別人口統計限制。 |
在專頁帖子加入感受或動態及圖示。在發佈感受或動態時,必須使用 og_action_type_id 和 og_object_id。og_icon_id 是選用項目,但如果不使用此項,系統便會根據 og_object_id 自動提供圖示。
POST /v25.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
}];回應將為 post_id。
我們支援下列類型的贊助式專頁帖子:
| 帖子類型 | 說明 |
|---|---|
連結專頁帖子是向您網站分享連結的最有效方法,可讓您選擇替代圖像和加入額外文字。 | |
此為配有文字說明且說明當中包含選用連結的相片專頁帖子。 | |
配有文字說明的專頁帖子。 | |
配有選用文字說明的影片專頁帖子。 |
贊助式專頁帖子與已發佈專頁帖子的處理方法相同,不過前者不會出現於 /feed。
如要查看贊助式專頁帖子清單,請查詢 is_published 欄位。
curl -i -X GET \
"https://graph.facebook.com/{page-id}/feed
?fields=is_published
&access_token={your-page-access-token}"如需查看 Facebook.com 上的帖子,您可以前往 https://www.facebook.com/{post-id} 查閱大部分帖子類型,或檢索帖子的 actions 欄位,此欄位包含用戶可在帖子中讚好或留言的網址。
您可以使用呼籲字句按鈕來提升您的連結專頁帖子。以下 call_to_action 欄位可加入新的連結專頁帖子中。
| 名稱 | 類型 | 說明 |
|---|---|---|
|
| 指定呼籲字句按鈕的物件。這應是用戶查看您的帖子時,您希望他們採取的動作。點擊此按鈕後,用戶將會前往您所指定的連結。 |
利用自訂連結圖像向專頁發佈連結。限時動態的附件會顯示從連結檢索的圖像。目前,您可以在選用 picture 參數中提供新圖像網址,以覆寫該圖像。thumbnail 參數亦能提供類似的功能,兩者最大的分別在於此參數接受在 API 呼叫中上載至 Facebook 的本地圖像檔案。
如要驗證連結的所有權,請在 URL 節點上檢查 ownership_permissions{can_customize_link_posts} 欄位。您必須在發佈新連結前呼叫此端點。如果沒有此步驟,自訂連結專頁帖子將無法用於未抓取連結。如需詳細資訊,請參閱我們的連結擁有權指南。v2.10 版及以下版本的 picture、name、thumbnail 和 description 已停用。所有版本的 caption 均已停用。
| 參數 | 類型 | 說明 |
|---|---|---|
| 字串 | 連結的說明(顯示在連結說明文字下方)。如果未有指定,此欄位會自動填入從連結抓取的資料,通常會是網頁的標題。 |
| 字串 | 連結附件的名稱。此欄位會自動填充從連結抓取的資訊。 |
| 字串 | 圖像的網址。系統將由 |
| file | 需上載的圖像檔案。接受 |
thumbnail 參數僅可用於 Facebook 專頁的連結帖子。thumbnail 參數的優先順序高於 picture 參數。如果您同時提供兩者,則系統不會使用 picture 參數。thumbnail 參數接受副檔名為 .jpg、.jpeg、.gif 或 .png 的圖像。thumbnail 參數。向 /page/feed 關係連線傳送一個 POST 要求,以向專頁發佈連結。將 publish 參數設為 1,以立即發佈帖子;或將之設為 0,以建立稍後發佈的未發佈帖子。
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}"{"id":"{post-id}"}call_to_action 欄位會指定相應的動作和相關連結。此連結將與專頁帖子的 link 參數相同。在此呼叫中,title、description、caption 和 picture 為選用項目。如果不提供這些項目,Facebook 會從連結的開放式圖表中繼資料中讀取同等屬性。如果已連結的網頁沒有開放式圖表中繼資料,Facebook 會抓取網頁內容,以嘗試猜測這些屬性。
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}"{"id":"{post-id}"}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傳回值
{"id":"post-id"}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傳回值
{"id":"post-id>"}如要了解更多資訊,請瀏覽我們的相片節點參考資料。
如要了解更多資訊,請瀏覽我們的專頁影片參考資料。
如要了解更多資訊,請瀏覽我們的專頁帖子洞察報告參考資料。
您無法使用此關係連線更新帖子,但是您可以使用 /{post-id} 節點以作更新。
您無法使用此關係連線刪除帖子,但是您可以使用 /{post-id} 節點以作刪除。