People API

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

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

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

مستند "اقتراحات"

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

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

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

  • 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

قم بإنشاء دفعة من جهات الاتصال الجديدة وعرض إجابات الأشخاص

يجب إرسال طلبات التبديل للمستخدم نفسه بشكل تسلسلي لتجنُّب زيادة وقت الاستجابة وعمليات الإخفاق.

batchDeleteContacts POST /v1/people:batchDeleteContacts
احذِف مجموعة من جهات الاتصال.
batchUpdateContacts POST /v1/people:batchUpdateContacts
يمكنك تحديث مجموعة من جهات الاتصال وعرض خريطة لأسماء الموارد إلى PeopleResponses لجهات الاتصال التي تم تعديلها.
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
يتم توفير قائمة بجهات اتصال المستخدم الذي تمت مصادقته.