使用此端點存取和發佈內容至專頁。專頁動態消息包括與 Facebook 專頁的任何互動,例如:此專頁發佈的帖子和連結、此專頁的訪客和標註此專頁的公開帖子。
/{page-post-id}
端點更新特定的專頁帖子。/{page-id}/tagged
端點只會擷取標註此專頁的公開帖子。Facebook 專頁的帖子。
新版專頁體驗支援此 API。
要求獲取存取憑證的用戶必須能夠在專頁上執行以下其中一項任務:
此外,必須授予應用程式以下權限:
如果您不是專頁的擁有者或管理者,您將需要:
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
}];
{ "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 | 專頁瀏覽者能否向此帖子傳送私人回覆。需要使用 | ||
caption 3.3 版及更新版本的專頁帖子已停用此欄位。 | string | 帖子中顯示在 | ||
child_attachments | object | 多連結分享帖子的子分享內容。 | ||
created_time | float | 最初發佈帖子的時間。若是有關人生大事的帖子,這將會是該人生大事的日期和時間。 | ||
description 3.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 | 表明帖子是否為環繞式影片帖子。 | ||
link 3.3 版及更新版本的專頁帖子已停用此欄位。 請改用 | string | 附加至此帖子的連結。 | ||
message | string | 帖子中的狀態訊息。 | ||
message_tags | array | 在 | ||
name 3.3 版及更新版本的專頁帖子已停用此欄位。 請改用 | string |
| ||
object_id 3.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 | 此帖子的分享次數。分享次數或會包括已刪除的帖子,以及出於私隱原因無法讓您查看的帖子。 | ||
source 3.3 版及更新版本的專頁帖子已停用此欄位。 請改用 | string | 任何附加至帖子的 Flash 影片或影片檔案之網址。 | ||
status_type | enum{} | 近況更新的類型。其值包含:
| ||
story | string | 用戶無意建立的動態文字,例如新增相片時建立的動態文字。您必須在應用程式中啟用「包含近期活動動態」轉移,才能檢索此欄位。 | ||
story_tags | array | 帖子說明中的一系列標籤。 | ||
subscribed | boolean | 表明用戶是否已訂閱帖子。 | ||
targeting | object | 限制此內容的廣告受眾之物件。只有屬於特定人口統計資料群組的廣告受眾可以查看此內容。人口統計資料為附加部分。每個附加值會將其廣告受眾加入累積目標廣告受眾中。這些值不會覆寫任何可能存在的專頁級別人口統計資料限制。 | ||
to |
| 帖子中提及或指定的個人檔案。如果您以用戶存取憑證讀取此欄位,則系統僅會傳回目前用戶。 | ||
type 3.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 /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
}];
{"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 /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
}];
回應將為 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}
節點以作刪除。