بدء الاستخدام

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

قبل البدء

ستحتاج إلى ما يلي:

• التسجيل كمطوّر Meta
• أحد تطبيقات Meta – سيكون هذا التطبيق مخصصًا للاختبار؛ لذا لا يلزم تضمين رمز تطبيقك عند إنشاء تطبيق Meta هذا.
• فتح أداة مستكشف Graph API في نافذة متصفح منفصلة
• فهم موجز لبنية مخطط التواصل الاجتماعي في Meta من دليل نظرة عامة على Graph API

الطلب الأول

الخطوة الأولى: فتح أداة مستكشف Graph API

افتح أداة مستكشف Graph API في نافذة متصفح جديدة. يسمح لك هذا بتطبيق الأمثلة أثناء قراءة هذا العرض التوضيحي.

يتم تحميل المستكشف من خلال إجراء استعلام افتراضي يتضمن الأسلوب GET، وأحدث إصدار من واجهة Graph API، والعقدة /me والحقلين id وname في حقل سلسلة الاستعلام وتطبيق فيسبوك لديك.

الخطوة الثانية. إنشاء رمز وصول

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

يمثل هذا الدفق منتج تسجيل دخول فيسبوك الذي يسمح لأي شخص بتسجيل الدخول إلى تطبيق ما باستخدام بيانات اعتماد فيسبوك. ويتيح تسجيل دخول فيسبوك للتطبيق أن يطلب من الشخص الوصول إلى بيانات فيسبوك الخاصة بالشخص، كما يحق للشخص شخص قبول الوصول أو رفضه. يتوفر اسمك وصورة ملفك الشخصي للعامة، حتى يتمكن الأشخاص من الوصول إليك على فيسبوك، لذا لا يلزم وجود متطلبات إضافية لتشغيل هذا الطلب. انقر على متابعة كـ... يتم إنشاء رمز وصول المستخدم. ويحتوي هذا الرمز على معلومات، مثل التطبيق الذي يجري الطلب والشخص الذي يستخدم التطبيق لإجراء الطلب، إذا كان رمز الوصول لا يزال صالحًا (تنتهي صلاحيته خلال ساعة تقريبًا)، وكذلك مدة الصلاحية ونطاق البيانات التي يمكن للتطبيق طلبها. في هذا الطلب، يكون النطاق public_profile الذي يتضمن اسمك وصورة ملفك الشخصي.

انقر على أيقونة دائرة المعلومات بجوار رمز الوصول لعرض معلومات الرمز.

الخطوة الثالثة. إرسال الطلب

انقر على الزر إرسال في الزاوية العلوية اليسرى.

الاستجابة المفترض أن تراها

في نافذة الاستجابة، سترى استجابة JSON تتضمن معرف مستخدم فيسبوك واسمك.

إذا قمت بإزالة ?fields=id,name من حقل سلسلة الاستعلام ونقرت على إرسال، فسترى النتيجة ذاتها نظرًا لأن name وid هي حقول عقدة المستخدم التي يتم إرجاعها افتراضيًا.

الطلب الثاني

الخطوة الأولى. إضافة حقل

دعونا نجعل الطلب الأول أكثر تعقيدًا عن طريق إضافة حقل آخر، email. وتوجد طريقتان لإضافة الحقول:

• النقر على القائمة المنسدلة للبحث في عارض حقل العقدة على يمين نافذة الاستجابة
• بدء الكتابة في حقل سلسلة الاستعلام.

لنضِف الحقل email وننقر على إرسال.

الاستجابة المفترض أن تراها

رغم أن الاستدعاء لم يفشل، فإنه تم إرجاع الحقلين name وid فقط بجانب رسالة تصحيح الأخطاء. انقر على الرابط (عرض) لتصحيح أخطاء الطلب.

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

الخطوة الثانية. إضافة إذن

في اللوحة اليسرى، ضمن أذونات، انقر على القائمة المنسدلة إضافة إذن. انقر على أذونات بيانات المستخدم وحدّد البريد الإلكتروني. إنشاء رمز وصول مستخدم جديد نظرًا لأنك تقوم بتغيير نطاق رمز الوصول، فسيتعين عليك إنشاء رمز جديد. انقر على إنشاء رمز الوصول. وتمامًا مثل الخطوات المتبعة في الطلب الأول، يجب أن تمنح تطبيقك إذنًا للوصول إلى بريدك الإلكتروني في مربع حوار تسجيل دخول فيسبوك. بمجرد إنشاء الرمز الجديد، انقر على إرسال. والآن سيتم إرجاع كل الحقول الموجودة في طلبك.

الروابط الموجودة في الاستجابة

لاحظ أن قيم id التي تم إرجاعها في نافذة الاستجابة عبارة عن روابط. يمكن لهذه الروابط أن تمثل العُقد، مثل المستخدم أو الصفحة أو المنشور. وإذا نقرت على رابط، فسيستبدل المعرف محتويات حقل سلسلة الاستعلام. الآن، يمكنك تشغيل الطلبات على تلك العقدة. ونظرًا لأن هذه العقدة متصلة بالعقدة الأصلية ومنشور المستخدم، فقد لا تحتاج إلى إضافة أي أذونات. يمكنك النقر على معرف منشور الآن نظرًا لأننا سنستخدمه في المثال التالي.

ملاحظة: تتضمن بعض المعرفات مزيجًا من المعرف الأصل وسلسلة معرف جديدة. على سبيل المثال، سيحتوي منشور المستخدم على معرف منشور يبدو على هذا النحو: 1028223264288_102224043055529 حيث يكون 1028223264288 هو معرف المستخدم.

لنتطرق إلى عنصر الربط

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

على سبيل المثال، إذا قمت بنشر منشور، فيمكنك رؤية معلومات حول المنشور، مثل وقت إنشائه والنص والصور والروابط التي تمت مشاركتها في المنشور وعدد التفاعلات على المنشور. وإذا قمت بالتعليق على منشورك، فستتمكن من الوصول إلى ذلك التعليق، ولكن إذا نشر شخص آخر تعليقًا على منشورك، فلن تتمكن من رؤية التعليق أو من قام بنشره.

الحصول على الرمز البرمجي للطلب

تسمح لك أداة المستكشف باختبار الطلبات وبمجرد أن تتوفر لديك استجابة ناجحة، يمكنك الحصول على الرمز البرمجي لإدراجه في الرمز البرمجي لتطبيقك. في أسفل نافذة الاستجابة، انقر على الحصول على الرمز البرمجي. يعرض المستكشف الرمز البرمجي لـ Android وiOS وJavaScript وPHP وcURL. يتم تحديد الرمز البرمجي مسبقًا بحيث يمكنك نسخه ولصقه ببساطة.

نوصي بتنفيذ مجموعة Facebook SDK لتطبيقك. ستتضمن مجموعة SDK هذه تسجيل دخول فيسبوك الذي يسمح لتطبيقك بطلب الأذونات والحصول على رموز الوصول.

معرفة المزيد

يمكنك استخدام أداة مستكشف Graph API لاختبار أي طلب للمستخدمين والصفحات والمجموعات والمزيد. تفضل بزيارة المرجع الخاص بكل عقدة أو عنصر ربط لتحديد الإذن ونوع رمز الوصول المطلوب.