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

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