Aller au contenu
Tous les outils

add_contact_to_group

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

Ajoute un contact des Contacts de Microsoft Outlook sous Windows, trouvé par contact_id ou par nom, à un groupe existant, trouvé par son nom exact sans tenir compte de la casse. Le contact doit avoir une adresse e-mail : les groupes d'Outlook contiennent des adresses. Pour un contact déjà dans le groupe, la réponse indique already_in_group: true. Pour créer un groupe, utilisez create_contact_group.

Entrées requises

Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.

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

Exemple documentaire

Exemple de documentation pour add_contact_to_group. 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.

{
  "confirm": false,
  "group_name": "Project team",
  "name": "Alex Rivera"
}