Aller au contenu
Tous les outils

update_contact

Contacts · Windows

Effet: écriture. État: disponibilité conditionnelle.

«Disponibilité conditionnelle» signifie que l’outil peut dépendre de la version, de la plateforme, des autorisations, du compte ou de la configuration. Il n’est pas forcément actif partout.

Windows

Objectif

Met à jour un contact des Contacts de Microsoft Outlook sous Windows, trouvé par contact_id ou par nom. Le prénom, le nom et l'entreprise fournis remplacent ceux qu'il a ; les téléphones et e-mails fournis sont AJOUTÉS (ceux qu'il a restent, et un numéro ou une adresse qu'il a déjà est ignoré ; Outlook conserve jusqu'à 6 téléphones et 3 e-mails, et ce qui ne tient pas est renvoyé dans not_stored) ; photo_path remplace la photo. Rien n'est supprimé. Un nom qui correspond à plusieurs contacts est refusé avec la liste pour choisir un contact_id. Les notes ne sont pas écrites, comme sur le Mac.

Entrées requises

Le schéma de cette plateforme ne déclare aucune entrée requise. Des sélecteurs facultatifs ou des conditions d’exécution peuvent néanmoins exister.

Autorisations et confirmation

Le schéma déclare un paramètre de confirmation explicite. Vérifiez l’aperçu et autorisez l’opération réelle conformément au contrat de la plateforme.

Schéma technique canonique en anglais — 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"
}

Exemple documentaire

Exemple de documentation pour update_contact. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.

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