People API

Proporciona acceso a información sobre perfiles y contactos.

Servicio: people.googleapis.com

Para llamar a este servicio, te recomendamos que uses las bibliotecas cliente proporcionadas por Google. Si tu aplicación necesita usar tus propias bibliotecas para llamar a este servicio, usa la siguiente información cuando realices solicitudes a la API.

Documento de descubrimiento

Un Documento de descubrimiento es una especificación procesable para describir y consumir las API de REST. Se usa para compilar bibliotecas cliente, complementos IDE y otras herramientas que interactúan con las API de Google. Un servicio puede proporcionar varios documentos de descubrimiento. Este servicio proporciona el documento de descubrimiento siguiente:

Extremo de servicio

Un extremo de servicio es una URL base que especifica la dirección de la red de un servicio de API. Un servicio puede tener varios extremos de servicio. Este servicio tiene el siguiente extremo, y todos los URI que se muestran a continuación son relativos a él:

  • https://people.googleapis.com

Recurso de REST: v1.contactGroups

Métodos
batchGet GET /v1/contactGroups:batchGet
Para obtener una lista de los grupos de contactos que pertenecen al usuario autenticado, especifica una lista de nombres de recursos del grupo de contactos.
create POST /v1/contactGroups
Crea un nuevo grupo de contactos que pertenezca al usuario autenticado.
delete DELETE /v1/{resourceName=contactGroups/*}
Para borrar un grupo de contactos existente que pertenezca al usuario autenticado, especifica un nombre del recurso del grupo de contactos.
get GET /v1/{resourceName=contactGroups/*}
Para obtener un grupo de contactos específico que pertenezca al usuario autenticado, especifica un nombre del recurso del grupo de contactos.
list GET /v1/contactGroups
Enumera todos los grupos de contactos que pertenecen al usuario autenticado.
update PUT /v1/{contactGroup.resourceName=contactGroups/*}
Actualiza el nombre de un grupo de contactos existente que pertenezca al usuario autenticado.

Recurso de REST: v1.contactGroups.members

Métodos
modify POST /v1/{resourceName=contactGroups/*}/members:modify
Modifica los miembros de un grupo de contactos que pertenecen al usuario autenticado.

Recurso de REST: v1.otherContacts

Métodos
copyOtherContactToMyContactsGroup POST /v1/{resourceName=otherContacts/*}:copyOtherContactToMyContactsGroup

Copia un "Otro contacto" a un nuevo contacto del grupo "myContacts" del usuario.

Las solicitudes de modificación para el mismo usuario se deben enviar de forma secuencial para evitar aumentos de latencia y fallas.
list GET /v1/otherContacts
Obtén una lista de todos los "Otros contactos", es decir, los que no están en ningún grupo de contactos.
search GET /v1/otherContacts:search
Proporciona una lista de contactos en los otros contactos del usuario autenticado que coincide con la búsqueda.

Recurso de REST: v1.people

Métodos
batchCreateContacts POST /v1/people:batchCreateContacts

Crea un lote de nuevos contactos y devuelve PersonResponses para los

Las solicitudes de modificación para el mismo usuario se deben enviar de forma secuencial para evitar aumentos de latencia y fallas.
batchDeleteContacts POST /v1/people:batchDeleteContacts
Borra un lote de contactos.
batchUpdateContacts POST /v1/people:batchUpdateContacts
Actualiza un lote de contactos y muestra un mapa de nombres de recursos a PersonResponses para los contactos actualizados.
createContact POST /v1/people:createContact
Crea un contacto nuevo y muestra el recurso de persona correspondiente a ese contacto.
deleteContact DELETE /v1/{resourceName=people/*}:deleteContact
Borra una persona de contacto.
deleteContactPhoto DELETE /v1/{resourceName=people/*}:deleteContactPhoto
Borra la foto de un contacto.
get GET /v1/{resourceName=people/*}
Proporciona información sobre una persona mediante la especificación de un nombre de recurso.
getBatchGet GET /v1/people:batchGet
Proporciona información sobre una lista de personas específicas mediante la especificación de una lista de nombres de recursos solicitados.
listDirectoryPeople GET /v1/people:listDirectoryPeople
Proporciona una lista de perfiles y contactos del dominio en el directorio del dominio del usuario autenticado.
searchContacts GET /v1/people:searchContacts
Proporciona una lista de contactos en los contactos agrupados del usuario autenticado que coincide con la búsqueda.
searchDirectoryPeople GET /v1/people:searchDirectoryPeople
Proporciona una lista de perfiles y contactos del dominio en el directorio del dominio del usuario autenticado que coinciden con la búsqueda.
updateContact PATCH /v1/{person.resourceName=people/*}:updateContact
Actualice los datos de contacto de una persona de contacto existente.
updateContactPhoto PATCH /v1/{resourceName=people/*}:updateContactPhoto
Actualiza la foto de un contacto.

Recurso de REST: v1.people.connections

Métodos
list GET /v1/{resourceName=people/*}/connections
Proporciona una lista de los contactos del usuario autenticado.