إصدار ‏‎Graph API‎‏

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

مقاطع فيديو المناسبات /{event-id}/videos

استخدم نقطة النهاية هذه لنشر مقاطع الفيديو في مناسبة. لحذف فيديو موجود أو تحديثه، استخدم العقدة /{video-id} بدلاً من ذلك.

الإنشاء

لنشر فيديو في مناسبة، أرسل POST طلب إلى /{event-id}/videos عنصر ربط في graph-video.facebook.com.

POST /v26.0/{event-id}/videos HTTP/1.1
Host: graph-video.facebook.com

source=%7Bvideo-data%7D
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->post(
    '/{event-id}/videos',
    array (
      'source' => '{video-data}',
    ),
    '{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(
    "/{event-id}/videos",
    "POST",
    {
        "source": "{video-data}"
    },
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
Bundle params = new Bundle();
params.putString("source", "{video-data}");
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{event-id}/videos",
    params,
    HttpMethod.POST,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
NSDictionary *params = @{
  @"source": @"{video-data}",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{event-id}/videos"
                                      parameters:params
                                      HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

التقييدات

  • يجب تشفير مقاطع الفيديو كـ multipart/form-data.
  • إذا أجريت تحميلاً لفيديو من خلال طلب HTTP متعدد الأجزاء أو عن طريق توفير عنوان URL لفيديو، فلا يمكن أن يتجاوز حجم الفيديو 1 جيجابايت ومدة الفيديو 20 دقيقة.
  • يُمكن أن يصل حجم مقاطع الفيديو القابلة لاستئناف التحميل إلى 1.75 جيجابايت وأن تصل مدتها إلى 45 دقيقة.

التنسيقات المدعومة

3g2, 3gp, 3gpp, asf, avi, dat, divx, dv, f4v, flv, m2ts, m4v, mkv, mod, mov, mp4, mpe, mpeg, mpeg4, mpg, mts, nsv, ogm, ogv, qt, tod, ts, vob, wmv.

الأذونات

تمت إزالة الإذن pubish_actions منذ 24 أبريل 2018. يُرجى الرجوع إلى التغييرات العاجلة في سجل التغييرات للاطلاع على مزيد من التفاصيل. ولتمكين مستخدمي تطبيقك من مشاركة المحتوى على فيسبوك، فإننا نوصي باستخدام منتجات المشاركة بدلاً من ذلك.

تتطلب نقطة النهاية هذه رمز وصول المستخدم مع الإذن publish_actions.

الحقول

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

id

المعرف المستهدف الذي نُشر عليه الفيديو.

numeric string

title

عنوان الفيديو.

string

description

وصف الفيديو، الذي يُستخدم كرسالة حالة مصاحبة لأي قصة على الموجز. ويمكن أن تحتوي هذه المعلمة على عمليات ذكر لصفحات Facebook أخرى باستخدام بناء الجملة التالي:

@[page-id]

فعلى سبيل المثال، سيذكر الوصف التالي صفحة مطوّري Facebook ضمنيًا:

Test message @[19292868552] tag

يخضع استخدام هذه الميزة للمراجعة ولكن عند استخدام الصفحات التي تتمتع بدور المسؤول فيها (لكي تتمكن من إجراء استدعاء API، واستخدامها في عملية ذكر) والتطبيق الذي تتمتع بدور المطوّر فيه، يمكنك اختبارها بنفسك قبل المراجعة.

string

source

الفيديو مشفر كبيانات نموذج. هذا الحقل إلزامي.

multipart/form-data

file_url

عنوان URL يمكن الوصول إليه لملف الفيديو. يتعذر استخدامه مع upload_phase.

string

thumb

البيانات الأولية للصورة المصغرة للفيديو المطلوب تحميلها وربطها بفيديو.

image

upload_phase

نوع طلب التحميل المجزأ.

enum{start, transfer, finish}

file_size

إجمالي حجم ملف الفيديو بالبايت.

unsigned int32

start_offset

موضع البايت الأول لجزء الملف.

unsigned int32

video_file_chunk

جزء ملف الفيديو، مشفر كبيانات نموذج. هذا الحقل مطلوب أثناء مرحلة تحميل transfer.

multipart/form-data

upload_session_id

معرف جلسة التحميل المجزأ.

numeric string

الاستجابة

إذا كانت عملية ناجحة:

Struct {
  id: numeric string,
  upload_session_id: numeric string,
  video_id: numeric string,
  start_offset: numeric string,
  end_offset: numeric string,
  success: bool,
  skip_upload: bool,
}

القراءة

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

التحديث

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

الحذف

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