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