Ir para o conteúdo
Todas as ferramentas

add_contact_to_group

Contactos · Windows

Efeito: escrita. Estado: disponibilidade condicionada.

«Disponibilidade condicionada» significa que a ferramenta pode depender da versão, plataforma, permissões, conta ou configuração. Não significa que esteja ativa em todas as instalações.

Windows

Finalidade

Adiciona um contato dos Contatos do Microsoft Outlook no Windows, encontrado por contact_id ou pelo nome, a um grupo existente, encontrado pelo nome exato sem diferenciar maiúsculas. O contato precisa de um endereço de e-mail: os grupos do Outlook guardam endereços. Um contato que já está no grupo recebe a resposta already_in_group: true. Para criar um grupo, use create_contact_group.

Entradas obrigatórias

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema declara um parâmetro explícito de confirmação. Reveja a pré-visualização e autorize a operação real de acordo com o contrato da plataforma.

Esquema técnico canónico em inglês — Windows
{
  "properties": {
    "confirm": {
      "description": "Ignored; kept for older clients.",
      "type": "boolean"
    },
    "contact_id": {
      "description": "Exact identifier from outlook_contacts_list/outlook_contacts_search/create_contact. Provide this OR name.",
      "type": "string"
    },
    "group_name": {
      "description": "Name of the group, as outlook_contacts_list or Outlook shows it.",
      "type": "string"
    },
    "name": {
      "description": "The contact's full name. Provide this OR contact_id; a name that matches several contacts is refused with the list.",
      "type": "string"
    }
  },
  "required": [
    "group_name"
  ],
  "type": "object"
}

Exemplo documental

Exemplo de documentação para add_contact_to_group. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

{
  "confirm": false,
  "group_name": "Project team",
  "name": "Alex Rivera"
}