Memberikan daftar kontak di kontak pengguna lain yang diautentikasi yang cocok dengan kueri penelusuran. Kueri cocok pada kolom names
, emailAddresses
, dan phoneNumbers
kontak yang berasal dari sumber OTHER_CONTACT
.
PENTING: Sebelum melakukan penelusuran, klien harus mengirimkan permintaan pemanasan dengan kueri kosong untuk memperbarui cache. Lihat https://developers.google.com/people/v1/other-contacts#search_the_users_other_contacts
Permintaan HTTP
GET https://people.googleapis.com/v1/otherContacts:search
URL menggunakan sintaksis gRPC Transcoding.
Parameter kueri
Parameter | |
---|---|
query |
Wajib diisi. Kueri teks biasa untuk permintaan. Kueri digunakan untuk mencocokkan frasa awalan kolom pada seseorang. Misalnya, seseorang dengan nama "nama foo" cocok dengan kueri seperti "f", "fo", "foo", "foo n", "nam", dll., tetapi tidak "oo n". |
pageSize |
Opsional. Jumlah hasil yang akan ditampilkan. Jika tidak ditetapkan, ditetapkan ke 10 atau ditetapkan ke 0. Nilai yang lebih besar dari 30 akan dibatasi hingga 30. |
readMask |
Wajib diisi. Mask kolom untuk membatasi kolom mana pada setiap orang yang ditampilkan. Beberapa kolom dapat ditentukan dengan memisahkannya dengan koma. Nilai yang valid adalah:
|
Isi permintaan
Isi permintaan harus kosong.
Isi respons
Jika berhasil, isi respons memuat instance SearchResponse
.
Cakupan Otorisasi
Memerlukan cakupan OAuth berikut ini:
https://www.googleapis.com/auth/contacts.other.readonly
Untuk mendapatkan informasi lebih lanjut, lihat Panduan otorisasi.