Pular para o conteúdo
Skillpedia
PDF, Word e slides32 mil · #6279

gws-people

Faz seu agente gerenciar contatos e perfis no Google People. Ajuda a organizar informações de pessoas e relacionamentos.

O que ela faz

Esta ferramenta permite gerenciar seus contatos e perfis. Você pode criar, listar, atualizar e excluir grupos de contatos, além de adicionar ou remover pessoas desses grupos.

Quando usar

  • ✓Criar um novo grupo de contatos para organizar seus contatos.
  • ✓Adicionar um contato a um grupo existente.
  • ✓Buscar um contato específico na sua lista.

Exemplo do que pedir para a IA

“Crie um grupo de contatos chamado 'Família' e adicione o João Silva a ele.”

Quer saber mais? Abra as seções abaixo.

Como usar

O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.

Link da skill

https://github.com/googleworkspace/cli/blob/main/skills/gws-people/SKILL.md

Mensagem pronta para colar

Use esta skill para me ajudar: https://github.com/googleworkspace/cli/blob/main/skills/gws-people/SKILL.md Leia o arquivo SKILL.md desse link e siga as instruções dele na minha tarefa.
Como funciona

A ferramenta se conecta à sua conta Google para acessar e modificar seus contatos. Ela usa comandos específicos para cada ação, como criar, listar ou deletar.

Instalação

Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.

No terminal (Claude Code, Codex, Cursor), na pasta do projeto:

npx skills add googleworkspace/cli --skill gws-people

Ou baixe só o arquivo:

curl -L https://raw.githubusercontent.com/googleworkspace/cli/main/skills/gws-people/SKILL.md -o SKILL.md
Conteúdo técnico (SKILL.md)

Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.

people (v1)

PRÉ-REQUISITO: Leia ../gws-shared/SKILL.md para autenticação, flags globais e regras de segurança. Se estiver faltando, execute gws generate-skills para criá-lo.

gws people <resource> <method> [flags]

Recursos da API

contactGroups

  • batchGet — Obtém uma lista de grupos de contatos pertencentes ao usuário autenticado, especificando uma lista de nomes de recursos de grupos de contatos.
  • create — Cria um novo grupo de contatos pertencente ao usuário autenticado. Os nomes dos grupos de contatos criados devem ser únicos entre os grupos de contatos do usuário. Tentar criar um grupo com um nome duplicado retornará um erro HTTP 409. Requisições de mutação para o mesmo usuário devem ser enviadas sequencialmente para evitar aumento de latência e falhas.
  • delete — Exclui um grupo de contatos existente pertencente ao usuário autenticado, especificando um nome de recurso de grupo de contatos. Requisições de mutação para o mesmo usuário devem ser enviadas sequencialmente para evitar aumento de latência e falhas.
  • get — Obtém um grupo de contatos específico pertencente ao usuário autenticado, especificando um nome de recurso de grupo de contatos.
  • list — Lista todos os grupos de contatos pertencentes ao usuário autenticado. Os membros dos grupos de contatos não são populados.
  • update — Atualiza o nome de um grupo de contatos existente pertencente ao usuário autenticado. Os nomes dos grupos de contatos atualizados devem ser únicos entre os grupos de contatos do usuário. Tentar criar um grupo com um nome duplicado retornará um erro HTTP 409. Requisições de mutação para o mesmo usuário devem ser enviadas sequencialmente para evitar aumento de latência e falhas.
  • members — Operações no recurso 'members'

otherContacts

  • copyOtherContactToMyContactsGroup — Copia um "Outro contato" para um novo contato no grupo "meusContatos" do usuário. Requisições de mutação para o mesmo usuário devem ser enviadas sequencialmente para evitar aumento de latência e falhas.
  • list — Lista todos os "Outros contatos", ou seja, contatos que não estão em um grupo de contatos. "Outros contatos" são tipicamente contatos criados automaticamente a partir de interações. Tokens de sincronização expiram 7 dias após a sincronização completa. Uma requisição com um token de sincronização expirado receberá um erro com um google.rpc.ErrorInfo com a razão "EXPIRED_SYNC_TOKEN". Nesse caso, os clientes devem fazer uma requisição de sincronização completa sem um sync_token.
  • search — Fornece uma lista de contatos nos outros contatos do usuário autenticado que correspondem à consulta de pesquisa. A consulta corresponde aos campos names, emailAddresses e phoneNumbers de um contato que são da origem OTHER_CONTACT. IMPORTANTE: Antes de pesquisar, os clientes devem enviar uma requisição de aquecimento com uma consulta vazia para atualizar o cache. Veja https://developers.google.com/people/v1/other-contacts#search_the_users_other_contacts

people

  • batchCreateContacts — Cria um lote de novos contatos e retorna as PersonResponses para os novos contatos. Requisições de mutação para o mesmo usuário devem ser enviadas sequencialmente para evitar aumento de latência e falhas.
  • batchUpdateContacts — Atualiza um lote de contatos e retorna um mapa de nomes de recursos para PersonResponses para os contatos atualizados. Requisições de mutação para o mesmo usuário devem ser enviadas sequencialmente para evitar aumento de latência e falhas.
  • createContact — Cria um novo contato e retorna o recurso de pessoa para esse contato. A requisição retorna um erro 400 se mais de um campo for especificado em um campo que é um singleton para fontes de contato: * biografias * aniversários * gêneros * nomes Requisições de mutação para o mesmo usuário devem ser enviadas sequencialmente para evitar aumento de latência e falhas.
  • deleteContactPhoto — Exclui a foto de um contato. Requisições de mutação para o mesmo usuário devem ser feitas sequencialmente para evitar // contenção de bloqueio.
  • get — Fornece informações sobre uma pessoa especificando um nome de recurso. Use people/me para indicar o usuário autenticado. A requisição retorna um erro 400 se 'personFields' não for especificado.
  • getBatchGet — Fornece informações sobre uma lista de pessoas específicas, especificando uma lista de nomes de recursos solicitados. Use people/me para indicar o usuário autenticado. A requisição retorna um erro 400 se 'personFields' não for especificado.

…

Perguntas frequentes

Como faço para ver todos os meus grupos de contatos?

Use o comando 'list' na seção 'contactGroups'.

Posso renomear um grupo de contatos?

Sim, use o comando 'update' na seção 'contactGroups' e forneça o novo nome.

Como adiciono um contato a um grupo?

Você pode usar o comando 'create' na seção 'members' para adicionar um contato a um grupo existente.

Detalhes

Descrição original do autor

Google People: Manage contacts and profiles.

repo: googleworkspace/cli

Popularidade

Estrelas no GitHub
32 mil
Posição no ranking
#6279
Licença
Apache-2.0
Atualizada em
06/10/2026

Essa skill é útil?

0

Entre para votar.

Comentários

  • …

Mais skills deste repositório

Skills parecidas