مقدمة

تتيح لك واجهة برمجة التطبيقات لتطبيق الأشخاص ما يلي:

  • قراءة جهات اتصال المستخدم الذي تمت المصادقة عليه وإدارتها
  • قراءة "جهات الاتصال الأخرى" للمستخدم الذي تمت مصادقته ونسخه
  • قراءة معلومات الملف الشخصي للمستخدمين الذين تمت مصادقتهم وجهات اتصالهم
  • قراءة الملفات الشخصية للنطاق وجهات الاتصال

على سبيل المثال، لنفترض أن المستخدم الذي تمت المصادقة عليه، يوسف، لديه فابيان ورانجيث في جهات اتصاله الخاصة. عندما يتصل تطبيقك 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.

يمكن تعديل الأشخاص المستندين إلى جهات الاتصال فقط من خلال نقاط نهاية التغيير. لا يتم دعم طفرات جهات اتصال الملف الشخصي والنطاق.