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)

Необходимый. Маска поля для ограничения возвращаемых полей для каждого человека. Можно указать несколько полей, разделив их запятыми. Допустимые значения:

  • адрес электронной почты
  • метаданные
  • имена
  • телефонные номера

Тело запроса

Тело запроса должно быть пустым.

Тело ответа

В случае успеха тело ответа содержит экземпляр SearchResponse .

Области авторизации

Требуется следующая область действия OAuth:

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

Дополнительные сведения см. в руководстве по авторизации .