Method: otherContacts.search

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

string

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

integer

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

string (FieldMask format)

obbligatorio. Una maschera di campo per limitare i campi restituiti per ogni persona. È possibile specificare più campi separandoli con virgole. I valori validi sono:

  • emailAddresses
  • metadati
  • names
  • phoneNumbers

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.