يمكنك استخدام API لإعداد استطلاعات رأي خلال عمليات بث فيديو البث المباشر المتوفرة بالحالة LIVE
، وإدارتها. يتم تمثيل استطلاعات الرأي بواسطة كائنات VideoPoll وتتألف من VideoPollOptions التي تمثل إجابات محتملة على السؤال الموجود ضمن استطلاع الرأي.
لإنشاء استطلاع رأي حول عملية بث فيديو البث المباشر، يمكنك إرسال طلب إلى:
POST /{live-video-id}/polls?question={question}&options={options}
يجب أن يحتوي الكائن الهدف LiveVideo على الحالة status
بالقيمة LIVE
حتى يتم إنشاء VideoPoll. عند نجاح العملية، ستستجيب API بمعرف كائن VideoPoll.
{question}
— سؤال استطلاع الرأي.{options}
— مصفوفة من الإجابات المحتملة.يمكنك الرجوع إلى مرجع عنصر الربط استطلاعات فيديو البث المباشر للحصول على قائمة كاملة بمعلمات سلسلة الاستعلام التي يمكنك تضمينها عند إنشاء استطلاع رأي.
النوع | الوصف |
---|---|
رمز وصول الصفحة أو المستخدم الذي أنشأ LiveVideo. | |
بالنسبة لكائن VideoPoll على LiveVideo في مجموعة: | |
بالنسبة لكائن VideoPoll على LiveVideo في مستخدم: بالنسبة لكائن VideoPoll على LiveVideo في صفحة: بالنسبة لكائن VideoPoll على LiveVideo في مجموعة: |
curl -i -X POST \
"https://graph.facebook.com/v3.3/10214959467675612/polls
?question=What%20kind%20of%20bear%20is%20best%3F
&options=%5B%22Black%20bear%22%2C%20%22Brown%20bear%22%2C%20%22That's%20a%20ridiculous%20question%22%5D
&access_token={access-token}"
{ "id": "2318567914888258" // VideoPoll ID }
لإغلاق استطلاع رأي خلال بث فيديو البث المباشر بعد أن حدد الشخص خيار استطلاع الرأي، يمكنك إرسال طلب إلى:
POST /{video-poll-id}?action=CLOSE
النوع | الوصف |
---|---|
بالنسبة لكائن VideoPoll على LiveVideo في مجموعة: | |
بالنسبة لكائن VideoPoll على LiveVideo في مستخدم: بالنسبة لكائن VideoPoll على LiveVideo في صفحة: بالنسبة لكائن VideoPoll على LiveVideo في مجموعة: |
curl -i -X POST \
"https://graph.facebook.com/{video-poll-id}?action=CLOSE&access_token={access-token}"
{ "success": true }
لإعادة فتح استطلاع رأي مُغلق بحيث يمكن للشخص تغيير خيار استطلاع الرأي الخاص به، أرسل طلبًا إلى:
POST /{video-poll-id}?action=SHOW_VOTING
النوع | الوصف |
---|---|
رمز وصول المستخدم الذي أنشأ VideoPoll. | |
بالنسبة لكائن VideoPoll على LiveVideo في مجموعة: | |
بالنسبة لكائن VideoPoll على LiveVideo في مستخدم: بالنسبة لكائن VideoPoll على LiveVideo في صفحة: بالنسبة لكائن VideoPoll على LiveVideo في مجموعة: |
curl -i -X POST \
"https://graph.facebook.com/{video-poll-id}
?action=SHOW_VOTING
&access_token={access-token}"
{ "success": true }
لتكوين استطلاع رأي حتى يعرض النتائج بعد أن ينتهي الشخص من التصويت، أرسل طلبًا إلى:
POST /{video-poll-id}?action=SHOW_RESULTS
النوع | الوصف |
---|---|
رمز وصول المستخدم الذي أنشأ VideoPoll. | |
بالنسبة لكائن VideoPoll على LiveVideo في مجموعة: | |
بالنسبة لكائن VideoPoll على LiveVideo في مستخدم: بالنسبة لكائن VideoPoll على LiveVideo في صفحة: بالنسبة لكائن VideoPoll على LiveVideo في مجموعة: |
curl -i -X POST \
"https://graph.facebook.com/{video-poll-id}
?action=SHOW_RESULTS
&access_token={access-token}"
{ "success": true }
للحصول على إجابات محتملة على أسئلة استطلاع الرأي، يمكنك إرسال طلب إلى:
GET /{video-poll-id}?fields=poll_options
GET /{video-poll-id}/poll_options
للحصول على قائمة بالحقول وعناصر الربط المتوفرة، يمكنك الرجوع إلى مرجع VideoPoll.
النوع | الوصف |
---|---|
رمز وصول المستخدم الذي أنشأ VideoPoll. | |
بالنسبة لكائن VideoPoll على LiveVideo في مجموعة: | |
بالنسبة لكائن VideoPoll على LiveVideo في مستخدم: بالنسبة لكائن VideoPoll على LiveVideo في صفحة: بالنسبة لكائن VideoPoll على LiveVideo في مجموعة: |
يمكن الحصول على إجابات محتملة على أسئلة استطلاع الرأي:
curl -i -X GET \
"https://graph.intern.facebook.com/{video-poll-id}/poll_options
?fields=poll_options
&access_token={access-token}"
كائن يحتوي على قائمة بالإجابات المحتملة (قائمة تضم VideoPollOptions).
{ "poll_options": { "data": [ { "text": "Brown bear", "id": 145049637 }, { "text": "Black bear", "id": 145049638 } { "text": "That is a stupid question", "id": 145049639 } { "text": "Basically, there are two schools of thought", "id": 145049640 } ] }, "id": 12345 }
للحصول على عدد الأصوات المسجّلة على خيار استطلاع الرأي، يمكنك إرسال طلب إلى:
GET /{video-poll-option-id}?fields=total_votes
النوع | الوصف |
---|---|
An access token of a User who created the VideoPollOption. | |
بالنسبة لكائن VideoPoll على LiveVideo في مجموعة: | |
بالنسبة لكائن VideoPoll على LiveVideo في مستخدم: بالنسبة لكائن VideoPoll على LiveVideo في صفحة: بالنسبة لكائن VideoPoll على LiveVideo في مجموعة: | |
رمز الوصول ذاته المُستخدم لإنشاء LiveVideo أو عملية بث. |
curl -i -X GET \
"https://graph.facebook.com/{video-poll-option-id}
?fields=total_votes
&access_token={access-token}"
{ "total_votes": 129, "id": "{video-poll-option}" }
للحصول على عدد الأصوات لكل الإجابات المحتملة حول استطلاع الرأي، استخدم توسيع الحقل في الحقل poll_options
من أجل أن تتضمن الاستجابة الحقل total_votes
حول كائنات VideoPollOptions التي يتم إرجاعها:
GET /{video-poll-id}?fields=poll_options{total_votes}
النوع | الوصف |
---|---|
رمز وصول المستخدم الذي أنشأ LiveVideo. | |
بالنسبة لكائن VideoPoll على LiveVideo في مجموعة: | |
بالنسبة لكائن VideoPoll على LiveVideo في مستخدم: بالنسبة لكائن VideoPoll على LiveVideo في صفحة: بالنسبة لكائن VideoPoll على LiveVideo في مجموعة: |
يمكن الحصول على كل خيارات VideoPollOptions والحقلين text
وtotal_votes
حول VideoPoll.
curl -i -X GET \
"https://graph.intern.facebook.com/{video-poll-id}
?fields=poll_options{text,total_votes}
&access_token={access-token}"
{ "poll_options": { "data": [ { "text": "Brown Bear", "total_votes": 12, "id": 145049637 }, { "text": "Black Bear", "total_votes": 87, "id": 67890 } { "text": "That's a stupid question", "total_votes": 45, "id": 145049639 } { "text": "Basically, there are two schools of thought", "total_votes": 12, "id": 145049640 } ] }, "id": 12345 }