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.