- Richiesta HTTP
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Prova!
Elenca tutti gli "Altri contatti", ovvero i contatti che non fanno parte di un gruppo di contatti. "Altri contatti" sono generalmente contatti creati automaticamente dalle interazioni.
I token di sincronizzazione scadono 7 giorni dopo la sincronizzazione completa. Una richiesta con token di sincronizzazione scaduto riceverà un errore google.rpc.ErrorInfo con motivo "EXPIRED_SYNC_TOKEN". In questo caso, i client devono effettuare una richiesta di sincronizzazione completa senza
.syncToken
La prima pagina di una richiesta di sincronizzazione completa ha una quota aggiuntiva. Se la quota viene superata, verrà restituito un errore 429. Questa quota è fissa e non può essere aumentata.
Se viene specificato il valore
, le risorse eliminate dall'ultima sincronizzazione verranno restituite come persona con syncToken
impostato su true.PersonMetadata.deleted
Quando viene specificato
o pageToken
, tutti gli altri parametri della richiesta devono corrispondere alla prima chiamata.syncToken
Le scritture potrebbero avere un ritardo di propagazione di diversi minuti per le richieste di sincronizzazione. Le sincronizzazioni incrementali non sono destinate a casi d'uso di lettura dopo scrittura.
Consulta un esempio di utilizzo in Elencare gli altri contatti dell'utente che sono cambiati.
Richiesta HTTP
GET https://people.googleapis.com/v1/otherContacts
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri di query
Parametri | |
---|---|
pageToken |
(Facoltativo) Un token di pagina, ricevuto da una risposta precedente Durante l'impaginazione, tutti gli altri parametri forniti a |
pageSize |
(Facoltativo) Il numero di "Altri contatti" da includere nella risposta. I valori validi sono compresi tra 1 e 1000 inclusi. Il valore predefinito è 100 se non viene configurato o se viene impostato su 0. |
requestSyncToken |
(Facoltativo) Indica se la risposta deve restituire Ulteriori dettagli sul comportamento di sincronizzazione all'indirizzo |
syncToken |
(Facoltativo) Un token di sincronizzazione, ricevuto da una risposta precedente Durante la sincronizzazione, tutti gli altri parametri forniti a Ulteriori dettagli sul comportamento di sincronizzazione all'indirizzo |
readMask |
Obbligatorio. Una maschera di campo per limitare i campi restituiti per ogni persona. Puoi specificare più campi separandoli con virgole. I valori validi dipendono dal valore ReadSourceType utilizzato. Se viene utilizzato READ_SOURCE_TYPE_CONTACT, i valori validi sono:
Se viene utilizzato READ_SOURCE_TYPE_PROFILE, i valori validi sono:
|
sources[] |
(Facoltativo) Una maschera dei tipi di origine da restituire. Se non è configurato, il valore predefinito è I valori possibili per questo campo sono: Non è consentito specificare |
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
La risposta a una richiesta di "Altri contatti" dell'utente autenticato.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"otherContacts": [
{
object ( |
Campi | |
---|---|
otherContacts[] |
L'elenco "Altri contatti" restituite come risorse Persona. "Altri contatti" supporta un sottoinsieme limitato di campi. Per informazioni più dettagliate, vedi ListOtherContactsRequest.request_mask. |
nextPageToken |
Un token, che può essere inviato come |
nextSyncToken |
Un token, che può essere inviato come |
totalSize |
Il numero totale di altri contatti nell'elenco senza impaginazione. |
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/contacts.other.readonly
Per ulteriori informazioni, consulta la Guida all'autorizzazione.