L'API People ti consente di:
- Leggere e gestire i Contatti dell'utente autenticato
- Leggi e copia la sezione "Altri contatti" dell'utente autenticato
- Lettura delle informazioni del profilo degli utenti autenticati e dei loro contatti
- Lettura di profili e contatti del dominio
Ad esempio, supponiamo che l'utente autenticato, Jen, abbia Fabian e Ranjith nei suoi contatti privati. Quando la tua app chiama
people.connections.list
per leggere un
elenco delle sue connessioni, a Jen viene visualizzata una schermata per il consenso che chiede di concedere
all'app l'accesso all'elenco. Se Jen acconsente, l'app legge un elenco contenente person resources
per Fabian e Ranjith.
Se l'app ha bisogno di informazioni per una persona specifica, può chiamare
people.get
, fornendo il nome di una risorsa, per ottenere
il person resource
per quella persona.
L'app può anche gestire i contatti creando nuovi contatti utilizzando
people.createContact
, aggiornare i contatti
esistenti da cui ha letto
people.connections.list
tramite
people.updateContact
ed eliminare i contatti
utilizzando people.deleteContact
.
Gli utenti di Google Workspace possono anche elencare i profili e i contatti del dominio della directory utilizzando people.listDirectoryPeople
o cercandoli utilizzando people.searchDirectoryPeople
.
Una visualizzazione unita di informazioni sulle persone
Le informazioni sulle persone lette dall'API People vengono unite da varie origini, in base alle seguenti condizioni:
Origine | Condizione |
---|---|
Dati del profilo Google pubblico | Sempre. |
dati del profilo del dominio Google Workspace | L'amministratore di dominio ha abilitato la condivisione esterna di contatti e profili
dei dati relativi al dominio ed è stato
concesso l'ambito directory.readonly |
Le informazioni del profilo privato dell'utente autenticato | Uno degli ambiti profile è stato concesso. |
I contatti dell'utente autenticato | L'ambito contacts è stato concesso. |
Comprensione dei dati sulle persone uniti
I dati relativi a una persona derivano da un tipo di origine principale. I dati di altre origini vengono uniti a questi dati se le origini sono collegate tramite indirizzi email verificati, numeri di telefono o URL del profilo. Ecco le possibili modalità di scrittura di una persona:
Fonte principale | Contatti | Profili | Profili di dominio Google Workspace | Contatti del dominio Google Workspace | Utilizzo |
---|---|---|---|---|---|
Contatto | 1 | 0+ | 0+ | 0+ | Restituito per la maggior parte degli endpoint |
Profilo | 0+ | 1 | 0 o 1 | 0 | Restituito in people.get quando viene utilizzato per trovare quella persona per l'utente che ha eseguito l'accesso o per ottenere una persona per l'Account Google di un altro utente. |
Contatto per il dominio | 0+ | 0 | 0 | 1 | Restituito nel mese di people.listDirectoryPeople o people.searchDirectoryPeople . |
Solo le persone che utilizzano i contatti possono essere modificate da endpoint di mutazione. Le modifiche al profilo e al contatto del dominio non sono supportate.