Method: otherContacts.search

Proporciona una lista de contactos en los otros contactos del usuario autenticado que coincide con la búsqueda. La consulta coincide con los campos names, emailAddresses y phoneNumbers de un contacto que son 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. Consulta de texto sin formato para la solicitud. La consulta se usa para hacer coincidir frases de prefijo de los campos de una persona. Por ejemplo, una persona con el nombre “foo name” coincide con consultas como “f”, “fo”, “foo”, “foo n”, “nam”, etc., pero no con “oo n”.
pageSize

integer

Opcional. La cantidad de resultados que se mostrarán. El valor predeterminado es 10 si el campo no está configurado, o bien se establece en 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 de cada persona. Se pueden especificar varios campos separándolos con comas. Estos son los valores válidos:

  • emailAddresses
  • metadatos
  • names
  • phoneNumbers

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.