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

تتوافق واجهة برمجة التطبيقات لجهات الاتصال المشتركة في النطاق مع معلمات طلبات البحث القياسية التالية في 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.