توفّر هذه السياسة قائمة بجهات الاتصال في جهات الاتصال الأخرى للمستخدم الذي تمت المصادقة عليه والتي تتطابق مع طلب البحث. يتطابق طلب البحث مع الحقول names وemailAddresses وphoneNumbers لجهة الاتصال الواردة من المصدر OTHER_CONTACT.
ملاحظة مُهمة: قبل إجراء البحث، على العملاء إرسال طلب إعادة توجيه يتضمّن استعلامًا فارغًا لتعديل ذاكرة التخزين المؤقت. يمكنك الاطّلاع على https://developers.google.com/people/v1/other-contacts#search_the_users_other_contacts
طلب HTTP
GET https://people.googleapis.com/v1/otherContacts:search
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات طلب البحث
| المَعلمات | |
|---|---|
query |
مطلوبة. طلب البحث بالنص العادي للطلب. يتم استخدام طلب البحث لمطابقة العبارات البادئة في الحقول الخاصة بالشخص. على سبيل المثال، يتطابق مستخدم الاسم "foo name" مع طلبات البحث مثل "f" أو "fo" أو "foo" أو "foo n" أو "nam" وما إلى ذلك، ولكن ليس "oo n". |
pageSize |
اختياريّ. عدد النتائج المطلوب عرضها. يتم ضبط القيمة على 10 تلقائيًا في حال عدم ضبط الحقل، أو يتم ضبطها على 0. سيتم تحديد القيم الأكبر من 30 لتصبح 30. |
readMask |
مطلوبة. قناع حقل لتقييد الحقول التي يتم عرضها لكل مستخدم يمكن تحديد عدة حقول من خلال الفصل بينها بفواصل. القيم الصالحة هي:
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال SearchResponse.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/contacts.other.readonly
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.