People API

يوفر الدخول إلى معلومات حول الملفات الشخصية وجهات الاتصال.

الخدمة: people.googleapis.com

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

مستند Discovery

مستند أثناء التصفّح هو مواصفات يستطيع الجهاز قراءتها لوصف واجهات برمجة تطبيقات REST واستخدامها. ويتم استخدامه لإنشاء مكتبات العملاء ومكونات IDE الإضافية والأدوات الأخرى التي تتفاعل مع Google APIs. وقد توفّر خدمة واحدة مستندات اكتشاف متعددة. توفر هذه الخدمة مستند الاكتشاف التالي:

نقطة نهاية الخدمة

نقطة نهاية الخدمة هي عنوان URL أساسي يحدّد عنوان الشبكة لخدمة واجهة برمجة تطبيقات. قد تتضمن خدمة واحدة نقاط نهاية متعددة للخدمة. تتضمن هذه الخدمة نقطة نهاية الخدمة التالية وجميع عناوين URL الواردة أدناه ذات صلة بنقطة نهاية الخدمة هذه:

  • https://people.googleapis.com

مورد REST: v1.contactGroups

الطُرق
batchGet GET /v1/contactGroups:batchGet
يمكنك الحصول على قائمة بمجموعات جهات الاتصال التي يملكها المستخدم الذي تمت مصادقته من خلال تحديد قائمة بأسماء موارد مجموعات جهات الاتصال.
create POST /v1/contactGroups
أنشئ مجموعة جهات اتصال جديدة يملكها المستخدم الذي تمت المصادقة عليه.
delete DELETE /v1/{resourceName=contactGroups/*}
يمكنك حذف مجموعة جهات اتصال حالية يملكها المستخدم الذي تمت مصادقته من خلال تحديد اسم مورد لمجموعة جهات الاتصال.
get GET /v1/{resourceName=contactGroups/*}
يمكنك الحصول على مجموعة جهات اتصال محدّدة يملكها المستخدم الذي تمت مصادقته من خلال تحديد اسم مورد مجموعة جهات الاتصال.
list GET /v1/contactGroups
يمكنك إدراج جميع مجموعات جهات الاتصال التي يملكها المستخدم الذي تمت مصادقته.
update PUT /v1/{contactGroup.resourceName=contactGroups/*}
يمكنك تعديل اسم مجموعة جهات اتصال حالية يملكها المستخدم الذي تمت المصادقة عليه.

مورد REST: v1.contactGroups.members

الطُرق
modify POST /v1/{resourceName=contactGroups/*}/members:modify
عدِّل أعضاء مجموعة جهات الاتصال التي يملكها المستخدم الذي تمت المصادقة عليه.

مورد REST: v1.otherContacts

الطُرق
copyOtherContactToMyContactsGroup POST /v1/{resourceName=otherContacts/*}:copyOtherContactToMyContactsGroup

نسخ "جهة اتصال أخرى" إلى جهة اتصال جديدة في مجموعة "myContacts" للمستخدم

يجب إرسال طلبات التبديل للمستخدم نفسه بالتتابع لتجنب زيادة وقت الاستجابة والإخفاقات.
list GET /v1/otherContacts
يمكنك إدراج جميع "جهات الاتصال الأخرى"، وهي جهات الاتصال غير المُدرَجة في مجموعة جهات الاتصال.
search GET /v1/otherContacts:search
تقدم قائمة بجهات الاتصال في جهات الاتصال الأخرى للمستخدم الذي تمت المصادقة عليه والتي تتطابق مع طلب البحث.

مورد REST: v1.people

الطُرق
batchCreateContacts POST /v1/people:batchCreateContacts

إنشاء مجموعة من جهات الاتصال الجديدة وعرض PersonResponses لطلب البحث

يجب إرسال طلبات التبديل للمستخدم نفسه بالتتابع لتجنب زيادة وقت الاستجابة والإخفاقات.
batchDeleteContacts POST /v1/people:batchDeleteContacts
يمكنك حذف مجموعة من جهات الاتصال.
batchUpdateContacts POST /v1/people:batchUpdateContacts
عدِّل مجموعة من جهات الاتصال واعرض خريطة بأسماء الموارد على PersonResponses لجهات الاتصال المحدَّثة.
createContact POST /v1/people:createContact
أنشئ جهة اتصال جديدة وارجع مورد الشخص إلى جهة الاتصال هذه.
deleteContact DELETE /v1/{resourceName=people/*}:deleteContact
حذف جهة اتصال.
deleteContactPhoto DELETE /v1/{resourceName=people/*}:deleteContactPhoto
حذف صورة جهة اتصال
get GET /v1/{resourceName=people/*}
تقدم معلومات عن شخص من خلال تحديد اسم مورد.
getBatchGet GET /v1/people:batchGet
تقدِّم معلومات عن قائمة مستخدمين محدَّدين من خلال تحديد قائمة بأسماء الموارد المطلوبة.
listDirectoryPeople GET /v1/people:listDirectoryPeople
يقدم قائمة بالملفات الشخصية للنطاق وجهات اتصال النطاق في دليل نطاق المستخدم الذي تمت المصادقة عليه.
searchContacts GET /v1/people:searchContacts
تُقدِّم قائمة بجهات الاتصال في جهات الاتصال المجمَّعة للمستخدم الذي تمت المصادقة عليه والتي تتطابق مع طلب البحث.
searchDirectoryPeople GET /v1/people:searchDirectoryPeople
تُقدِّم قائمة بالملفات الشخصية على النطاق وجهات اتصال النطاق في دليل نطاق المستخدم الذي تمت مصادقته والتي تتطابق مع طلب البحث.
updateContact PATCH /v1/{person.resourceName=people/*}:updateContact
يمكنك تعديل بيانات جهة الاتصال لجهة اتصال حالية.
updateContactPhoto PATCH /v1/{resourceName=people/*}:updateContactPhoto
تعديل صورة جهة اتصال

مورد REST: v1.people.connections

الطُرق
list GET /v1/{resourceName=people/*}/connections
يقدم قائمة بجهات اتصال المستخدم الذي تمت المصادقة عليه.