/{object-id}/comments
يوضح هذا المرجع عنصر الربط /comments
الشائع في عُقد واجهة Graph API المتعددة. تتطابق البنية وعمليات التشغيل في كل عقدة. تمتلك الكائنات التالية عنصر الربط /comments
:
يمكن أن تتضمن كائنات التعليق عنصر الربط /comments
، والذي يُعرف بالردود على التعليقات. تتطابق بنية هذه الكائنات، ولكن انتبه إلى أدوات تعديل عناصر الربط تلك.
يمكن إرجاع تعليق على كائن.
لن يتم إرجاع الحقل id
في نقطة النهاية /PAGEPOST-ID/comments
بعد الآن بالنسبة للتطبيقات التي تستخدم ميزة الوصول إلى المحتوى العام للصفحة. للوصول إلى معرفات التعليقات لمنشور صفحة، يجب أن تكون قادرًا على تنفيذ المهمة "MODERATE" على الصفحة التي يتم الاستعلام عنها. يسري هذا التغيير للإصدار +11.0 والإصدارات الأحدث وسيتم تطبيقه لكل الإصدارات في 7 سبتمبر2021.
يتم دعم نقطة النهاية /comments
للكائنات التالية لاستخدام تجربة الصفحة الجديدة:
|
|
filter
إلى stream
أو استخدام الحقل order
./comments
على إرجاع بيانات فارغة في حالة قراءتها باستخدام رمز وصول المستخدم:
id
في نقطة النهاية /PAGEPOST-ID/comments
بعد الآن بالنسبة للتطبيقات التي تستخدم ميزة الوصول إلى المحتوى العام للصفحة. للوصول إلى معرفات التعليقات لمنشور صفحة، يجب أن تكون قادرًا على تنفيذ المهمة "MODERATE" على الصفحة التي يتم الاستعلام عنها.
بالنسبة للكائنات التي تتضمن عشرات الآلاف من التعليقات، قد تواجه قيودًا أثناء تقسيم الصفحات. تعرف على المزيد حول تقسيم الصفحات في دليل استخدام Graph API الذي نوفره.
GET /v21.0/{object-id}/comments 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(
'/{object-id}/comments',
'{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(
"/{object-id}/comments",
function (response) {
if (response && !response.error) {
/* handle the result */
}
}
);
/* make the API call */
new GraphRequest(
AccessToken.getCurrentAccessToken(),
"/{object-id}/comments",
null,
HttpMethod.GET,
new GraphRequest.Callback() {
public void onCompleted(GraphResponse response) {
/* handle the result */
}
}
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
initWithGraphPath:@"/{object-id}/comments"
parameters:params
HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
id result,
NSError *error) {
// Handle the result
}];
GET /v21.0/{object-id}/comments?summary=1&filter=toplevel 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(
'/{object-id}/comments?summary=1&filter=toplevel',
'{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(
"/{object-id}/comments",
{
"summary": true,
"filter": "toplevel"
},
function (response) {
if (response && !response.error) {
/* handle the result */
}
}
);
Bundle params = new Bundle();
params.putBoolean("summary", true);
params.putString("filter", "toplevel");
/* make the API call */
new GraphRequest(
AccessToken.getCurrentAccessToken(),
"/{object-id}/comments",
params,
HttpMethod.GET,
new GraphRequest.Callback() {
public void onCompleted(GraphResponse response) {
/* handle the result */
}
}
).executeAsync();
NSDictionary *params = @{
@"summary": @YES,
@"filter": @"toplevel",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
initWithGraphPath:@"/{object-id}/comments"
parameters:params
HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
id result,
NSError *error) {
// Handle the result
}];
المعلمة | الوصف |
---|---|
| ملخص لبيانات التعريف حول التعليقات بالكائن. الأهم من ذلك أن بيانات التعريف هذه تتضمن |
| إذا كان بإمكان شخص ما الرد على تعليق، فيمكنك فلترة التعليقات حسب أبرز التعليقات أو التعليقات التي تم نشرها مباشرةً على المنشور أو الترتيب الزمني لكل التعليقات.
|
مصفوفة تضم كائنات التعليقات، بالإضافة إلى الحقول التالية عندما يكون summary
بالقيمة true
في الطلب.
الحقل | الوصف |
---|---|
| الترتيب الذي يتم به إرجاع التعليقات.
|
| عدد التعليقات على هذه العقدة. من المهم ملاحظة أن هذه القيمة تتغير بناءً على
ملاحظة: يمكن أن تكون قيمة |
يمكن نشر تعليقات جديدة في أي كائن.
يتم دعم نقطة النهاية /comments
للكائنات التالية لاستخدام تجربة الصفحة الجديدة:
|
|
MODERATE
في الصفحةpages_manage_engagement
لاحظ أن الحقل can_comment
في كائنات التعليق الفردية يشير إلى ما إذا كان من الممكن الرد على هذا التعليق أم لا.
POST /v21.0/{object-id}/comments HTTP/1.1
Host: graph.facebook.com
message=This+is+a+test+comment
/* PHP SDK v5.0.0 */
/* make the API call */
try {
// Returns a `Facebook\FacebookResponse` object
$response = $fb->post(
'/{object-id}/comments',
array (
'message' => 'This is a test comment',
),
'{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(
"/{object-id}/comments",
"POST",
{
"message": "This is a test comment"
},
function (response) {
if (response && !response.error) {
/* handle the result */
}
}
);
Bundle params = new Bundle();
params.putString("message", "This is a test comment");
/* make the API call */
new GraphRequest(
AccessToken.getCurrentAccessToken(),
"/{object-id}/comments",
params,
HttpMethod.POST,
new GraphRequest.Callback() {
public void onCompleted(GraphResponse response) {
/* handle the result */
}
}
).executeAsync();
NSDictionary *params = @{
@"message": @"This is a test comment",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
initWithGraphPath:@"/{object-id}/comments"
parameters:params
HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
id result,
NSError *error) {
// Handle the result
}];
الاسم | الوصف |
---|---|
| معرف اختياري لصورة غير منشورة (راجع الحقل |
| عنوان URL لصورة بتنسيق GIF لتضمينها كتعليق على صورة متحركة بتنسيق GIF. يجب توفير |
| عنوان URL لصورة لتضمينها كتعليق على صورة. يجب توفير |
| صورة يتم تشفيرها كبيانات نموذج لاستخدامها كتعليق على صورة. يجب توفير |
| نص التعليق. يجب توفير اذكر صفحات Facebook أخرى في نص
يخضع استخدام هذه الميزة إلى المراجعة. |
إذا اكتملت العملية بنجاح، فستتلقى استجابة JSON تتضمن معرف التعليق الذي تم إنشاؤه حديثًا. علاوةً عن ذلك، فإن نقطة النهاية هذه تدعم القراءة بعد الكتابة ويمكنها على الفور إرجاع أي حقول يتم إرجاعها من قِبل عمليات القراءة.
{ "id": "{comment-id}" }
لا يمكنك التحديث باستخدام عنصر الربط هذا.
لا يمكنك الحذف باستخدام عنصر الربط هذا.
يمكن حذف التعليقات الفردية باستخدام نقطة النهاية /comment-id.