- Richiesta HTTP
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Prova!
Fornisce un elenco dei contatti negli altri contatti dell'utente autenticato che corrispondono alla query di ricerca. La query corrisponde ai campi names
, emailAddresses
e phoneNumbers
di un contatto provenienti dall'origine OTHER_CONTACT
.
IMPORTANTE: prima di cercare, i client devono inviare una richiesta di riscaldamento con una query vuota per aggiornare la cache. Consulta la pagina https://developers.google.com/people/v1/other-contacts#search_the_users_other_contacts
Richiesta HTTP
GET https://people.googleapis.com/v1/otherContacts:search
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri di ricerca
Parametri | |
---|---|
query |
obbligatorio. La query in testo normale per la richiesta. La query viene utilizzata per trovare corrispondenze tra le frasi di prefisso dei campi di una persona. Ad esempio, una persona con il nome "nome foo" corrisponde a query come "f", "fo", "foo", "foo n", "nam" ecc., ma non "oo n". |
pageSize |
Campo facoltativo. Il numero di risultati da restituire. Il valore predefinito è 10 se il campo non è impostato oppure viene impostato su 0. I valori superiori a 30 verranno limitati a 30. |
readMask |
obbligatorio. Una maschera di campo per limitare i campi restituiti per ogni persona. È possibile specificare più campi separandoli con virgole. I valori validi sono:
|
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di SearchResponse
.
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/contacts.other.readonly
Per ulteriori informazioni, consulta la guida all'autorizzazione.