تتيح لك واجهة برمجة تطبيقات "الأشخاص" ما يلي:
- قراءة وإدارة جهات اتصال المستخدم الذي تمت المصادقة عليه
- قراءة ونسخ "جهات الاتصال الأخرى" للمستخدم الذي تمت المصادقة عليه
- الاطّلاع على معلومات الملف الشخصي للمستخدمين الذين تمت مصادقتهم وجهات اتصالهم
- قراءة جهات الاتصال والملفات الشخصية في النطاق
على سبيل المثال، افترض أن المستخدم الذي تمت المصادقة عليه، جين، لديه فابيان ورانجيث في جهات اتصالها الخاصة. عندما يطلب تطبيقك الرمز people.connections.list لقراءة قائمة الاتصال الخاصة بها، تظهر لجين على شاشة طلب الموافقة تطلب منها منح التطبيق إذن الوصول إلى القائمة. إذا وافقت "جين" على الطلب، يقرأ التطبيق قائمة تتضمّن person resources لكل من "فابيان" و"رانجيث".
إذا كان التطبيق بحاجة إلى معلومات عن شخص معيّن، يمكنه حينئذٍ الاتصال بـ
people.get، مع إدخال اسم المورد، للحصول على
person resource لهذا الشخص.
يمكن للتطبيق أيضًا إدارة جهات الاتصال من خلال إنشاء جهات اتصال جديدة باستخدام people.createContact وتعديل جهات الاتصال الحالية التي قرأ منها people.connections.list باستخدام people.updateContact وحذف جهات الاتصال باستخدام people.deleteContact.
يمكن لمستخدمي Google Workspace أيضًا إدراج الملفات الشخصية في نطاق الدليل وجهات اتصال النطاق
باستخدام
people.listDirectoryPeople أو البحث
عنها باستخدام
people.searchDirectoryPeople.
عرض مُدمَج لمعلومات الأشخاص
يتم دمج معلومات الأشخاص التي تقرأها واجهة برمجة التطبيقات لتطبيق People API من مصادر مختلفة، استنادًا إلى الشروط التالية:
| المصدر | الشرط |
|---|---|
| بيانات الملف الشخصي العام في 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. |
يمكن تعديل الأشخاص المستندين إلى جهة الاتصال فقط من خلال نقاط نهاية التحويل. لا يتم توفير عمليات تغيير جهات اتصال الملف الشخصي والنطاق.