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
group_name
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.
- Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.
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"
}