استخدم نقطة النهاية هذه للوصول إلى صفحة والنشر فيها. يشمل موجز الصفحة أي تفاعلات مع صفحة فيسبوك بما في ذلك: المنشورات والروابط المنشورة بواسطة هذه الصفحة، وزوار هذه الصفحة، والمنشورات العامة التي تمت الإشارة إلى الصفحة فيها.
/{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 منشور./{page-id}/tagged
لعرض المنشورات التي تقوم بالإشارة إلى هذه الصفحة، تتضمن النتائج منشورات من صفحات أخرى فقط إذا كانت هذه الصفحات موثوقة.تقييد: سيتم سحب كل المنشورات (المنشورة وغير المنشورة) في نقطة نهاية الموجز. الاختلاف الوحيد هو أنه لن يتم إدراج المنشورات غير المنشورة في الموجز الفعلي. ومع ذلك، يوجد حقل is_published يمكن إضافته إلى نقطة النهاية /feed لإعلام المطوّرين إذا كان المنشور المدرج في نقطة النهاية /feed منشورًا أم لا
الاسم | النوع | الوصف | ||
---|---|---|---|---|
id | string | يمثل معرف المنشور. | ||
actions | object | يمثل روابط الإجراءات المرتبطة بالتعليق على المنشور أو تسجيل الإعجاب به أو مشاركته. | ||
admin_creator | object | يمثل منشئ محتوى منشور الصفحة الذي يتمتع بدور المسؤول. إذا كانت الصفحة لديها مسؤول واحد فقط، فلن يتم إرجاع أي بيانات. ويتطلب ذلك الحصول على رمز وصول الصفحة والإذن | ||
allowed_advertising_objects | string | يمثل الأهداف الوحيدة التي يمكن من خلالها الإعلان عن هذا المنشور. | ||
application | object | يمثل معلومات حول التطبيق الذي نشر هذا المنشور. | ||
attachments | object | يمثل أي مرفقات مرتبطة بالحدث. يمكنك الرجوع إلى مرجع عقدة مرفق الحدث لحقول | ||
backdated_time | float | يمثل الوقت المؤرخ بتاريخ سابق لمنشور بتاريخ سابق. وبالنسبة للمنشور العادي، يتم تعيين هذا الحقل إلى قيمة فارغة. | ||
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 | يمثل عنوان URL لنسخة بالحجم الكامل من الصورة المنشورة في المنشور أو المُستخلصة من رابط ما في المنشور. وإذا تجاوز أكبر بُعد للصورة 720 بكسل، فسيتم تغيير حجمه، مع تعيين البُعد الأكبر على 720. | ||
icon | string | يمثل رابط ينقلك إلى أيقونة تمثل نوع هذا المنشور. | ||
instagram_eligibility | enum{} | يشير إلى ما إذا كان يمكن ترويج المنشور على Instagram أم لا. ويتم إرجاع التعداد
| ||
is_eligible_for_promotion | boolean | يشير إلى ما إذا كان المنشور مؤهلاً للترويج أم لا. | ||
is_expired | boolean | يشير إلى ما إذا كانت انقضت فترة انتهاء صلاحية المنشور أم لا. | ||
is_hidden | boolean | يشير إلى ما إذا تم تحديد هذا المنشور كمخفي (ينطبق على الصفحات فقط). وعند إخفاء أحد المنشورات، يتم إخفاؤه في يوميات الصفحة، ولكنه يظل مرئيًا في الأماكن الأخرى على فيسبوك، مثل رابط. | ||
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 | يمثل عنوان URL الثابت والدائم للمنشور على 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 | يمثل عنوان URL لأي فيلم 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 |
| يمثل الملفات الشخصية التي تمت الإشارة إليها باعتبارها مع ناشر المنشور. وإذا قرأت هذا الحقل من خلال رمز وصول المستخدم، فسيقوم بإرجاع المستخدم الحالي فقط. سيتم إيقاف استخدام نقطة النهاية هذه في 30 أبريل 2019 بالنسبة للإصدار 3.3 والإصدارات الأحدث لواجهة Graph API وواجهة API التسويق. ويمكن للتطبيقات، التي استخدمت نقطة النهاية هذه خلال آخر 90 يومًا، متابعة استخدامها مع الإصدار 3.2 والإصدارات الأقدم لواجهة API حتى 30 يوليو 2019. سيتعذر على التطبيقات التي لم تستخدم نقطة النهاية هذه خلال آخر 90 يومًا، استخدامها اعتبارًا من 30 أبريل 2019. |
عند العثور على منشورات يمكن ترويجها، يجب استخدام 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
، فستحتاج إلى ما يلي:
ستظهر المنشورات باسم الصفحة.
رمز وصول الصفحة الذي يطلبه شخص ما يمكنه تنفيذ
على الصفحة التي يتم الاستعلام عنها
ملاحظة: إذا لم يتمكّن المشاهد أو التطبيق من عرض عنوان url للرابط 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"}
تدعم نقطة النهاية هذه ميزة القراءة بعد الكتابة ويمكنها إرجاع أي حقول تم إرجاعها بواسطة عمليات القراءة على الفور.
الاختبار في أداة مستكشف Graph باستخدام POST {page-id}/feed
:
الاسم | النوع | الوصف |
---|---|---|
actions | array | يمثل روابط الإجراءات المرفقة بالمنشور. |
backdated_time | float | يمكن تحديد وقت في الماضي لتأريخ هذا المنشور بتاريخ سابق. |
backdated_time_granularity | enum{year, month, day, hour, minute} | يمكن التحكم في عرض طريقة ظهور منشور مؤرخ بتاريخ سابق. فعلى سبيل المثال، إذا اخترت |
child_attachments | object (كائن) | يمكن استخدامه لتحديد روابط متعددة في المنشور. بحد أدنى كائنين وبحد أقصى 5 كائنات. وإذا تم تعيين multi_share_optimized على القيمة true، فيمكنك تحميل 10 كائنات كحد أقصى ولكن سيعرض فيسبوك أبرز 5. |
feed_targeting | object | يمثل الكائن الذي يتحكم في استهداف الموجز لهذا المحتوى. ستزيد احتمالية اطّلاع أي شخص في هذه المجموعات على هذا المحتوى، بينما تقل الاحتمالية لغير الموجودين في المجموعات، ولكن يظل بإمكانهم الاطلاع عليه على أي حال. يمكن استخدام أحد حقول الاستهداف المعروضة هنا، ولا يلزم توفر أي منها. |
link | string | عنوان URL للرابط المطلوب إرفاقه بالمنشور. يتعين توفير |
message | string | النص الأساسي للمنشور. يمكن أن تحتوي الرسالة على عمليات ذكر لصفحات فيسبوك، |
multi_share_end_card | Boolean | في حالة التعيين على القيمة |
multi_share_optimized | Boolean | في حالة التعيين على القيمة |
object_attachment | string | معرف فيسبوك لصورة حالية موجودة في ألبومات صور الشخص لاستخدامها كصورة مصغرة. ويتعين أن يكون مالك الصورة ولا يمكن أن تكون الصورة جزءًا من مرفق الرسالة. |
place | string | معرف الصفحة لموقع مرتبط بهذا المنشور. |
published | Boolean | يمكن معرفة ما إذا كانت توجد قصة معروضة حول هذا الكائن المنشور حديثًا أم لا. القيمة الافتراضية هي |
scheduled_publish_time | timestamp | يشير الطابع الزمني بتنسيق UNIX إلى وقت نشر المنشور. ويجب أن يقع الوقت بين 10 دقائق و75 يومًا من وقت بدء طلب API. |
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
الخاص بالمنشور والذي يحتوي على عنوان URL الذي يمكن للمستخدم من خلاله الإعجاب بالمنشور أو التعليق عليه.
يمكنك تحسين منشورات صفحات الروابط من خلال أزرار الدعوة لاتخاذ إجراء. يمكن إضافة الحقل call_to_action
التالي إلى منشورات صفحات الروابط الجديدة.
الاسم | النوع | الوصف |
---|---|---|
|
| الكائن الذي يحدد زر "دعوة لاتخاذ إجراء". يجب أن يكون هذا هو الإجراء الذي تريد أن يتخذه الأشخاص عند رؤيتهم للمنشور. وسيؤدي النقر على هذا الزر إلى نقل الأشخاص إلى الرابط الذي تحدده. |
يمكن نشر رابط على صفحة تحتوي على صورة رابط مخصص. وسيعرض مرفق القصة صورة تم استردادها من الرابط. يمكنك حاليًا تجاوز هذه الصورة من خلال توفير معلمة picture
اختيارية بعنوان URL لصورة جديدة. توفر المعلمة thumbnail
وظائف متشابهة مع وجود اختلاف رئيسي وهو أن المعلمة تقبل ملفًا لصورة محلية تم تحميله إلى Facebook في استدعاء واجهة API.
للتحقق من صحة ملكية الرابط، تحقق من الحقل ownership_permissions{can_customize_link_posts}
الموجود في العقدة URL
. يتعين عليك استدعاء نقطة النهاية هذه قبل نشر روابط جديدة. في حالة عدم إجراء هذه الخطوة، لن تعمل منشورات صفحات الروابط المخصصة في الروابط التي لم يتم استخلاصها. لمزيد من المعلومات، راجع دليل ملكية الرابط. بالنسبة للإصدار 2.10 والإصدارات الأقدم، تم التوقف عن استخدام picture
وname
وthumbnail
وdescription
. وتم التوقف عن استخدام caption
لجميع الإصدارات.
المعلمات | النوع | الوصف |
---|---|---|
| string (سلسلة) | وصف الرابط (يظهر أسفل الشرح التوضيحي للرابط). وفي حالة عدم تحديده، يتم ملء هذا الحقل تلقائيًا بالمعلومات التي تم استخلاصها من الرابط والتي عادةً تكون هي عنوان الصفحة. |
| string (سلسلة) | اسم مرفق الرابط. يتم ملء هذا الحقل تلقائيًا بالمعلومات التي تم استخلاصها من الرابط. |
| string (سلسلة) | عنوان URL للصورة. تكون الصورة واردة من عنوان URL المتوفر في |
| file (الملف) | ملف الصورة المطلوب تحميله. يمكن قبول تنسيقات |
thumbnail
فقط في منشورات الروابط على صفحات Facebook.thumbnail
بأسبقية أعلى من المعلمة picture
. وفي حالة توفير كليهما، لا يتم استخدام معلمة picture
.thumbnail
الصور بامتداد .jpg
أو .jpeg
أو .gif
أو .png
.thumbnail
غير مدعومة في طلبات الدفعات.يمكن نشر رابط على صفحة من خلال إرسال طلب POST إلى عنصر الربط /page/feed
. ويمكنك تعيين المعلمة 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 الخصائص المكافئة من بيانات تعريف 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}"
{"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}
.