ページの取得とページへの公開を行うには、このエンドポイントを使用します。ページフィードはFacebookページとのあらゆるやり取りを含みます。例えば、このページによって公開された投稿やリンク、このページへの訪問者、ページがタグ付けされた公開投稿などです。
/{page-post-id}エンドポイントを使用すると、特定のページ投稿を更新できます。/{page-id}/taggedエンドポイント を使用すると、ページがタグ付けされている公開投稿だけを取得できます。Facebookページの投稿。
このAPIは、新しいページエクスペリエンスでサポートされています。
アクセストークンをリクエストする人は、ページで次のいずれかのタスクを実行できる必要があります。
さらに、アプリに以下のアクセス許可が必要です。
ページの所有者または管理者でない場合は、以下が必要です。
GET /v24.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月17日T16:24:04+0000",
"message": "Become a Facebook developer!",
"id": "{page-id}_2191966997525824"
},
{
"created_time": "2019年02月26日T21:35:42+0000",
"message": "Hello world!",
"id": "{page-id}_2072371269485398"
},
...
{
"created_time": "2018年01月26日T20: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件を超えるフィード投稿を読み取ろうとすると、100件を超えてはならない旨のエラーメッセージが表示されます。/{page-id}/taggedを使用して当該ページをタグ付けする投稿を表示するとき、他のページからの投稿は、それらのページが信頼できる場合にのみ結果に含まれます。制限: すべての投稿(公開・非公開)はフィードエンドポイントに引き込まれます。唯一の違いは非公開の投稿は物理的なフィードに表示されないことです。しかし、/feedエンドポイントに記載されている投稿が公開されているかどうかを開発者に知らせるために、is_publishedフィールドを/feedエンドポイントに追加することができます
| 名前 | 型 | 説明 |
|---|---|---|
id | string | 投稿のID。 |
actions | object | 投稿、コメント、「いいね!」、シェアのアクションリンク。 |
admin_creator | object | ページ投稿を作成した管理者。ページに管理者が1人しかいない場合、データは返されません。ページアクセストークンと |
id | int | ユーザー、アプリ、またはビジネスのID。 |
name | string | ユーザー、アプリ、またはビジネスの名前。 |
allowed_advertising_objects | string | この投稿で広告掲載を行うことが許可されている目的。 |
application | object | この投稿を公開したアプリに関する情報。 |
attachments | object | ストーリーに関連付けられた添付。 |
backdated_time | float | 過去日付の投稿の日時。通常の投稿の場合、このフィールドはnullに設定されます。 |
call_to_action | object | モバイルアプリのエンゲージメント広告のページ投稿で使用されているコールトゥアクションのタイプ。 |
context | object | モバイルアプリのエンゲージメント広告のページ投稿で使用されているコールトゥアクションのタイプ。 |
can_reply_privately | boolean | ページの閲覧者がこの投稿に非公開の返信を送信できるかどうか。 |
captionページ投稿v3.3以降で廃止されました。 | string |
|
child_attachments | object | マルチリンクのシェア投稿のサブシェア。 |
created_time | float | 投稿が最初に公開された日時。ライフイベントに関する投稿の場合は、ライフイベントの日時です。 |
descriptionページ投稿v3.3以降で廃止されました。代わりに | string | 投稿内のリンクの説明( |
feed_targeting | object | この投稿のフィードターゲットを管理するオブジェクト。これらのグループに属する人は、この投稿を見る可能性が高くなります。それ以外のユーザーが見る可能性もありますが、低くなります。ここに表示されるターゲット設定フィールドはどれでも使用できますが、必須フィールドではありません(ページにのみ適用されます)。 |
age_max | int | 年齢の上限 |
age_min | int | 13以上の整数を指定する必要があります。デフォルトは0です |
cities | int | ターゲットに設定する都市の値。 |
college_years | int | 大学の卒業年を表す整数の配列。 |
countries | string | ターゲットに設定する国の値。最大25の国を指定できます。ISO 3166形式のコードを使用します。 |
education_statuses | int | 学歴に基づいてターゲットを設定するための整数の配列。高校の場合は |
genders | int | 特定の性別をターゲットに設定します。 |
interested_in (削除ここまで)廃止。 | int (削除ここまで) | |
interests | int | ページのファンをターゲットに設定するためのページのID (1つまたは複数)。ページのタイプを使用してIDの候補をターゲット設定オプションとして取得し、返されたIDを使用して指定します。 |
locales | int | ターゲットに設定するロケール。 |
regions | array | ターゲットに設定する地域の値。 |
relationship_statuses | int | 交際ステータスに基づいてターゲット設定するための整数の配列。交際相手がいない場合は |
from |
| 投稿を作成したページ、グループ、またはイベントの |
full_picture | string | 投稿で公開された、または投稿内のリンクからスクレイピングされた、フルサイズバージョンの写真のURL。写真の最大サイズが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 | 投稿が360度動画かどうか。 |
linkページ投稿v3.3以降で廃止されました。 代わりに | string | この投稿に添付されたリンク。 |
message | string | 投稿に含まれるステータスメッセージ。 |
message_tags | array |
|
length | int | タグテキストの長さ。Unicodeコードポイントで表されます。 |
id | string | タグ付けされたプロフィールのID。 |
name | string | プロフィールのタグ付けに使用されるテキスト。 |
offset | int |
|
type | enum{} | タグ付けされたプロフィールのタイプ。 |
nameページ投稿v3.3以降で廃止されました。 代わりに | string |
|
object_idページ投稿v3.3以降で廃止されました。 代わりに | string | 投稿に添付された、アップロード済みの写真または動画のID。 |
parent_id | string | この投稿の親投稿のID (存在する場合)。たとえば、「あなたのページが投稿でメンションされました」というストーリーの場合、 |
permalink_url | string | www.facebook.com上の投稿の永続的な静的URL。例: https://www.facebook.com/FacebookForDevelopers/posts/10153449196353553 |
place | string | この投稿に関連付けられた場所のID。 |
privacy | object | 投稿のプライバシー設定。 |
allow | string |
|
deny | string |
|
description | string | Facebookに表示される、プライバシー設定についての説明テキスト。 |
friends | enum{} |
|
value | enum{} | 実際のプライバシー設定。値は以下のとおりです。
|
promotable_id | string | 直接宣伝できないストーリーの宣伝に使用する投稿のID。 |
promotion_eligibility (削除ここまで)廃止。 | boolean (削除ここまで) | |
promotion_status (削除ここまで)廃止。 | string (削除ここまで) | |
active (削除ここまで) | ||
draft (削除ここまで) | ||
extendable (削除ここまで) | ||
finished (削除ここまで) | ||
inactive (削除ここまで) | ||
ineligible (削除ここまで) |
| |
paused (削除ここまで) | ||
pending (削除ここまで) | ||
rejected (削除ここまで) | ||
properties | object | 添付された動画のプロパティ(動画の長さなど)のリスト。 |
name | string | プロパティ名。 |
text | string | プロパティの値。 |
href | string | プロパティに関連付けられたリンク。 |
sheduled_publish_time | float | 投稿のスケジュール設定された公開日時を示すUNIXタイムスタンプ。 |
shares | object | この投稿がシェアされた回数。シェアされた回数には、削除された投稿やプライバシー上の理由で閲覧できない投稿も含まれます。 |
sourceページ投稿v3.3以降で廃止されました。 代わりに | string | 投稿に添付されたFlashムービーまたは動画ファイルのURL。 |
status_type | enum{} | ステータス更新のタイプ。値は以下のとおりです。
|
story | string | ユーザーが意図的に作成したものではないストーリー(写真が追加されたときに生成されたストーリーなど)のテキスト。このフィールドを取得するには、アプリで「最近のアクティビティストーリーを含める」のマイグレーションを有効にする必要があります。 |
story_tags | array | 投稿の説明に含まれるタグのリスト。 |
subscribed | boolean | ユーザーが投稿をサブスクリプション登録しているかどうか。 |
targeting | object | このコンテンツのオーディエンスを制限するオブジェクト。指定された利用者層データに含まれるオーディエンスのみがこのコンテンツを閲覧できます。利用者層データは追加可能です。値を追加するたびに、その値のターゲットオーディエンスが累積的に追加されます。これらの値は、すでに設定されているページレベルの利用者層データの制限をオーバーライドすることはありません。 |
countries | string | ターゲットに設定する国の値。ISO 3166形式のコードで表されます。 |
locales | int | ターゲットに設定するロケール。タイプ |
regions | list<int> | ターゲットに設定された地域の値。タイプ |
cities | list<int> | 除外された都市の値。タイプ |
to |
| この投稿でメンションまたはターゲット設定されたプロフィール。ユーザーアクセストークンを使用してこのフィールドを読み取った場合は、現在のユーザーのみが返されます。 |
typeページ投稿v3.3以降で廃止されました。 代わりに | enum{} | この投稿のオブジェクトタイプを示す文字列。
|
updated_time | float | 投稿が最後に更新された日時。この値は、投稿が作成または編集された時点か、ユーザーが投稿にコメントした時点で更新されます。UNIXタイムスタンプで表されます。 |
video_buying_eligibility | array | 投稿を異なる動画購入オプションで宣伝できるかどうか。宣伝できる場合は、空のリストが返されます。宣伝できない場合は、投稿を宣伝できない理由のリストが返されます。 |
with_tags |
| 投稿のパブリッシャーが含まれていることを示すタグが付けられたプロフィール。ユーザーアクセストークンを使用してこのフィールドを読み取った場合は、現在のユーザーのみが返されます。 バージョン3.3以降のグラフAPIとマーケティングAPIでは、このエンドポイントは2019年4月30日に廃止されます。過去90日間にこのエンドポイントを使用したアプリは、2019年7月30日まで、APIバージョン3.2以下を使用して引き続きこのエンドポイントを使用できます。過去90日間にこのエンドポイントを使用しなかったアプリは、2019年4月30日以降、このエンドポイントを使用できなくなります。 |
宣伝に使用できる投稿を見つける際は、promotable_idを使用して広告を作成する必要があります。ほとんどの場合、この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}"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"
},
...投稿を宣伝できない理由については、Facebookのヘルプセンターをご覧ください。
利用可能な投稿フィールドの一覧については、投稿のリファレンスドキュメントをご覧ください。
次のエッジを使用してページに公開できます。linkまたはmessageのいずれかを指定する必要があります。
このAPIは、新しいページエクスペリエンスでサポートされています。
CREATE_CONTENTタスクを実行できる場合は、以下が必要です。
投稿はページが発信したものとして表示されます。
クエリするページで
実行できるユーザーがリクエストするページアクセストークン
注: 閲覧者またはアプリがlinkのURLを表示できない場合、投稿は失敗します。
POST /v24.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を使用したGraph Explorer Toolでのテストの例
| 名前 | 型 | 説明 |
|---|---|---|
actions | array | 投稿に添付されるアクションリンク。 |
link | string | アクションリンク自体のURL。 |
name | string | アクションリンクの名前またはラベル。 |
backdated_time | float | この投稿の日付を過去に遡る期間を指定します。 |
backdated_time_granularity | enum{year, month, day, hour, minute} | 日付を遡った投稿がどのように表示されるかをコントロールします。例えば |
child_attachments | object | 投稿内の複数のリンクを指定するのに使用します。最低2個、最大5個のオブジェクト。もしも multi_share_optimizedをtrueに設定すると、オブジェクトを10個までアップロードできますが、Facebookが表示するのは上位5個のオブジェクトです。 |
description | string | 価格、割引情報、ウェブサイトのドメインのいずれかを表示するのに使用します。指定しない場合、リンクされたページのコンテンツが抽出され使用されます。このフィールドは、一般的に30文字以内です(超過分は切り捨てられます)。 |
image_hash | string | 広告画像ライブラリのリンクと関連付けられたプレビュー画像のハッシュ。最も効果的に表示できるのは、458 x 458ピクセル以上、アスペクト比1:1です。 |
link | string | 投稿に添付するリンクのURL。このフィールドは必須です。 |
name | string | リンクプレビューのタイトル。指定しない場合、リンクされたページのタイトルが使用されます。このフィールドは、一般的に35文字以内です(超過分は切り捨てられます)。Facebookインターフェイスでは |
picture | string | リンクと関連付けられた画像プレビューを決定するURL。最も効果的に表示できるのは、458 x 458ピクセル以上、アスペクト比1:1です。 |
feed_targeting | object | このコンテンツのフィードのターゲット設定をコントロールするオブジェクト。これらのグループに属するユーザーは、このコンテンツを見る可能性が高くなります。それ以外のユーザーが見る可能性もありますが、低くなります。ここで示すターゲット設定フィールドはどれでも使用できますが、いずれも必須ではありません。 |
age_max | int | 年齢の上限。65以下の数値を指定します。 |
age_min | int | 13以上の数値を指定します。デフォルトは0です。 |
college_years | int[] | 大学の卒業年を表す整数の配列。 |
education_statuses | int[] | 学歴に基づいてターゲットを設定するための整数の配列。高校の場合は |
genders | list<unsigned int32> | 特定の性別をターゲットに設定します。 |
geo_locations | object | このオブジェクトで、さまざまな位置情報を複数指定できます。このオブジェクトについては、ターゲット設定ガイドをご覧ください。 |
interests | int[] | ファンをターゲットに設定する1つまたは複数のID。 |
locales | int | ターゲットに設定するロケール。 |
relationship_statuses | list<unsigned int32> | 交際ステータスに基づいてターゲット設定するための整数の配列。交際相手がいない場合は |
link | string | 投稿に添付するリンクのURL。 |
description | string | リンクプレビューの説明を上書きします。 |
name | string | リンクプレビューのタイトルを上書きします。 |
picture | string | リンクに関連付けられたプレビュー画像を指定します。 |
thumbnail | file | アップロードしたリンクに関連付けられているプレビュー画像。 |
message | string | 投稿の本文。メッセージには、Facebookページのメンションである |
multi_share_end_card | Boolean |
|
multi_share_optimized | Boolean |
|
object_attachment | string | サムネイル画像として使用される、ユーザーの写真アルバム内にある写真のFacebook ID。そのユーザーが所有する写真でなければならず、メッセージ添付に含めることはできません。 |
place | string | この投稿に関連付けられる位置情報のページID。 |
published | Boolean | この新規公開されるオブジェクトについてのストーリーを表示するかどうか。デフォルトは |
scheduled_publish_time | timestamp | 投稿をいつ公開するかを示すUNIXタイムスタンプ。APIリクエストの時点から10分後〜75日後の日付にする必要があります。 |
tags | csv[string] | この投稿でタグ付けされた人のユーザーIDのコンマ区切りリスト。このフィールドを指定する場合は、 |
targeting | object | このコンテンツのオーディエンスを制限するオブジェクト。これらの利用者データに含まれていない人は、このコンテンツを見ることができません。ページレベルの利用者データの制限が存在する場合、この設定によってそれらはオーバーライドされません。 |
age_min | int | 指定できる値は、13、15、18、21、25のいずれかです。 |
geo_locations | object | このオブジェクトで、さまざまな位置情報を複数指定できます。このオブジェクトについては、ターゲット設定ガイドをご覧ください。 |
フィーリングまたはアクティビティをアイコンとともにページ投稿に追加します。フィーリングまたはアクティビティを投稿する場合は、og_action_type_idとog_object_idの使用が必須です。og_icon_idの使用は任意ですが、使用しない場合、og_object_idに基づいて自動的にアイコンが指定されます。
| 名前 | 説明 |
|---|---|
アクション(feelingやwatchingなど)。 | |
ほとんどの場合は、アクションのタイプを表すアイコン(笑顔アイコンや映画アイコンなど)。 | |
アクションのターゲット(happyやmovieなど)。定義済みオブジェクトまたは |
POST /v24.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}"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();ほとんどの投稿タイプの場合、https://www.facebook.com/{post-id}にアクセスすればFacebook.com上で投稿を見ることができます。または、ユーザーが投稿に「いいね!」したりコメントしたりできるURLを含む投稿のactionsフィールドを取得して、投稿を見ることもできます。
コールトゥアクションボタンにより、リンクページ投稿の機能を強化できます。次のcall_to_actionフィールドを新しいリンクページ投稿に追加できます。
| 名前 | 型 | 説明 |
|---|---|---|
|
| [コールトゥアクション]ボタンを指定するオブジェクト。これは、利用者が投稿を見たときに実行するアクションにします。このボタンをクリックすると、指定するリンクに利用者が誘導されます。 |
|
| [コールトゥアクション]ボタンテキストを決定します。以下の許容値のいずれか1つを指定します。
|
カスタマイズしたリンク画像を付けてページへのリンクを投稿します。リンクから抽出された画像がストーリーの添付によってレンダリングされます。現在は、省略可能なpictureパラメーターで新しい画像へのURLを指定して、その画像をオーバーライドできます。thumbnailパラメーターも同様の機能を提供しますが、このパラメーターはAPI呼び出しでFacebookにアップロードされるローカル画像ファイルを受け入れる点が大きく異なります。
リンクの所有権は、URLノードのownership_permissions{can_customize_link_posts}フィールドで確認できます。新しいリンクを投稿する前にこのエンドポイントを呼び出す必要があります。このステップを実行しないと、カスタムリンクページ投稿はスクレイピングされてないリンクに対して機能しません。詳しくは、リンクの所有権に関するガイドをご覧ください。picture、name、thumbnail、descriptionはバージョン2.10以前のバージョンで廃止され、captionはすべてのバージョンで廃止されました。
| パラメーター | 型 | 説明 |
|---|---|---|
| 文字列 | リンクの説明(リンクキャプションの下に表示されます)。指定しない場合、このフィールドには、リンクからスクレイピングされた情報(通常はページのタイトル)が自動的に入力されます。 |
| 文字列 | リンク添付の名前。このフィールドには、リンクからスクレイピングされた情報が自動的に入力されます。 |
| 文字列 | 画像のURL。画像は、 |
| ファイル | アップロードされる画像ファイル。指定できる値は、 |
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}"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();{"id":"{post-id}"}call_to_actionフィールドに適切なアクションと関連リンクを指定します。このリンクは、ページ投稿のlinkパラメーターと同じでなくてはなりません。この呼び出しで、title、description、caption、pictureは省略可能です。指定しなかった場合は、リンクのOpen Graphメタデータからそれらに相当するプロパティが読み取られます。リンク先のウェブページにOpen Graphメタデータがない場合、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}"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();{"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}ノードを使用して投稿を削除することはできます。