Перейти к содержимому
Все инструменты

update_contact

Контакты · Windows

Эффект: запись. Статус: условно доступен.

«Условная доступность» означает, что инструмент может зависеть от версии, платформы, разрешений, учётной записи или настроек. Он доступен не во всех установках.

Windows

Назначение

Обновляет контакт в Контактах Microsoft Outlook в Windows, найденный по contact_id или по имени. Указанные имя, фамилия и компания заменяют текущие; указанные телефоны и адреса электронной почты ДОБАВЛЯЮТСЯ (текущие остаются, уже имеющийся номер или адрес пропускается; Outlook хранит до 6 телефонов и 3 адресов, а то, что не помещается, возвращается в not_stored); photo_path заменяет фото. Ничего не удаляется. Имя, совпадающее с несколькими контактами, отклоняется со списком, из которого нужно выбрать contact_id. Заметки не записываются, как и на Mac.

Обязательные входные данные

Схема этой платформы не объявляет обязательных входных данных. Необязательные селекторы или требования среды всё же могут применяться.

Разрешения и подтверждение

Схема объявляет явный параметр подтверждения. Проверьте предварительный результат и разрешите реальную операцию согласно контракту платформы.

Каноническая техническая схема на английском — 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"
}

Пример для документации

Пример документации для update_contact. Не выполняйте этот пример. Показанные аргументы относятся к вымышленному набору данных; перед реальным вызовом найдите настоящие идентификаторы и получите разрешение.

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