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.
- 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": {
"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"
}