People API

Proporciona acceso a información sobre perfiles y contactos.

Servicio: people.googleapis.com

Para llamar a este servicio, te recomendamos usar las bibliotecas cliente que proporciona Google. Si tu aplicación necesita usar tus propias bibliotecas para llamar a este servicio, usa la siguiente información cuando realices las 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
Obtén una lista de los grupos de contactos que pertenecen al usuario autenticado. Para ello, especifica una lista de nombres de recursos de grupos de contactos.
create POST /v1/contactGroups
Crea un nuevo grupo de contacto que pertenezca al usuario autenticado.
delete DELETE /v1/{resourceName=contactGroups/*}
Especifica un nombre de recurso de grupo de contactos para borrar un grupo de contactos existente que pertenezca al usuario autenticado.
get GET /v1/{resourceName=contactGroups/*}
Especifica un nombre de recurso de grupo de contactos para obtener un grupo de contactos específico que pertenezca al usuario autenticado.
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 pertenece al usuario autenticado.

Recurso de REST: v1.otherContacts

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

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

Las solicitudes de mutación del mismo usuario se deben enviar de forma secuencial para evitar una mayor latencia y fallas.
list GET /v1/otherContacts
Enumera todos los "Otros contactos", es decir, aquellos que no están en un grupo de contactos.
search GET /v1/otherContacts:search
Proporciona una lista de contactos de 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 contactos nuevos y muestra las respuestas de persona para la nueva

Las solicitudes de mutación del mismo usuario se deben enviar de forma secuencial para evitar una mayor 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 los nombres de los recursos a PersonResponses para los contactos actualizados.
createContact POST /v1/people:createContact
Crea un contacto nuevo y muestra el recurso de persona correspondiente.
deleteContact DELETE /v1/{resourceName=people/*}:deleteContact
Borrar 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 de dominio y contactos de dominio en el directorio de dominio del usuario autenticado.
searchContacts GET /v1/people:searchContacts
Proporciona una lista de los contactos agrupados del usuario autenticado que coincide con la búsqueda.
searchDirectoryPeople GET /v1/people:searchDirectoryPeople
Proporciona una lista de perfiles de dominio y contactos de dominio en el directorio de dominio del usuario autenticado que coinciden con la búsqueda.
updateContact PATCH /v1/{person.resourceName=people/*}:updateContact
Actualice los datos de los contactos existentes.
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.