Introdução

A API People permite:

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

Por exemplo, suponha que a usuária autenticada, Jen, tem Fabian e Ranjith nos contatos particulares dela. Quando o app chama people.connections.list para ler uma lista de conexões, Jen aparece com uma tela de consentimento pedindo para conceder acesso à 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 pode chamar people.get e transmitir um nome de recurso para receber o person resource dessa pessoa.

O app também pode gerenciar contatos criando novos contatos usando people.createContact, atualizar contatos existentes lidos com people.connections.list usando people.updateContact e excluir contatos usando people.deleteContact.

Os usuários do Google Workspace também podem listar os contatos e contatos de domínio do domínio usando people.listDirectoryPeople ou pesquisar usando people.searchDirectoryPeople.

Uma visualização unificada das informações de pessoas

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

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

Noções básicas sobre dados de pessoas mescladas

Os dados de uma pessoa são derivados de um tipo principal de origem. Os dados de outras fontes serão combinados com esses dados se estiverem conectados por endereços de e-mail, números de telefone ou URLs de perfil verificados. Veja como 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 Devolvido no people.get quando usado para levar a pessoa para o usuário conectado ou 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 contatos podem ser modificadas por endpoints de mutação. As mutações de contato de perfil e do domínio não são compatíveis.