Ir para o conteúdo
Todas as ferramentas

update_contact

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

Atualiza um contato nos Contatos do Microsoft Outlook no Windows, encontrado por contact_id ou pelo nome. O nome, o sobrenome e a empresa informados substituem os atuais; os telefones e e-mails informados são ADICIONADOS (os atuais ficam, e um número ou endereço que já existe é ignorado; o Outlook guarda até 6 telefones e 3 e-mails, e o que não cabe volta em not_stored); photo_path substitui a foto. Nada é removido. Um nome que corresponde a vários contatos é recusado com a lista para escolher um contact_id. As notas não são gravadas, como no Mac.

Entradas obrigatórias

O esquema desta plataforma não declara entradas obrigatórias. Ainda podem existir seletores opcionais ou requisitos de execução.

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": {
    "company": {
      "description": "Company or organization.",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to save.",
      "type": "boolean"
    },
    "contact_id": {
      "description": "Exact identifier from outlook_contacts_list/outlook_contacts_search/create_contact. Provide this OR name.",
      "type": "string"
    },
    "emails": {
      "description": "Email addresses, as a JSON array or comma-separated.",
      "type": "string"
    },
    "first_name": {
      "description": "Given name.",
      "type": "string"
    },
    "last_name": {
      "description": "Family name.",
      "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"
    },
    "phones": {
      "description": "Phone numbers, as a JSON array or comma-separated (with the country code, e.g. +54 11 5555 0001).",
      "type": "string"
    },
    "photo_path": {
      "description": "Absolute path of a local image (PNG, JPEG, GIF or BMP, up to 10 MB) to use as the contact's photo.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Exemplo documental

Exemplo de documentação para update_contact. 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.

{
  "company": "Example Co",
  "confirm": false,
  "name": "Alex Rivera",
  "phones": "+1 555 0101"
}