العضو

المسار /{member-id}

يمثل كائن المستخدم كعضو في مجتمع أو مجموعة Workplace.

المسار /community/members

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

الفلترة استنادًا إلى external_id

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

المسار /community/organization_members

يتم إرجاع قائمة بالمستخدمين. يلزم توفير إذن قراءة عضوية المجموعة. بشكل افتراضي، سيتم إدراج حسابات المستخدم النشطة. يمكن إظهار حسابات المستخدم المعطلة بدلاً من ذلك باستخدام معلمة عنوان URL inactive=1.

القراءة

يتم إرجاع كائن مستخدم فردي يمثل مستخدم Workplace. ويمكن الوصول إليه عبر معرف Workplace الخاص بالعضو أو عنوان البريد الإلكتروني الذي يستخدمه العضو عند تسجيل الدخول إلى Workplace.

• /{member_id}
• /{email_address}

الأذونات

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

الحقول

النشر

راجع API إدارة الحساب (Graph)

الحذف

راجع API إدارة الحساب (Graph)

التحديث

راجع API إدارة الحساب (Graph)

عناصر الربط

الأمثلة

استرداد معلومات حول أحد أعضاء المجتمع

الحصول على اسم وعنوان البريد الإلكتروني لعضو معين.

GET /{member_id}?fields=email,name HTTP/1.1
Host: graph.facebook.com

الحصول على معرف العضو من عنوان بريده الإلكتروني

GET /{email_address} HTTP/1.1
Host: graph.facebook.com

سرد أعضاء الشركة بناءً على المعرف الخارجي للمستخدمين

GET /community/members?external_ids=12356,abc123 HTTP/1.1
Host: graph.facebook.com

سرد أعضاء الشركة بما في ذلك الحسابات المعطلة

GET /community/organization_members?inactive=1 HTTP/1.1
Host: graph.facebook.com

الحصول على المناسبات الخاصة بالعضو:

GET graph.facebook.com
      /{member-id}/events

استرداد معلومات حول مدير المستخدم والتقارير

الحصول على تقارير حول عضو معين

GET /{member_id}/reports HTTP/1.1
Host: graph.facebook.com

الحصول على مدير عضو معين

GET /{member_id}/managers HTTP/1.1
Host: graph.facebook.com

استرداد رسائل أحد الأعضاء

الحصول على المحادثات الخاصة بأحد الأعضاء، بما في ذلك الرسائل والمرسل والمرفقات:

يلزم توفير رمز دمج مخصص مع إذن قراءة كل الرسائل:

GET graph.facebook.com
      /{member-id}/conversations?fields=messages{message,attachments,from}

الحصول على معرفات سلسلة رسائل المحادثة لعضو ما عن طريق سلسلة الرسائل:

يلزم توفير رمز دمج مخصص مع إذن قراءة كل الرسائل:

GET graph.facebook.com
      /{member-id}/conversations

الحصول على الرسائل المرتبطة بمعرف سلسلة رسائل محدد، لدى مستخدم محدد:

يلزم توفير رمز دمج مخصص مع إذن قراءة كل الرسائل:

GET graph.facebook.com
      /{thread-id}/messages?user={user-id}

الحصول على المحادثات الخاصة بصفحة البرنامج التلقائي، بما في ذلك الرسائل والمرفقات:

GET graph.facebook.com
      /me/conversations?fields=messages{message,attachments}

حذف رسالة محددة في البريد الوارد الخاص بأحد الأعضاء باستخدام رمز الدمج المخصص:

يلزم توفير رمز دمج مخصص مع إذن حذف رسائل الدردشة

DELETE graph.facebook.com
      /{message-id}?user={user-id}

الحصول على التاريخ والوقت الذي تمت فيه دعوة أحد الأعضاء والمطالبة بحسابه:

يلزم توفير رمز دمج مخصص مع إذن إدارة الحسابات:

GET graph.facebook.com
      /{member-id}?fields=account_invite_time,account_claim_time

الحصول على التاريخ والوقت الذي تم فيه إلغاء تنشيط حساب العضو:

يلزم توفير رمز دمج مخصص مع إذن إدارة الحسابات:

GET graph.facebook.com
      /{member-id}?fields=account_deactivate_time

تسجيل خروج المستخدم من Workplace

يلزم توفير رمز وصول مع إذن تسجيل الخروج:

POST graph.facebook.com
      /{member-id}/logout

تعيين صورة ملف شخصي

يلزم توفير رمز وصول مع إذن إدارة الملفات الشخصية على Workplace. يدعم كلاً من رابط الملف وتحميل الملف ضمن الطلب.

POST graph.facebook.com
      /{member-id}/profile_pictures?
      image_url={...}&
      caption={...}

POST graph.facebook.com
      /{member-id}/profile_pictures?
      caption={...}
Content-Type: multipart/form-data;
Content-Disposition: form-data; name="image_data"; filename="/profile_picture.png

إضافة رقم هاتف العضو

يلزم توفير رمز وصول مع إذن إدارة الملفات الشخصية على Workplace.

POST graph.facebook.com
      /{member-id}/phones?
      type={...}&
      primary={...}&
      number={...}

الحصول على مهارات العضو

يلزم توفير رمز وصول مع إذن قراءة الملف الشخصي على Workplace.

GET graph.facebook.com
      /{member-id}/skills

إضافة مهارة

يلزم توفير رمز وصول مع إذن إدارة الملف الشخصي على Workplace.

POST graph.facebook.com
      /{member-id}/skills?name={...}

إزالة مهارة

يلزم توفير رمز وصول مع إذن إدارة الملف الشخصي على Workplace.

DELETE graph.facebook.com
      /{member-id}/skills?name={...}

الحصول على شارات العضو

يلزم توفير رمز وصول مع إذن قراءة الملف الشخصي على Workplace.

GET graph.facebook.com
      /{member-id}/badges?fields=id,name,description,icon,category

منح شارة مدمجة للمستخدم

يلزم توفير رمز وصول مع إذن إدارة الشارات. راجع وثائق المجتمع لإدراج الشارات المتوفرة ومعرفاتها.

POST graph.facebook.com
      /{member-id}/badges?badge=workplace_champion

منح شارة مخصصة للمستخدم

يلزم توفير رمز وصول مع إذن إدارة الشارات. راجع وثائق المجتمع لإدراج الشارات المتوفرة ومعرفاتها. لاحظ أن الرمز # الموجود في الرابط يجب أن يكون مشفرًا بعنوان URL.

POST graph.facebook.com
      /{member-id}/badges?badge=workplace_custom#{badge_id}

إلغاء تنشيط العضو

يلزم توفير رمز وصول مع إذن توفير حسابات المستخدمين.

POST graph.facebook.com
      /{member-id}?active=false

حذف عضو

يلزم توفير رمز وصول مع إذن توفير حسابات المستخدمين.

DELETE graph.facebook.com
      /{member-id}

الحصول على حالة العمل دون التقيد بمكتب الخاصة بالمستخدم

GET graph.facebook.com
      /{user-id}?fields=frontline
      
    {
      "frontline": {
        "is_frontline": true
      },
    "id": "100038142594104"
    }