مَعلمات طلب البحث في جهات الاتصال

تتوافق واجهة برمجة التطبيقات "جهات الاتصال المشتركة في النطاق" مع مَعلمات طلب البحث العادية التالية في Google Data API:

الاسم الوصف
alt نوع الخلاصة المطلوب عرضها، مثل atom (تلقائي) rss أو json
max-results الحد الأقصى لعدد الإدخالات التي سيتم عرضها إذا كنت تريد تلقّي كل جهات الاتصال بدلاً من الحد الأقصى التلقائي فقط، يمكنك تحديد رقم كبير لسمة max-results.
start-index الفهرس الذي يبدأ من 1 للنتيجة الأولى المطلوب استرجاعها (لصفحة البيانات).
updated-min الحدّ الأدنى لتواريخ تعديل الإدخالات.

لمزيد من المعلومات عن المَعلمات العادية، يُرجى الاطّلاع على مرجع بروتوكول Google Data APIs.

بالإضافة إلى مَعلمات طلب البحث العادية، تتيح واجهة برمجة التطبيقات Domain Shared Contacts API استخدام المَعلمات التالية:

الاسم الوصف
orderby معايير الترتيب والقيمة الوحيدة المسموح بها هي lastmodified.
showdeleted

تضمين جهات الاتصال المحذوفة في خلاصة جهات الاتصال التي يتم عرضها القيم الصالحة هي true أو false. تظهر جهات الاتصال المشترَكة التي تم حذفها كإدخالات لا تحتوي إلا على عنصر <atom:id> وعنصر <gd:deleted>.

تحتفظ Google بعناصر نائبة لجهات الاتصال المشتركة المحذوفة لمدة 30 يومًا بعد الحذف. خلال هذه الفترة، يمكنك طلب العناصر النائبة باستخدام مَعلمة طلب البحث showdeleted.

sortorder اتجاه ترتيب العناصر يمكن أن يكون إما ascending أو descending.