Method: otherContacts.search

Menyediakan daftar kontak di kontak lain pengguna terautentikasi yang cocok dengan kueri penelusuran. Kueri cocok dengan kolom names, emailAddresses, dan phoneNumbers kontak yang berasal dari sumber OTHER_CONTACT.

PENTING: Sebelum melakukan penelusuran, klien harus mengirim 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

string

Wajib. Kueri teks biasa untuk permintaan. Kueri digunakan untuk mencocokkan frasa awalan kolom pada seseorang. Misalnya, seseorang dengan nama "foo name" cocok dengan kueri seperti "f", "fo", "foo", "foo n", "nam", dll., tetapi bukan "oo n".
pageSize

integer

Opsional. Jumlah hasil yang akan ditampilkan. Default-nya adalah 10 jika kolom tidak disetel, atau disetel ke 0. Nilai yang lebih besar dari 30 akan dibatasi hingga 30.
readMask

string (FieldMask format)

Wajib. Mask kolom untuk membatasi kolom mana pada setiap orang yang ditampilkan. Beberapa kolom dapat ditentukan dengan memisahkannya menggunakan koma. Nilai yang valid adalah:

  • emailAddresses
  • metadata
  • names
  • phoneNumbers

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons akan berisi instance SearchResponse.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Panduan otorisasi.