La API de People te permite:
- Leer y administrar los Contactos del usuario autenticado
- Leer y copiar los "Otros contactos" del usuario autenticado
- Leer la información de perfil de los usuarios autenticados y sus contactos
- Leer los perfiles y contactos del dominio
Por ejemplo, supongamos que el usuario autenticado Jen tiene a Fabian y Ranjith en sus contactos privados. Cuando la app llama a people.connections.list para leer una lista de sus conexiones, se muestra una pantalla de consentimiento en la que se le solicita a la app que acceda a la lista. Si Ana da su consentimiento, la app leerá una lista que contiene person resources de 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 la person resource de esa persona.
La app también puede administrar contactos creando contactos nuevos con people.createContact, actualizando contactos existentes de people.connections.list mediante people.updateContact y borrando contactos con people.deleteContact.
Los usuarios de Google Workspace también pueden enumerar los perfiles de dominio del directorio y los contactos del dominio con people.listDirectoryPeople o buscarlos mediante people.searchDirectoryPeople.
Vista combinada de la información de las personas
La información de las personas que lee la API de People se combina de varias fuentes, según las siguientes condiciones:
| Origen | Condición |
|---|---|
| Datos de perfil públicos de Google | siempre. |
| Datos del perfil de dominio de Google Workspace | El administrador de dominio habilitó el uso compartido externo de contactos y perfiles de datos con alcance de dominio, y se otorgó el permiso directory.readonly. |
| La información de perfil privado del usuario autenticado | Se otorgó uno de los permisos profile. |
| Los contactos del usuario autenticado | Se otorgó el alcance contacts. |
Comprensión de los datos combinados de personas
Los datos de una persona se 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 verificadas. Estas son las formas en las que una persona puede estar compuesta:
| Fuente principal | Contactos | Perfiles | Perfiles de dominio de Google Workspace | Contactos de 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 acceder a la persona en nombre del usuario que accedió o para conseguir que una persona acceda a 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 las personas basadas en contactos pueden modificarse mediante extremos de mutación. No se admiten mutaciones de contactos de perfiles y dominios.