People API

Dá acesso a informações sobre perfis e contatos.

Serviço: people.googleapis.com

Para chamar esse serviço, recomendamos que você use as bibliotecas de cliente fornecidas pelo Google. Caso seu aplicativo precise usar suas próprias bibliotecas para chamar esse serviço, use as informações a seguir quando fizer as solicitações de API.

Documento de descoberta

Um Documento de descoberta é uma especificação legível por máquina para descrever e consumir APIs REST. Ele é usado para criar bibliotecas de cliente, plug-ins IDE e outras ferramentas que interagem com as APIs do Google. Um serviço pode fornecer vários documentos de descoberta. O serviço fornece o seguinte documento de detecção:

Endpoint de serviço

Um endpoint de serviço é um URL base que especifica o endereço de rede de um serviço de API. Um serviço pode ter vários endpoints de serviço. Este serviço tem o endpoint a seguir e todos os URIs abaixo são relativos a ele:

  • https://people.googleapis.com

Recurso REST: v1.contactGroups

Métodos
batchGet GET /v1/contactGroups:batchGet
Acesse uma lista dos grupos de contatos de propriedade do usuário autenticado especificando uma lista de nomes de recursos do grupo de contatos.
create POST /v1/contactGroups
Crie um novo grupo de contatos de propriedade do usuário autenticado.
delete DELETE /v1/{resourceName=contactGroups/*}
Exclua um grupo de contatos atual de propriedade do usuário autenticado especificando o nome de recurso do grupo de contatos.
get GET /v1/{resourceName=contactGroups/*}
Para encontrar um grupo de contatos específico de propriedade do usuário autenticado, especifique o nome de recurso do grupo de contatos.
list GET /v1/contactGroups
Lista todos os grupos de contatos do usuário autenticado.
update PUT /v1/{contactGroup.resourceName=contactGroups/*}
Atualize o nome de um grupo de contatos existente de propriedade do usuário autenticado.

Recurso REST: v1.contactGroups.members

Métodos
modify POST /v1/{resourceName=contactGroups/*}/members:modify
Modifique os participantes de um grupo de contatos do usuário autenticado.

Recurso REST: v1.otherContacts

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

Copia um "Outro contato" para um novo contato no grupo "myContacts" do usuário

As solicitações de modificação para o mesmo usuário devem ser enviadas em sequência para evitar o aumento da latência e as falhas.

list GET /v1/otherContacts
Lista todos os "Outros contatos", ou seja, os contatos que não estão em um grupo.
search GET /v1/otherContacts:search
Fornece uma lista de contatos dos outros contatos do usuário autenticado que correspondem à consulta de pesquisa.

Recurso REST: v1.people

Métodos
batchCreateContacts POST /v1/people:batchCreateContacts

Cria um lote de novos contatos e retorna PersonResponses dos contatos

As solicitações de modificação para o mesmo usuário devem ser enviadas em sequência para evitar o aumento da latência e as falhas.

batchDeleteContacts POST /v1/people:batchDeleteContacts
Exclui um lote de contatos.
batchUpdateContacts POST /v1/people:batchUpdateContacts
Atualiza um lote de contatos e retorna um mapa de nomes de recursos para PersonResponses dos contatos atualizados.
createContact POST /v1/people:createContact
Crie um novo contato e retorne o recurso da pessoa para esse contato.
deleteContact DELETE /v1/{resourceName=people/*}:deleteContact
Excluir um contato.
deleteContactPhoto DELETE /v1/{resourceName=people/*}:deleteContactPhoto
Excluir a foto de um contato.
get GET /v1/{resourceName=people/*}
Oferece informações sobre uma pessoa especificando um nome de recurso.
getBatchGet GET /v1/people:batchGet
Oferece informações sobre uma lista de pessoas específicas especificando uma lista de nomes de recursos solicitados.
listDirectoryPeople GET /v1/people:listDirectoryPeople
Oferece uma lista de perfis e contatos do domínio no diretório do domínio do usuário autenticado.
searchContacts GET /v1/people:searchContacts
Fornece uma lista de contatos nos contatos agrupados do usuário autenticado que correspondem à consulta de pesquisa.
searchDirectoryPeople GET /v1/people:searchDirectoryPeople
Fornece uma lista de perfis e contatos do domínio no diretório do domínio do usuário autenticado que correspondem à consulta de pesquisa.
updateContact PATCH /v1/{person.resourceName=people/*}:updateContact
Atualize os dados de um contato existente.
updateContactPhoto PATCH /v1/{resourceName=people/*}:updateContactPhoto
Atualizar a foto de um contato.

Recurso REST: v1.people.connections

Métodos
list GET /v1/{resourceName=people/*}/connections
Fornece uma lista dos contatos do usuário autenticado.