ملاحظة مهمة: يجب نقل نصوصك البرمجية من خدمة "جهات الاتصال" إلى الخدمة المتقدّمة في People API قبل أن توقِف "برمجة التطبيقات" خدمة "جهات اتصال Google" في آذار (مارس) 2023.
تم إيقاف خدمة "جهات اتصال Google" نهائيًا من خلال "برمجة تطبيقات Google" في 16 كانون الأول (ديسمبر) 2022. بدلاً من ذلك، يمكنك استخدام خدمة People API المتقدمة تستخدم People API بروتوكول JSON أحدث وتوفر ميزات متقدمة، مثل دمج جهات الاتصال مع الملفات الشخصية.
يمكنك استخدام هذا الدليل لمعرفة طرق خدمة جهات الاتصال التي ليس لها مكافئ في خدمة People API المتقدمة، والتعرُّف على الطرق التي يمكنك استخدامها بدلاً من ذلك، والعثور على نماذج الرموز لنقل المهام الشائعة. للمزيد من المعلومات، يمكنك الرجوع إلى دليل نقل واجهة برمجة تطبيقات جهات الاتصال.
الطُرق التي لا تتضمّن مكافئات لواجهة People API
تعرض القائمة التالية طُرق getContacts
في خدمة "جهات الاتصال" التي لا تعادل طرقًا مماثلة للبحث عن جهات الاتصال في الخدمة المتقدِّمة في People API. باستخدام الخدمة المتقدّمة في People API، يمكنك البحث حسب الحقول names
وnickNames
وemailAddresses
وphoneNumbers
وorganizations
لجهة الاتصال الواردة من المصدر CONTACT
.
الطرق بدون مكافئات |
---|
|
في ما يلي طُرق getContacts
من خدمة "جهات الاتصال" التي تستخدم مَعلمة label
إضافية. يمكنك استخدام searchContacts
من خدمة People API المتقدمة للحصول على جهات الاتصال حسب الحقل المكافئ، ولكن لا يمكنك حصر البحث بتصنيف معيّن.
الطرق ذات المكافئات الجزئية |
---|
|
الميزات الإضافية المتوفّرة في تطبيق People API
عند النقل إلى خدمة People API المتقدمة، يمكنك الوصول إلى ميزات People API التالية غير المتوفّرة في خدمة جهات الاتصال:
- تحديد مصدر البيانات: عند البحث عن معلومات حول أحد الأشخاص، يمكنك تحديد مكان البحث، مثل جهة اتصال في Google أو ملف شخصي في Google.
- البحث عن مستخدمين حسب سلسلة طلب بحث: يمكنك الحصول على قائمة بالملفات الشخصية وجهات الاتصال التي تتطابق مع سلسلة معيّنة.
- الطلبات المجمّعة: يمكنك تجميع طلبات البيانات من People API بشكل مجمّع للمساعدة في تقليل وقت تنفيذ النص البرمجي.
عيّنات التعليمات البرمجية للمهام الشائعة
يسرد هذا القسم المهام الشائعة من خدمة جهات الاتصال. توضح نماذج التعليمات البرمجية كيفية إنشاء المهام باستخدام الخدمة المتقدمة لـ People API.
الحصول على مجموعة جهات اتصال حسب الاسم
يعرض نموذج الرمز البرمجي التالي كيفية الحصول على مجموعة جهات اتصال باسمها، الذي يوازي getContactGroup(name)
في خدمة جهات الاتصال.
الحصول على جهة اتصال عبر عنوان البريد الإلكتروني
يعرض نموذج الرمز البرمجي التالي كيفية الحصول على جهة اتصال باستخدام عنوان البريد الإلكتروني، وهو ما يعادل getContact(emailAddress)
في خدمة جهات الاتصال.
الحصول على جميع جهات الاتصال
يعرض نموذج الرمز البرمجي التالي كيفية الحصول على جميع جهات اتصال المستخدم، وهو ما يعادل getContacts()
في خدمة جهات الاتصال.
الحصول على الاسم الكامل لجهة الاتصال
يعرض نموذج الرمز البرمجي التالي كيفية الحصول على الاسم الكامل لجهة الاتصال، وهو ما يعادل getFullName()
في خدمة جهات الاتصال.
الحصول على جميع أرقام الهواتف لجهة اتصال
يعرض نموذج الرمز التالي كيفية الحصول على جميع أرقام الهواتف لجهة اتصال، والتي تعادل getPhones()
في خدمة جهات الاتصال.
الحصول على رقم هاتف محدّد لجهة اتصال
يعرض نموذج الرمز البرمجي التالي كيفية الحصول على رقم هاتف معيّن لجهة اتصال، وهو ما يعادل getPhoneNumber()
في خدمة جهات الاتصال.