Method: otherContacts.search

توفّر هذه السياسة قائمة بجهات الاتصال في جهات الاتصال الأخرى للمستخدم الذي تمت المصادقة عليه والتي تتطابق مع طلب البحث. يتطابق طلب البحث مع الحقول 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

string

مطلوبة. طلب البحث بالنص العادي للطلب. يتم استخدام طلب البحث لمطابقة العبارات البادئة في الحقول الخاصة بالشخص. على سبيل المثال، يتطابق مستخدم الاسم "foo name" مع طلبات البحث مثل "f" أو "fo" أو "foo" أو "foo n" أو "nam" وما إلى ذلك، ولكن ليس "oo n".

pageSize

integer

اختياريّ. عدد النتائج المطلوب عرضها. يتم ضبط القيمة على 10 تلقائيًا في حال عدم ضبط الحقل، أو يتم ضبطها على 0. سيتم تحديد القيم الأكبر من 30 لتصبح 30.

readMask

string (FieldMask format)

مطلوبة. قناع حقل لتقييد الحقول التي يتم عرضها لكل مستخدم يمكن تحديد عدة حقول من خلال الفصل بينها بفواصل. القيم الصالحة هي:

  • emailAddresses
  • البيانات الوصفية
  • names
  • phoneNumbers

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال SearchResponse.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/contacts.other.readonly

لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.