Vai al contenuto
Tutti gli strumenti

update_contact

Contatti · Windows

Effetto: scrittura. Stato: disponibilità condizionata.

«Disponibilità condizionata» indica che lo strumento può dipendere da versione, piattaforma, autorizzazioni, account o configurazione. Non è necessariamente attivo ovunque.

Windows

Scopo

Aggiorna un contatto nei Contatti di Microsoft Outlook su Windows, trovato tramite contact_id o per nome. Nome, cognome e azienda indicati sostituiscono quelli presenti; telefoni ed email indicati vengono AGGIUNTI (quelli presenti restano, e un numero o un indirizzo già presente viene saltato; Outlook conserva fino a 6 telefoni e 3 email, e ciò che non ci sta torna in not_stored); photo_path sostituisce la foto. Non viene rimosso nulla. Un nome che corrisponde a più contatti viene rifiutato con l'elenco da cui scegliere un contact_id. Le note non vengono scritte, come sul Mac.

Input obbligatori

Lo schema di questa piattaforma non dichiara input obbligatori. Possono comunque esistere selettori facoltativi o requisiti di esecuzione.

Autorizzazioni e conferma

Lo schema dichiara un parametro di conferma esplicito. Controlla l’anteprima e autorizza l’operazione reale secondo il contratto della piattaforma.

Schema tecnico canonico in inglese — 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"
}

Esempio documentale

Esempio di documentazione per update_contact. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

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