- Solicitação HTTP
- Parâmetros de consulta
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- Faça um teste
Fornece uma lista de contatos nos outros contatos do usuário autenticado que correspondem à consulta de pesquisa. A consulta corresponde aos campos names, emailAddresses e phoneNumbers de um contato que são da fonte OTHER_CONTACT.
IMPORTANTE: antes da pesquisa, os clientes devem enviar uma solicitação de aquecimento com uma consulta vazia para atualizar o cache. Consulte https://developers.google.com/people/v1/other-contacts#search_the_users_other_contacts.
Solicitação HTTP
GET https://people.googleapis.com/v1/otherContacts:search
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de consulta
| Parâmetros | |
|---|---|
query |
Obrigatório. A consulta de texto simples para a solicitação. A consulta é usada para corresponder frases de prefixo dos campos em uma pessoa. Por exemplo, uma pessoa com o nome "foo name" corresponde a consultas como "f", "fo", "foo", "foo n", "nam" etc., mas não a "oo n". |
pageSize |
Opcional. O número de resultados a serem retornados. O padrão será 10 se o campo não estiver definido ou será definido como 0. Valores superiores a 30 serão limitados a 30. |
readMask |
Obrigatório. Uma máscara de campo para restringir quais campos de cada pessoa são retornados. É possível especificar vários campos separados por vírgulas. Os valores válidos são:
|
Corpo da solicitação
O corpo da solicitação precisa estar vazio.
Corpo da resposta
Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de SearchResponse.
Escopos de autorização
Requer o seguinte escopo OAuth:
https://www.googleapis.com/auth/contacts.other.readonly
Para mais informações, consulte o Guia de autorização.