add_contact_to_group

Contactos · Windows

Efecto: escritura. Estado: disponibilidad controlada.

«Disponibilidad controlada» significa que la herramienta figura en los artefactos publicados y puede depender de versión, plataforma, permisos, cuenta o configuración. Esta referencia no promete que esté activa en todas las instalaciones. Que una herramienta figure para macOS no implica que esté disponible en Windows, ni al revés.

Windows

Propósito

Agrega un contacto de los Contactos de Microsoft Outlook en Windows, buscado por contact_id o por nombre, a un grupo existente, buscado por su nombre exacto sin distinguir mayúsculas. El contacto necesita una dirección de correo: los grupos de Outlook guardan direcciones. Si el contacto ya está en el grupo, la respuesta dice already_in_group: true. Para crear un grupo, usa create_contact_group.

Entradas obligatorias

group_name

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema declara un parámetro explícito de confirmación. Revisa la vista previa y autoriza la operación real según el contrato de esta plataforma.

Utilice únicamente las aplicaciones, cuentas y recursos autorizados por el usuario en esta plataforma. Consulte la descripción específica de la plataforma de esta herramienta para conocer sus requisitos de conexión y permisos. Este catálogo no afirma alcances OAuth adicionales ni derechos de sistema operativo.

Esquema técnico canónico en inglés — 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"
}

Ejemplo documental

Ejemplo de documentación para add_contact_to_group. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

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