People API

Consente di accedere alle informazioni su profili e contatti.

Servizio: people.googleapis.com

Per chiamare questo servizio, ti consigliamo di utilizzare le librerie client fornite da Google. Se la tua applicazione deve utilizzare le tue librerie per chiamare questo servizio, usa le seguenti informazioni quando effettui le richieste API.

Documento di rilevamento

Un documento di rilevamento è una specifica leggibile dalle macchine per la descrizione e l'utilizzo delle API REST. Viene utilizzato per creare librerie client, plug-in IDE e altri strumenti che interagiscono con le API di Google. Un servizio può fornire più documenti di rilevamento. Questo servizio fornisce il seguente documento di rilevamento:

Endpoint di servizio

Un endpoint di servizio è un URL di base che specifica l'indirizzo di rete di un servizio API. Un servizio può avere più endpoint di servizio. Questo servizio ha il seguente endpoint di servizio e tutti gli URI di seguito sono relativi a questo endpoint di servizio:

  • https://people.googleapis.com

Risorsa REST: v1.contactGroups

Metodi
batchGet GET /v1/contactGroups:batchGet
Per ottenere un elenco dei gruppi di contatti di proprietà dell'utente autenticato, specifica un elenco di nomi di risorse dei gruppi di contatti.
create POST /v1/contactGroups
Crea un nuovo gruppo di contatti di proprietà dell'utente autenticato.
delete DELETE /v1/{resourceName=contactGroups/*}
Elimina un gruppo di contatti esistente di proprietà dell'utente autenticato specificando un nome risorsa per il gruppo di contatti.
get GET /v1/{resourceName=contactGroups/*}
Per ottenere un gruppo di contatti specifico di proprietà dell'utente autenticato, specifica il nome di una risorsa del gruppo di contatti.
list GET /v1/contactGroups
Elenca tutti i gruppi di contatti di proprietà dell'utente autenticato.
update PUT /v1/{contactGroup.resourceName=contactGroups/*}
Aggiorna il nome di un gruppo di contatti esistente di proprietà dell'utente autenticato.

Risorsa REST: v1.contactGroups.members

Metodi
modify POST /v1/{resourceName=contactGroups/*}/members:modify
Modificare i membri di un gruppo di contatti di proprietà dell'utente autenticato.

Risorsa REST: v1.otherContacts

Metodi
copyOtherContactToMyContactsGroup POST /v1/{resourceName=otherContacts/*}:copyOtherContactToMyContactsGroup

Copia un "Altro contatto" in un nuovo contatto nel gruppo "myContacts " dell'utente

Le richieste modificate per lo stesso utente devono essere inviate in sequenza per evitare un aumento della latenza e degli errori.

list GET /v1/otherContacts
Elenca tutti gli "Altri contatti", ovvero i contatti che non fanno parte di un gruppo di contatti.
search GET /v1/otherContacts:search
Fornisce un elenco di contatti negli altri contatti dell'utente autenticato che corrispondono alla query di ricerca.

Risorsa REST: v1.people

Metodi
batchCreateContacts POST /v1/people:batchCreateContacts

Crea un gruppo di nuovi contatti e restituisci le risposte del tipo PersonResponse per i nuovi

Le richieste modificate per lo stesso utente devono essere inviate in sequenza per evitare un aumento della latenza e degli errori.

batchDeleteContacts POST /v1/people:batchDeleteContacts
Elimina un gruppo di contatti.
batchUpdateContacts POST /v1/people:batchUpdateContacts
Aggiorna un gruppo di contatti e restituisci una mappa dei nomi delle risorse a PersonResponses per i contatti aggiornati.
createContact POST /v1/people:createContact
Crea un nuovo contatto e restituisci la risorsa persona per quel contatto.
deleteContact DELETE /v1/{resourceName=people/*}:deleteContact
Elimina un contatto.
deleteContactPhoto DELETE /v1/{resourceName=people/*}:deleteContactPhoto
Eliminare la foto di un contatto.
get GET /v1/{resourceName=people/*}
Fornisce informazioni su una persona specificando un nome risorsa.
getBatchGet GET /v1/people:batchGet
Fornisce informazioni su un elenco di persone specifiche specificando un elenco dei nomi delle risorse richieste.
listDirectoryPeople GET /v1/people:listDirectoryPeople
Fornisce un elenco di profili e contatti del dominio nella directory del dominio dell'utente autenticato.
searchContacts GET /v1/people:searchContacts
Fornisce un elenco di contatti nei contatti raggruppati dell'utente autenticato che corrispondono alla query di ricerca.
searchDirectoryPeople GET /v1/people:searchDirectoryPeople
Fornisce un elenco di profili e contatti di dominio nella directory del dominio dell'utente autenticato che corrispondono alla query di ricerca.
updateContact PATCH /v1/{person.resourceName=people/*}:updateContact
Aggiorna i dati di contatto di una persona di contatto esistente.
updateContactPhoto PATCH /v1/{resourceName=people/*}:updateContactPhoto
Aggiorna la foto di un contatto.

Risorsa REST: v1.people.connections

Metodi
list GET /v1/{resourceName=people/*}/connections
Fornisce un elenco dei contatti dell'utente autenticato.