إصدار ‏‎Graph API‎‏

/{object-id}/private_replies

تم إيقاف استخدام الردود الخاصة القديمة في الإصدار 5.0 والإصدارات الأحدث

في 29 أكتوبر 2019، أعلنا عن أنه تم الآن إيقاف استخدام نقطة النهاية هذه. يرجى استخدام الردود الخاصة الجديدة

كجزء من التغييرات التي تطرأ على الإصدار 3.3، تم إيقاف استخدام الإذن read_page_mailboxes. واستخدم الإذن pages_messaging للوصول إلى نقطة النهاية هذه. وسيتوقف الإذن read_page_mailboxes عن العمل بعد 30 يونيو 2020

ويمثل عنصر الربط هذا الردود الخاصة القديمة ويسمح للصفحات بالرد على التعليقات على المنشور ومنشورات الزائر من خلال رسائل النص العادي فقط. ويمكن استخدامه مع العُقد التالية:

يرجى ملاحظة أنه يمكن الرد على التعليق أو المنشور مرة واحدة فقط.

القراءة

لا يمكنك القراءة باستخدام عنصر الربط هذا.

النشر

للرد من خلال رسالة خاصة:

POST /v19.0/{object-id}/private_replies HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->post(
    '/{object-id}/private_replies',
    array (),
    '{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}/private_replies",
    "POST",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{object-id}/private_replies",
    null,
    HttpMethod.POST,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{object-id}/private_replies"
                                      parameters:params
                                      HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

يكون مسموحًا باستخدام الردود الخاصة على المنشورات أو التعليقات في غضون 7 أيام من تاريخ إنشاء منشور المستخدم أو التعليق.

الأذونات

يتطلب عنصر الربط هذا وجود رمز وصول الصفحة بالأذونات التالية:

  • pages_messaging

يتم تقييد استخدام التطبيقات في وضع التطوير لمراسلة الأشخاص الذين يتمتعون بدور في التطبيق. بالإضافة إلى ذلك، مسموح فقط للصفحات بالحالة unpublished بمراسلة الأشخاص الذين يتمتعون بدور في الصفحة.

الحقول

المعلمة الوصف النوع

id

معرف تعليق الصفحة أو منشور الزائر الذي تقوم بالرد عليه.

string

message

نص الرد. هذا الحقل إلزامي.

string

الاستجابة

إذا نجحت العملية، فستتلقى استجابة تتضمن الحقول التالية. علاوةً على ذلك، تدعم نقطة النهاية هذه القراءة بعد الكتابة ويمكنها على الفور قراءة العقدة التي يمثلها معرف id في نوع الإرجاع.

الحقل الوصف النوع

id

معرف الرسالة التي تم إنشاؤها حديثًا.

string

الحذف

لا يمكنك الحذف باستخدام عنصر الربط هذا.

التحديث

لا يمكنك التحديث باستخدام عنصر الربط هذا.