تم إيقاف واجهة برمجة التطبيقات Contacts API في 19 كانون الثاني (يناير) 2022. يمكنك استخدام هذا الدليل للتعرّف على التغييرات التي تطرأ على الحقول ونقاط النهاية ونطاقات التفويض أثناء نقل البيانات إلى People API.
نظرة عامة
تؤدي واجهة People API الوظيفة نفسها التي توفّرها واجهة Contacts API القديمة لجميع الميزات، باستثناء ما يلي بالنسبة إلى جهات الاتصال الأخرى:
لدى المشرفين أذونات للقراءة فقط في "جهات الاتصال الأخرى" من خلال النطاق الجديد. نظرًا لعدم إمكانية إرسال إشارات التبديل أو الكتابة إلى "جهات الاتصال الأخرى" مرة أخرى، سيتعين على المستخدمين إضافة جهة الاتصال الأخرى كجهة اتصال إذا أرادوا تعديل حقول البيانات الخاصة بها.
يمكن قراءة معلومات جهة الاتصال الأساسية فقط لـ "جهات الاتصال الأخرى" من خلال واجهة برمجة التطبيقات. على سبيل المثال، الاسم الكامل وعنوان البريد الإلكتروني ورقم الهاتف.
بالإضافة إلى ذلك، تم استبدال نطاق "جهات اتصال Google" القديم (https://www.google.com/m8/feeds)، الذي
كان يتيح الوصول إلى كل من جهات الاتصال الشخصية ومعلومات الدليل،
بالنطاقات التالية:
- للوصول إلى جهات الاتصال الشخصية:
https://www.googleapis.com/auth/contacts - للوصول إلى معلومات الدليل:
https://www.googleapis.com/auth/directory.readonly
جهات الاتصال
ربط الحقول
| حقل جهة الاتصال | حقل الأشخاص |
|---|---|
| atom:content | السِير الذاتية |
| Atom:link rel='http://schemas.google.com/contacts/2008/rel#photo' | صور |
| atom:title | names |
| gContact:billingInformation | miscKeywords (type=OUTLOOK_BILLING_INFORMATION) |
| gContact:عيد الميلاد | أعياد الميلاد |
| gContact:calendarLink | calendarUrls |
| gContact:directoryServer | misc keywords (type=OUTLOOK_DIRECTORY_SERVER) |
| gContact:event | الأحداث |
| gContact:extendedProperty | clientData |
| gContact:externalId | externalIds |
| gContact:fileAs | fileAses |
| gContact:gender | genders |
| gContact:groupMembershipInfo | memberships.contactGroupMembership |
| gContact:هواية | الاهتمامات |
| gContact:الأحرف الأولى | الألقاب (type=INITIALS) غير مفعَّلة |
| gContact:jot type='home' | الكلمات الرئيسية Misc (type=Home) |
| gContact:jot type='keyword' | misc keywords (type=OUTLOOK_keyword) |
| gContact:jot type='other' | misc keywords (type=OTHER) |
| gContact:jot type='user' | miscKeywords (type=OUTLOOK_USER) |
| gContact:jot type='work' | الكلمات الرئيسية الخاطئة (type=WORK) |
| gContact:language | اللغات |
| gContact:maidenName | الألقاب (type=MAIDEN_NAME) غير مفعَّلة |
| gContact:mileage | كلمات رئيسية خاطئة (type=OUTLOOK_MILEAGE) |
| gContact:nickname | nicknames (type=DEFAULT) |
| gContact:المهنة | المهن |
| gContact:الأولوية | الكلمات الرئيسية الخاطئة (type=OUTLOOK_PRIORITY) |
| gContact:العلاقة | العلاقات |
| gContact:الحساسية | الكلمات الرئيسية الخاطئة (type=OUTLOOK_SENSITIVITY) |
| gContact:shortName | الألقاب (type=SHORT_NAME) المتوقّفة |
| gContact:subject | الكلمات الرئيسية الخاطئة (type=OUTLOOK_SUBJECT) |
| gContact:userSelecteddField | userDefined |
| gContact:الموقع الإلكتروني | urls |
| gContact:yomiName | names.phonetic_full_name |
| gd:delete | metadata.deleted |
| gd:email | emailAddresses |
| gd:im | imClients |
| gd:مؤسسة | organizations |
| gd:phoneNumber | phoneNumbers |
| gd:postalAddress | addresses.formattedValue |
| gd:أين | المساكن |
| gd:structuredPostalAddress | العناوين |
نقاط نهاية جهات الاتصال الشخصية
مقروءة
يجب استخدام نطاق https://www.googleapis.com/auth/contacts أو نطاق واحد (https://www.googleapis.com/auth/contacts.readonly).
- قراءة جهة اتصال واحدة محدّدة
people.get - قراءة عدة جهات اتصال محدَّدة
people.getBatchGet - قراءة جهات الاتصال باستخدام
people.connections.list
تغيير
يجب استخدام نطاق واحد (https://www.googleapis.com/auth/contacts). يغير جميع حقول جهات
الاتصال باستثناء الصور.
- إنشاء جهة اتصال باستخدام
people.createContact - تعديل جهة اتصال
حالية باستخدام
people.updateContact - حذف جهة اتصال
باستخدام
people.deleteContact.
تبديل الصورة
يجب استخدام نطاق واحد (https://www.googleapis.com/auth/contacts).
- يمكنك تعديل صورة جهة الاتصال باستخدام
people.updateContactPhoto. - حذف صورة جهة اتصال باستخدام
people.deleteContactPhoto
نقاط نهاية جهات الاتصال الأخرى
مقروءة
جهات الاتصال الأخرى للقراءة فقط ولا يتم عرض سوى حقول names وemailAddresses وphoneNumbers.
يجب استخدام نطاق واحد (https://www.googleapis.com/auth/contacts.other.readonly).
- قراءة جهات الاتصال الأخرى باستخدام
otherContacts.list.
نسخ
يجب توفّر https://www.googleapis.com/auth/contacts.other.readonly وhttps://www.googleapis.com/auth/contacts نطاق.
- نسخ جهات الاتصال الأخرى باستخدام
otherContacts.copyOtherContactToMyContactsGroup
نقاط نهاية قائمة العناوين العامة
يجب استخدام نطاق واحد (https://www.googleapis.com/auth/directory.readonly).
- إدراج جميع الملفات الشخصية وجهات الاتصال للدليل
people.listDirectoryPeople. - البحث في جهات الاتصال والملفات الشخصية للدليل
people.searchDirectoryPeople.
مجموعات جهات الاتصال
ربط الحقول
| حقل مجموعة جهات اتصال في واجهة برمجة تطبيقات جهات الاتصال | حقل مجموعة جهات اتصال واجهة برمجة تطبيقات الأشخاص |
|---|---|
| Atom:معدَّل | metadata.updateTime |
| atom:title | name |
| atom:content | name |
| gd:delete | metadata.deleted |
| systemGroup | groupType=SYSTEM_CONTACT_GROUP |
نقاط النهاية
مقروءة
يجب استخدام نطاق https://www.googleapis.com/auth/contacts أو نطاق واحد (https://www.googleapis.com/auth/contacts.readonly).
- الحصول على مجموعة جهات اتصال محددة باستخدام
people.contactGroups.get - إدراج مجموعات جهات الاتصال باستخدام
people.contactGroups.list
تغيير
يجب استخدام نطاق واحد (https://www.googleapis.com/auth/contacts).
- إنشاء مجموعة جهات اتصال باستخدام
people.contactGroups.create - تعديل مجموعة جهات اتصال باستخدام
people.contactGroups.update - حذف مجموعة جهات اتصال باستخدام
people.contactGroups.delete إضافة جهات اتصال أو إزالتها من مجموعة جهات الاتصال باستخدام
people.contactGroups.members.modify
نطاقات التفويض
النطاق القديم https://www.google.com/m8/feeds هو اسم مستعار للنطاق https://www.googleapis.com/auth/contacts. يعني هذا أنّ عمليات منح بروتوكول OAuth الحالية باستخدام النطاق القديم ستعمل مع أي نقاط نهاية في People API تتطلّب نطاق https://www.googleapis.com/auth/contacts. ستعمل قراءة جهات الاتصال ومجموعات جهات الاتصال وكتابتها باستخدام النطاق القديم.
تتطلّب واجهة برمجة تطبيقات "الأشخاص" نطاقات جديدة للوصول إلى بيانات "جهات الاتصال الأخرى" أو بيانات الدليل. اطّلِع على التفاصيل أعلاه لمعرفة النطاقات المطلوبة.
لمزيد من التفاصيل، يُرجى الاطّلاع على السماح بالطلبات.
مكتبات العملاء
- بالنسبة إلى "برمجة التطبيقات"، يُرجى الاطّلاع على خدمة الأشخاص المتقدّمين.
- للتعرف على اللغات الأخرى المتاحة، راجع تثبيت مكتبات العملاء.