تتيح لك واجهة برمجة التطبيقات لتطبيق الأشخاص ما يلي:
- قراءة جهات اتصال المستخدم الذي تمت المصادقة عليه وإدارتها
- قراءة "جهات الاتصال الأخرى" للمستخدم الذي تمت مصادقته ونسخه
- قراءة معلومات الملف الشخصي للمستخدمين الذين تمت مصادقتهم وجهات اتصالهم
- قراءة الملفات الشخصية للنطاق وجهات الاتصال
على سبيل المثال، لنفترض أن المستخدم الذي تمت المصادقة عليه، يوسف، لديه فابيان ورانجيث في
جهات اتصاله الخاصة. عندما يتصل تطبيقك
people.connections.list لقراءة
قائمة باتصالاتها، تظهر شاشة لموافقة جين تطلب فيها
منح التطبيق إمكانية الوصول إلى القائمة. في حال موافقة جين، يقرأ التطبيق قائمة تتضمّن
person resources لفابيان ورانجيث.
إذا كان التطبيق يحتاج إلى معلومات عن شخص معيّن، يمكنه عندئذٍ استدعاء
people.get، مع تمرير اسم المورد، للحصول على person resource لهذا الشخص.
يمكن للتطبيق أيضًا إدارة جهات الاتصال من خلال إنشاء جهات اتصال جديدة باستخدام
people.createContact وتعديل جهات الاتصال
الحالية التي قرأها من
people.connections.list باستخدام
people.updateContact وحذف جهات الاتصال
باستخدام people.deleteContact.
يمكن لمستخدمي Google Workspace أيضًا إدراج الملفات الشخصية في نطاق الدليل وجهات اتصال النطاق باستخدام
people.listDirectoryPeople أو البحث
عنها باستخدام
people.searchDirectoryPeople.
عرض مدمج لمعلومات الأشخاص
يتم دمج معلومات الأشخاص التي تقرأها واجهة برمجة تطبيقات "الأشخاص" من مصادر مختلفة، بناءً على الشروط التالية:
| المصدر | الشرط |
|---|---|
| بيانات الملف الشخصي العامة في Google | دائمًا. |
| بيانات الملف الشخصي في نطاق Google Workspace | لقد فعّل مشرف النطاق مشاركة جهات الاتصال الخارجية
والملف الشخصي
للبيانات على مستوى النطاق، كما تم منح directory.readonly
النطاق |
| معلومات الملف الشخصي الخاص للمستخدم الذي تمت المصادقة عليه | تم منح أحد profile
النطاقات. |
| جهات اتصال المستخدم الذي تمت المصادقة عليه | تم منح contacts
النطاق. |
فهم بيانات الأشخاص الذين تم دمجهم
يتم استخلاص بيانات أحد الأشخاص من نوع مصدر رئيسي واحد. يتم دمج البيانات من المصادر الأخرى مع هذه البيانات إذا كانت المصادر متصلة من خلال عناوين البريد الإلكتروني أو أرقام الهواتف أو عناوين URL للملف الشخصي التي تم التحقق منها. وفي ما يلي الطرق التي يمكن أن يُنشئ بها الشخص:
| المصدر الرئيسي | جهات الاتصال | ملفات التعريف | الملفات الشخصية في نطاق Google Workspace | جهات اتصال نطاق Google Workspace | الاستخدام |
|---|---|---|---|---|---|
| جهة اتصال | 1 | 0+ | 0+ | 0+ | تم الإرجاع مع معظم نقاط النهاية. |
| الملف الشخصي | 0+ | 1 | 0 أو 1 | 0 | يُعرَض في people.get عند استخدامه في الحصول على المستخدم للمستخدم الذي تم تسجيل دخوله أو الحصول على مستخدم لحساب Google لمستخدم آخر. |
| جهة اتصال النطاق | 0+ | 0 | 0 | 1 | تمت الإعادة في people.listDirectoryPeople أو people.searchDirectoryPeople. |
يمكن تعديل الأشخاص المستندين إلى جهات الاتصال فقط من خلال نقاط نهاية التغيير. لا يتم دعم طفرات جهات اتصال الملف الشخصي والنطاق.