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

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

موافقة المستخدم

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

المتطلبات

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

• الإذن instagram_basic
• الإذن instagram_manage_messages
• الأذونات pages_manage_metadata
• الإذن pages_read_engagement
• الإذن pages_show_list
• رمز وصول الصفحة الذي يطلبه شخص يمكنه تنفيذ المهمة MODERATE في الصفحة

التقييدات

إذا قام عميل بحظر نشاطك التجاري، فلن تتمكن من عرض معلوماته.

حقول الملف الشخصي للمستخدم

تتوفر حقول الملف الشخصي التالية لكل إصدارات Graph API.

تتوفر حقول الملف الشخصي التالية لواجهة Graph API بالإصدار 12.0 والإصدارات الأحدث.

تتوفر الحقول التالية لواجهة Graph API بالإصدار 14.0 والإصدارات الأحدث.

أمثلة

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

عينة من الطلب

curl -X GET "https://graph.facebook.com/v19.0/instagram-scoped-user-id
  ?fields=name,username,profile_pic,follower_count,is_user_follow_business,is_business_follow_user
  &access_token=page-access-token"

عند نجاح العملية، سيتلقى تطبيقك استجابة JSON التالية:

{
  "name": "Peter Chang",
  "username": "peter_chang_live",
  "profile_pic": "https://fbcdn-profile-...",
  "follower_count": 1234
  "is_user_follow_business": false,
  "is_business_follow_user": true,
}