ملاحظة مهمّة: يجب نقل نصوصك البرمجية من خدمة "جهات الاتصال" إلى الخدمة المتقدّمة لواجهة People API قبل إيقاف لغة "برمجة تطبيقات Google" لخدمة "جهات الاتصال" في آذار (مارس) 2023.
أوقفت "برمجة التطبيقات" خدمة "جهات الاتصال" نهائيًا في 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()
في خدمة جهات الاتصال.