La API de Personas te permite:
- Leer y administrar los Contactos del usuario autenticado
- Lee y copia los "Otros contactos" del usuario autenticado.
- Lee la información del perfil de los usuarios autenticados y sus contactos
- Leer perfiles y contactos del dominio
Por ejemplo, supongamos que el usuario autenticado, Jen, tiene Fabian y Ranjith en sus contactos privados. Cuando tu app llama a people.connections.list para leer una lista de sus conexiones, se le muestra una pantalla de consentimiento a Jen para que la app tenga acceso a la lista. Si Jen otorga su consentimiento, la app lee una lista que contiene person resources para Fabian y Ranjith.
Si la app necesita información de una persona específica, puede llamar a people.get y pasar el nombre de un recurso para obtener el person resource de esa persona.
Para administrar los contactos, la app también puede crear contactos nuevos con people.createContact, actualizar los contactos existentes que leyó desde people.connections.list con people.updateContact y borrar los contactos mediante people.deleteContact.
Los usuarios de Google Workspace también pueden generar una lista de los perfiles de dominio de su directorio y sus contactos de dominio mediante people.listDirectoryPeople o buscarlos mediante people.searchDirectoryPeople.
Una vista combinada de la información de las personas
La información de personas que lee la API de personas se combina desde varias fuentes, según las siguientes condiciones:
| Fuente | Condición |
|---|---|
| Los datos públicos del perfil de Google | Siempre. |
| Datos de perfil del dominio de Google Workspace | El administrador de dominio habilitó el uso compartido de perfiles y contactos externos de los datos con alcance y se otorgó el alcance directory.readonly. |
| La información del perfil privado del usuario autenticado | Se otorgó uno de los alcances profile. |
| Los contactos del usuario autenticado | Se otorgó el alcance contacts. |
Información sobre los datos combinados de personas
Los datos de una persona derivan de un tipo de fuente principal. Los datos de otras fuentes se combinan con estos datos si las fuentes están conectadas a través de direcciones de correo electrónico, números de teléfono o URL de perfil verificados. Estas son las formas en las que una persona puede estar compuesta:
| Fuente principal | Contactos | Perfiles | Perfiles de dominio de Google Workspace | Contactos del dominio de Google Workspace | Uso |
|---|---|---|---|---|---|
| Contacto | 1 | Más de 0 | Más de 0 | Más de 0 | Se muestra para la mayoría de los extremos |
| Perfil | Más de 0 | 1 | 0 o 1 | 0 | Se muestra en people.get cuando se usa para obtener la persona del usuario que accedió o la de la Cuenta de Google de otro usuario. |
| Contacto del dominio | Más de 0 | 0 | 0 | 1 | Se muestra en people.listDirectoryPeople o people.searchDirectoryPeople. |
Solo se pueden modificar las personas basadas en contactos mediante extremos de mutación. No se admiten mutaciones de contactos de perfil y de dominio.