Introduzione

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.