Method: otherContacts.search

Proporciona una lista de los contactos de los otros contactos del usuario autenticado que coinciden con la consulta de búsqueda. La consulta coincide con los campos names, emailAddresses y phoneNumbers de un contacto que provienen de la fuente OTHER_CONTACT.

IMPORTANTE: Antes de realizar la búsqueda, los clientes deben enviar una solicitud de preparación con una consulta vacía para actualizar la caché. Consulta https://developers.google.com/people/v1/other-contacts#search_the_users_other_contacts

Solicitud HTTP

GET https://people.googleapis.com/v1/otherContacts:search

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de consulta

Parámetros
query

string

Obligatorio. La consulta de texto sin formato para la solicitud. La consulta se usa para hacer coincidir las frases de prefijo de los campos en una persona. Por ejemplo, una persona con el nombre "foo name" coincide con búsquedas como "f", "fo", "foo", "foo n", "nam", etc., pero no "oo n".
pageSize

integer

Opcional. La cantidad de resultados que se mostrarán. La configuración predeterminada es 10 si el campo no está configurado o es 0. Los valores superiores a 30 se limitarán a 30.
readMask

string (FieldMask format)

Obligatorio. Una máscara de campo que restringe los campos que se muestran en cada persona. Se pueden especificar varios campos separándolos con comas. A continuación, se indican los valores válidos:

  • Direcciones de correo electrónico
  • metadata
  • names
  • númerosdeteléfono

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de SearchResponse.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta la guía de autorización.