update_contact

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

Actualiza un contacto de los Contactos de Microsoft Outlook en Windows, buscado por contact_id o por nombre. El nombre, el apellido y la empresa que se indiquen reemplazan los que tiene; los teléfonos y correos que se indiquen se AGREGAN (los que tiene se quedan, y un número o una dirección que ya tiene se omite; Outlook guarda hasta 6 teléfonos y 3 correos, y lo que no entra vuelve en not_stored); photo_path reemplaza la foto. No se borra nada. Un nombre que coincide con varios contactos se rechaza con la lista para elegir un contact_id. Las notas no se escriben, igual que en la Mac.

Entradas obligatorias

El esquema de esta plataforma no declara entradas obligatorias. Aun así, pueden existir selectores opcionales o requisitos de ejecución.

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

Ejemplo documental

Ejemplo de documentación para update_contact. 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.

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