API الملف الشخصي للمستخدم

تتيح لك API الملف الشخصي للمستخدم استخدام المعرف على مستوى الصفحة (PSID) لاسترداد معلومات الملف الشخصي للمستخدم التي يمكن استخدامها لإضفاء طابع شخصي على تجربة الأشخاص الذين يتفاعلون مع Messenger.

التوّفر

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

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

اشتراك المستخدم

ستُصرح الأحداث التالية لبرنامجك التلقائي على Messenger بالوصول إلى معلومات الملف الشخصي للمستخدم:

يبدأ الشخص المحادثة عبر شاشة ترحيب ويضغط على الزر "بدء الاستخدام".
يبدأ الشخص المحادثة بالنقر على الزر "إرسال إلى Messenger".
يبدأ الشخص المحادثة بإرسال رسالة.
يبدأ الشخص المحادثة بقبول طلب مراسلة الصفحة.
يستخدم برنامجك التلقائي على Messenger الوظيفة askPermission() لمجموعة SDK لملحقات Messenger في طريقة عرض ويب لطلب الإذن user_profile.
بالنسبة إلى تطبيقات النشاط التجاري، تكون ميزة الوصول إلى الملف الشخصي لمستخدم أصل النشاط التجاري مطلوبة كإجراء إضافي، ويمكن التقدم بطلب الحصول عليها عبر عملية مراجعة التطبيقات.

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

عندما تبدأ المحادثات عبر المكون الإضافي "مربع الاختيار" حيث لم يرد الشخص على Messenger.
غند إجراء تفاعلات مع إعلانات النقر لفتح محادثة في Messenger قبل رد الشخص على Messenger

الملف الشخصي غير متوفر

لا تدعم API الملف الشخصي للمستخدم حاليًا إمكانية استرداد معلومات الملف الشخصي لحسابات Messenger التي تم إنشاؤها باستخدام رقم الهاتف.

في هذه الحالة، ستقوم API بإرجاع رمز الخطأ 2018218 مع عرض الرسالة "لا يتوفر ملف شخصي لهذا المستخدم."

حقول الملف الشخصي المتوفرة

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

اسم الحقل	الوصف	الإذن
`id`	معرّف المستخدم على نطاق الصفحة (PSID)	غير متوفر
`name`	الاسم الأول واسم العائلة للمستخدم	غير متوفر
`first_name`	الاسم الأول	غير متوفر
`last_name`	اسم العائلة	غير متوفر
`profile_pic`	صورة ملفك الشخصي	غير متوفر
`locale`	لغة المستخدم على فيسبوك	`pages_user_locale`
`timezone`	المنطقة الزمنية، رقم مقارنة بتوقيت جرينتش GMT	`pages_user_timezone`
`gender`	الجنس	`pages_user_gender`

طلب وصول الميزة إلى حقول المستخدم للصفحة

انتقل إلى إعدادات الصفحة > المراسلة المتقدمة
ضمن "معلومات حول الأشخاص"، حدّد الحقل وانقر على الزر "طلب".

استرداد الملف الشخصي للمستخدم

لاستخدام API الملف الشخصي للمستخدم، أرسل طلب GET مع تضمين حقول الملف الشخصي التي تريد استردادها حول الشخص:

curl -X GET "https://graph.facebook.com/<PSID>?fields=first_name,last_name,profile_pic&access_token=<PAGE_ACCESS_TOKEN>"

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

{
  "first_name": "Peter",
  "last_name": "Chang",
  "profile_pic": "https://fbcdn-profile-a.akamaihd.net/hprofile-ak-xpf1/v/t1.0-1/p200x200/13055603_10105219398495383_8237637584159975445_n.jpg?oh=1d241d4b6d4dac50eaf9bb73288ea192&oe=57AF5C03&__gda__=1470213755_ab17c8c8e3a0a447fed3f272fa2179ce",
  "locale": "en_US",
  "timezone": -7,
  "gender": "male",
  "last_ad_referral": {
    "source": "ADS",
    "type": "OPEN_THREAD",
    "ad_id": "6045246247433"
  }
}

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

راجع أيضًا

رموز الخطأ في منصة Messenger