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.