دليل مستكشف Graph API
تتيح لك أداة مستكشف Graph API إنشاء استعلامات Graph API وتنفيذها والاطلاع على الاستجابات لأي تطبيق تمتلك فيه دور مسؤول أو مطوّر أومختبر. | فتح أداة مستكشف Graph API |
الاستخدامات الشائعة
- إنشاء رموز الوصول بسرعة
- الحصول على عينات الرموز من الاستعلامات
- إنشاء معلومات حول تصحيح الأخطاء لتضمينها في طلبات الدعم
- اختبار استعلامات API بإعدادات تطبيق الإنتاج بما في ذلك الأذونات والميزات والإعدادات لحالات الاستخدام
- اختبار استعلامات API من خلال التطبيق الاختباري أو التطبيق في وضع التطوير باستخدام الإذن والميزات في الحسابات الاختبارية أو البيانات الاختبارية
المتطلبات
- تطبيق يتوفر لديك فيه دور، مثل مسؤول أو مطوّر أو مختبر
المكونات
رمز الوصول
عند الحصول على رمز وصول، يتم عرضه في أعلى يسار الأداة. هذا هو رمز الوصول الذي يتم تضمينه في استعلام Graph API. يمكنك نسخ هذا الرمز واستخدامه في التطبيق لاختبار الرمز.
انقر على أيقونة المعلومات للاطلاع على معلومات حول رمز الوصول الحالي، بما في ذلك التطبيق الذي يرتبط به وأي أذونات تم منحها بواسطة المستخدم الذي يستخدم التطبيق (الذي يكون أنت).
يمكنك إنشاء رمز وصول جديد إذا انتهت صلاحية الرمز أو إذا أضفت أذونات جديدة.
تطبيق Meta
تعرض قائمة تطبيق Meta المنسدلة في أعلى اليسار كل التطبيقات التي تمتلك فيها دور مسؤول أو مطوّر أو مختبر. استخدم القائمة المنسدلة لتحديد إعدادات التطبيق التي تريد اختبارها.
المستخدم أو الصفحة
تتيح لك قائمة المستخدم أو الصفحة المنسدلة الحصول على رموز وصول التطبيق والمستخدم والصفحة واستبدالها في التطبيق المحدد حاليًا. يمكنك أيضًا استخدامها لإلغاء تثبيت تطبيقك من عقدة المستخدم، التي تتلف رمز الوصول الحالي.
الأذونات
عندما تطلب رمز وصول المستخدم، لن يتم منحك سوى إذن واحد فقط افتراضيًا public_profile. تسمح لك قائمة الأذونات المنسدلة بتحديد أذونات بيانات المستخدم، مثل email وuser_photos وأذونات المناسبات والمجموعات والصفحات، مثل manage_pages وads_management والأذونات الأخرى، مثل أذونات instagram_basic وpublish_video. ويتيح ذلك لمستخدم التطبيق الحالي (الذي يكون أنت) منح الأذونات الخاصة بالتطبيق. لا تمنح إلا الأذونات التي يحتاج إليها تطبيقك فعليًا.
إذا كان التطبيق قيد التطوير، فيمكنك منح التطبيق أي إذن وستعتبرها الاستعلامات بيانات مملوكة لأشخاص لديهم دور في التطبيق. إذا كان تطبيقك في وضع النشر، فإن منح إذن لم يتم اعتماد تطبيقك للحصول عليه بواسطة عملية مراجعة التطبيق يؤدي إلى فشل استعلامك عند إرساله.
حقل سلسلة الاستعلام
عندما تدخل الأداة لأول مرة، سيظهر استعلام افتراضي. يمكنك تعديل الاستعلام عن طريق كتابة استعلام جديد أو عن طريق البحث عن حقول وتحديدها في مشاهد الحقل بعد تنفيذ الاستعلام. يمكنك أيضًا استخدام القوائم المنسدلة للتبديل بين أساليب التشغيل واستهداف إصدارات مختلفة لـ Graph API.
إذا نقرت على أيقونة النجمة الموجودة في نهاية حقل الاستعلام، فسيتم حفظ الاستعلام كمفضلة. يمكنك عرض استعلاماتك المفضلة من خلال النقر على أيقونة الكتاب.
مشاهد حقل العقدة
عند تقديم استعلام GET في عقدة، يعرض عارض الحقل المتواجد في الجانب الأيمن من النافذة اسم العقدة والحقول التي يتم إرجاعها بواسطة Graph API. يمكنك تعديل استعلامك عن طريق البحث عن حقول جديدة وتحديدها أو النقر على أيقونة علامة الجمع والاختيار من الحقول المتوفرة أو إلغاء تحديد الحقول غير اللازمة. تؤدي هذه الإجراءات إلى تحديث استعلامك ديناميكيًا في حقل سلسلة الاستعلام.
نافذة الاستجابة
تعرض الاستجابة المتواجدة أسفل سلسلة الاستعلام النتائج التي تم إرجاعها من آخر استعلام تم إرساله.
الحصول على رمز
إذا كنت راضيًا عن استعلامك، فانقر على الزر الحصول على الرمز المتواجد في منتصف أسفل الاستجابة لإنشاء عينة من الرمز استنادًا إلى الاستعلام. لن تتمكن عادةً من نسخ ولصق عينة من الرمز مباشرةً في قاعدة الرمز، ولكنه يمنحك نقطة بدء مفيدة.
نسخ معلومات تصحيح الأخطاء
إذا استمر استعلامك في الفشل ولم تتمكّن من معرفة السبب وقررت الاتصال بدعم المطوّرين، فانقر على هذا الزر المتواجد في أسفل المنتصف لنسخ التفاصيل الخاصة باستعلامك والاستجابة إلى الحافظة. يمكنك تقديم هذه المعلومات مع طلب الدعم لمساعدتنا في معرفة ما يجري.
حفظ الجلسة
انقر على الزر حفظ الجلسة المتواجد في أسفل المنتصف لحفظ حالة استعلامك مع إزالة رمز الوصول. يمكنك تضمين الرابط إلى هذه الجلسة إذا قررت الاتصال بدعم المطوّرين.
نموذج الاستعلام
جرّب تنفيذ الاستعلام الافتراضي الذي يظهر عند تحميل مستكشف Graph API لأول مرة. إذا لم تكن قد قمت بذلك بالفعل، فافتح مستكشف Graph API في نافذة جديدة وحدّد التطبيق الذي تريد اختباره من قائمة التطبيقات المنسدلة واحصل على رمز وصول المستخدم.
يظهر الاستعلام الافتراضي في حقل سلسلة الاستعلام:
GET https://developers.facebook.com/v21.0/me?fields=id,name
يطلب الاستعلام الافتراضي الحقلين id وname في العقدة /me والتي تُعد عقدة خاصة يتم تعيينها على العقدة /User أو /Page المحددة بواسطة الرمز المميز. نظرًا لأنك تستخدم رمز وصول المستخدم، يتم تعيين ذلك إلى عقدة المستخدم.
يتوفر الحقلان id وname للعامة ويمكن إرجاعهما إذا منح المستخدم تطبيقك أذونات default أو public_profile. هذه الأذونات مُعتمدة مسبقًا لجميع التطبيقات (يمكنك تأكيد ذلك من خلال النقر على أيقونة المعلومات في حقل رمز الوصول)، وبالتالي لا تمنح تطبيقك أي أذونات إضافية لكي يعمل الاستعلام. انقر على الحصول على رمز الوصول وقم بتأكيد رغبتك في منح تطبيقك إمكانية الوصول إلى معلومات المستخدم المتاحة للعامة.
أرسل استعلامك ويجب عليك رؤية اسم ومعرف المستخدم على مستوى التطبيق في نافذة الاستجابة.