‏المرجع‏

العضو

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

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

القراءة

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

  • /{member_id}
  • /{email_address}

الأذونات

إن قراءة معلومات حول العضو يتطلب أحد الإذنين قراءة كل المحتوى أو إدارة الحسابات.

الحقول

اسم الحقلالوصفالنوع

id

يمثل معرف حساب المستخدم الخاص بهذا الشخص.

string

first_name

يمثل الاسم الأول للشخص.

string

last_name

يمثل اسم عائلة الشخص.

string

email

يمثل عنوان البريد الإلكتروني الأساسي للشخص، والذي يُستخدم أيضًا كاسم مستخدم في Workplace.

string

title

يمثل المسمى الوظيفي للشخص على Workplace.

string

department

يمثل اسم قسم الشخص على Workplace، إذا تم التعيين عبر API إدارة الحسابات.

string

employee_number

يمثل المعرف الرقمي أو الأبجدي الرقمي المعيَّن إلى شخص ما، وعادةً ما يعتمد على طلب التوظيف أو الارتباط بمؤسسة.

string

primary_phone

يمثل رقم الهاتف الأساسي المُدرج للشخص. ويتم تعيينه إلى الإدخال phoneNumbers الذي تم تحديده باعتباره primaryعلى API إدارة الحسابات.

string

primary_address

يمثل العنوان الأساسي المُدرج للشخص. ويتم تعيينه إلى الإدخال addresses الذي تم تحديده باعتباره primaryعلى API إدارة الحسابات

string

picture

يمثل صورة الملف الشخصي للشخص.

url

link

يمثل رابط الملف الشخصي للشخص.

url

locale

يمثل لغة الشخص المحلية.

string

name

يمثل اسم الشخص بالكامل.

string

name_format

يمثل اسم الشخص الذي تم تنسيقه لمعالجة طلبات اللغات الصينية أو اليابانية أو الكورية بشكل صحيح.

string

account_invite_time

يمثل وقت دعوة الحساب بتنسيق UTC.

datetime

account_claim_time

يمثل وقت مطالبة الحساب بتنسيق UTC.

datetime

impersonate_token

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

انتحال الشخصية هو إذن تم إيقاف استخدامه. لا تنشئ وظائف جديدة تعتمد على هذا الإذن. حيث لا يمكن إضافة هذا الإذن إلى عمليات الدمج المخصصة بعد الآن.

string

about

يمثل محتوى حقل السيرة الذاتية في الملف الشخصي للمستخدم.

string

frontline

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

object (راجع المثال أدناه)

النشر

لا يمكنك النشر باستخدام هذه العقدة.

الحذف

لا يمكنك الحذف باستخدام هذه العقدة.

التحديث

لا يمكنك التحديث باستخدام هذه العقدة. يمكن تحديث الحسابات أو إلغاء تنشيطها باستخدام API إدارة الحسابات.

عناصر الربط

اسم عنصر الربطالوصف

/events

يمثل الأحداث المرتبطة بهذا الشخص. وبشكل افتراضي، لا يتضمن هذا الأحداث التي رفضها الشخص أو لم يرد عليها.

/feed

يمثل موجز المنشورات (بما في ذلك الحالات الجديدة) والروابط المنشورة بواسطة هذا الشخص.

/conversations

يمثل رسائل Workplace المرتبطة بشخص ما أو صفحة برنامج تلقائي. ويتطلب إذن قراءة كل الرسائل

/managers

يمثل المدير أو المديرين المدرجين لدى الشخص.

/reports

يمثل التقارير المُدرجة للشخص.

/picture

يمثل صور الملف الشخصي للعضو.

/groups

يمثل المجموعات المرتبطة بعضو ما.

الأمثلة

استرداد معلومات حول عضو في مجتمع


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

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


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

GET /{email_address} 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}

يشير الاسم المستعار لـ /me إلى صفحة البرنامج التلقائي عند استخدام رمز دمج مخصص


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

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

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

لا تتوفر هذه الحقول إلا إذا تمت دعوة العضو أو المطالبة بحسابه

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

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

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

يؤدي حذف رسالة إلى حذف الرسالة فقط لدى العضو المحدد في الطلب. لحذف رسالة بشكل كامل، يجب حذف عرض كل عضو لهذه الرسالة.

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

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