People API

Fornece acesso a informações sobre perfis e contatos.

Serviço: pessoas.googleapis.com

Para chamar esse serviço, use as bibliotecas de cliente fornecidas pelo Google. Se o aplicativo precisar usar bibliotecas próprias para chamar esse serviço, utilize as informações a seguir ao fazer 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
Para ver uma lista dos grupos de contatos do usuário autenticado, especifique os nomes dos recursos do grupo de contatos.
create POST /v1/contactGroups
Crie um novo grupo de contatos do usuário autenticado.
delete DELETE /v1/{resourceName=contactGroups/*}
Para excluir um grupo de contatos do usuário autenticado, especifique o nome de um recurso do grupo de contatos.
get GET /v1/{resourceName=contactGroups/*}
Para acessar um grupo de contatos específico do usuário autenticado, especifique o nome de um 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 do usuário autenticado.

Recurso REST: v1.contactGroups.members

Métodos
modify POST /v1/{resourceName=contactGroups/*}/members:modify
Modifique os membros 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 "meus contatos" do usuário.

As solicitações de mutação para o mesmo usuário devem ser enviadas sequencialmente para evitar maior latência e falhas.
list GET /v1/otherContacts
Lista todos os "Outros contatos", ou seja, os contatos que não estão em um grupo de contatos.
search GET /v1/otherContacts:search
Fornece uma lista de contatos nos outros contatos do usuário autenticado que correspondem à consulta de pesquisa.

Recurso REST: v1.people

Métodos
batchCreateContacts POST /v1/people:batchCreateContacts

Crie um lote de novos contatos e retorne PersonResponses para o novo

As solicitações de mutação para o mesmo usuário devem ser enviadas sequencialmente para evitar maior latência e falhas.
batchDeleteContacts POST /v1/people:batchDeleteContacts
Exclua um lote de contatos.
batchUpdateContacts POST /v1/people:batchUpdateContacts
Atualiza um lote de contatos e retorna um mapa de nomes de recursos para PersonResponses para os contatos atualizados.
createContact POST /v1/people:createContact
Crie um novo contato e retorne o recurso de pessoa para esse contato.
deleteContact DELETE /v1/{resourceName=people/*}:deleteContact
Exclua um contato.
deleteContactPhoto DELETE /v1/{resourceName=people/*}:deleteContactPhoto
Exclua a foto de um contato.
get GET /v1/{resourceName=people/*}
Fornece um nome de recurso para fornecer informações sobre uma pessoa.
getBatchGet GET /v1/people:batchGet
Fornece informações sobre uma lista de pessoas específicas, com uma lista de nomes de recursos solicitados.
listDirectoryPeople GET /v1/people:listDirectoryPeople
Fornece 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 corresponde à consulta de pesquisa.
searchDirectoryPeople GET /v1/people:searchDirectoryPeople
Fornece uma lista de perfis e contatos do domínio no diretório do usuário do usuário autenticado que corresponde à consulta de pesquisa.
updateContact PATCH /v1/{person.resourceName=people/*}:updateContact
Atualize os dados de contato de um contato atual.
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.