Introduzione

L'API People ti consente di:

  • Leggere e gestire i contatti dell'utente autenticato
  • Leggere e copiare "Altri contatti" dell'utente autenticato.
  • Lettura di informazioni del profilo per utenti autenticati e relativi contatti
  • Lettura di profili e contatti del dominio

Ad esempio, supponiamo che l'utente autenticato, Jenna, abbia Fabian e Ranjith nei suoi contatti privati. Quando l'app chiama people.connections.list per leggere un elenco delle sue connessioni, a Jenne viene presentata 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, trasmettendo un nome risorsa, per ottenere la person resource per quella persona.

L'app può anche gestire i contatti creando nuovi contatti utilizzando people.createContact, aggiornando i contatti esistenti che ha letto da people.connections.list utilizzando people.updateContact ed eliminando i contatti utilizzando people.deleteContact.

Gli utenti di Google Workspace possono anche elencare i propri profili di dominio della directory e i contatti di dominio utilizzando people.listDirectoryPeople o cercarli utilizzando people.searchDirectoryPeople.

Una visualizzazione unificata delle informazioni sulle persone.

Le informazioni sulle persone che l'API People legge vengono unite da varie fonti, a seconda delle seguenti condizioni:

Fonte Condizione
Dati pubblici del profilo Google Sempre.
Dati del profilo del dominio Google Workspace L'amministratore di dominio ha attivato la condivisione dei contatti e del profilo esterni dei dati con ambito a livello di dominio e l'ambito directory.readonly è stato concesso
Le informazioni del profilo privato dell'utente autenticato Uno degli ambitiprofile è stato concesso.
I contatti dell'utente autenticato L'ambito contacts è stato concesso.

Informazioni sui dati della persona uniti

I dati di una persona derivano da un tipo di fonte principale. I dati di altre origini vengono uniti a questi dati se queste sono collegate tramite indirizzi email, numeri di telefono o URL del profilo verificati. Ecco i modi in cui una persona può essere composta:

Sorgente principale Contatti Profili Profili di dominio di 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 Viene restituito in people.get quando viene utilizzato per recuperare la persona per l'utente che ha eseguito l'accesso oppure per chiedere a una persona di usare l'Account Google di un altro utente.
Contatto dominio 0+ 0 0 1 Restituito in people.listDirectoryPeople o people.searchDirectoryPeople.

Solo le persone basate sui contatti possono essere modificate dagli endpoint delle mutazioni. Le mutazioni del profilo e del contatto del dominio non sono supportate.