Introdução

A API People permite que você:

  • Ler e gerenciar os Contatos do usuário autenticado
  • Ler e copiar os Outros contatos do usuário autenticado
  • Ler as informações de perfil dos usuários autenticados e dos contatos deles
  • Ler perfis e contatos do domínio

Por exemplo, suponha que o usuário autenticado, Jen, tenha Fabian e Ranjith nos contatos particulares, Quando seu app chama people.connections.list para ler uma lista das conexões dela, Jen recebe uma tela de consentimento solicitando que o app acesse a lista. Se Jen consentir, o app lerá uma lista contendo person resources para Fabian e Ranjith.

Se o app precisar de informações de uma pessoa específica, ele poderá chamar people.get, transmitindo um nome de recurso para acessar o person resource dessa pessoa.

O app também pode gerenciar contatos criando novos com o people.createContact, atualizar contatos existentes lidos de people.connections.list com people.updateContact e excluí-los usando people.deleteContact.

Os usuários do Google Workspace também podem listar os perfis de domínio do diretório e contatos do domínio usando people.listDirectoryPeople ou pesquisá-los usando people.searchDirectoryPeople.

Visualização mesclada das informações das pessoas

As informações de pessoas que a API People lê são mescladas de várias fontes, dependendo das seguintes condições:

Origem Condição
Dados públicos de perfis do Google Sempre.
Dados de perfil do domínio do Google Workspace O administrador do domínio ativou o compartilhamento de contatos externos e perfis de dados com escopo de domínio, e o escopo directory.readonly foi concedido
As informações particulares do perfil do usuário autenticado Um dos escopos profile foi concedido.
Os contatos do usuário autenticado O escopo contacts foi concedido.

Entender os dados de pessoas mescladas

Os dados de uma pessoa são derivados de um tipo de fonte principal. Dados de outras fontes serão mesclados com esses dados se as origens estiverem conectadas por meio de endereços de e-mail, números de telefone ou URLs de perfil verificados. Estas são as maneiras pelas quais uma pessoa pode ser composta:

Fonte principal Contatos Perfis Perfis de domínio do Google Workspace Contatos do domínio do Google Workspace Uso
Contato 1 0+ 0+ 0+ Retornado para a maioria dos endpoints
Perfil 0+ 1 0 ou 1 0 Retornado em people.get quando é usado para identificar a pessoa para o usuário que fez login ou para adicionar uma pessoa para a Conta do Google de outro usuário.
Contato do domínio 0+ 0 0 1 Devolvido em people.listDirectoryPeople ou people.searchDirectoryPeople.

Somente pessoas baseadas em contato podem ser modificadas por endpoints de mutação. Mutações de contato de perfil e de domínio não são compatíveis.