update_contact
Контакты · Windows
Эффект: запись. Статус: условно доступен.
«Условная доступность» означает, что инструмент может зависеть от версии, платформы, разрешений, учётной записи или настроек. Он доступен не во всех установках.
Windows
Назначение
Обновляет контакт в Контактах Microsoft Outlook в Windows, найденный по contact_id или по имени. Указанные имя, фамилия и компания заменяют текущие; указанные телефоны и адреса электронной почты ДОБАВЛЯЮТСЯ (текущие остаются, уже имеющийся номер или адрес пропускается; Outlook хранит до 6 телефонов и 3 адресов, а то, что не помещается, возвращается в not_stored); photo_path заменяет фото. Ничего не удаляется. Имя, совпадающее с несколькими контактами, отклоняется со списком, из которого нужно выбрать contact_id. Заметки не записываются, как и на Mac.
Обязательные входные данные
Схема этой платформы не объявляет обязательных входных данных. Необязательные селекторы или требования среды всё же могут применяться.
Разрешения и подтверждение
Схема объявляет явный параметр подтверждения. Проверьте предварительный результат и разрешите реальную операцию согласно контракту платформы.
- Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.
Каноническая техническая схема на английском — 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"
}