Vai al contenuto
Tutti gli strumenti

add_contact_to_group

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

Aggiunge un contatto dei Contatti di Microsoft Outlook su Windows, trovato tramite contact_id o per nome, a un gruppo esistente, trovato per nome esatto senza distinguere maiuscole e minuscole. Il contatto deve avere un indirizzo email: i gruppi di Outlook contengono indirizzi. Se il contatto è già nel gruppo, la risposta riporta already_in_group: true. Per creare un gruppo, usa create_contact_group.

Input obbligatori

I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.

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

Esempio documentale

Esempio di documentazione per add_contact_to_group. 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.

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