Обновление контакта
Пространство имен: microsoft.graph
Обновление свойств объекта contact.
Этот API доступен в следующих национальных облачных развертываниях.
Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Разрешения
Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.
Тип разрешения | Разрешения (в порядке повышения привилегий) |
---|---|
Делегированные (рабочая или учебная учетная запись) | Contacts.ReadWrite |
Делегированные (личная учетная запись Майкрософт) | Contacts.ReadWrite |
Для приложений | Contacts.ReadWrite |
HTTP-запрос
Объект contact из стандартной пользовательской папки contactFolder.
PATCH /me/contacts/{id}
PATCH /users/{id | userPrincipalName}/contacts/{id}
Объект contact из пользовательской папки contactFolder верхнего уровня.
PATCH /me/contactFolders/{id}/contacts/{id}
PATCH /users/{id | userPrincipalName}/contactFolders/{id}/contacts/{id}
Объект contact из дочерней папки в папке contactFolder. Приведенный ниже пример показывает один уровень вложенности, но для хранения контакта допускается несколько.
PATCH /me/contactFolders/{id}/childFolders/{id}/.../contacts/{id}
PATCH /users/{id | userPrincipalName}/contactFolders/{id}/childFolders/{id}/contacts/{id}
Заголовки запросов
Заголовок | Значение |
---|---|
Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
Content-Type | application/json. Обязательно. |
Текст запроса
В тексте запроса укажите значения для соответствующих полей, которые необходимо обновить. Предыдущие значения существующих свойств, не включенных в текст запроса, останутся прежними или будут повторно вычислены с учетом измененных значений других свойств. Для достижения оптимальной производительности не включайте существующие значения, которые не изменились.
При обновлении структурированных свойств, таких как homeAddress, необходимо передать полный набор свойств.
Свойство | Тип | Описание |
---|---|---|
assistantName | String | Имя помощника контакта. |
birthday | DateTimeOffset | Дата рождения контакта. |
businessAddress | PhysicalAddress | Рабочий адрес контакта. |
businessHomePage | String | Домашняя страница контакта (рабочая). |
businessPhones | String | Рабочие номера телефонов контакта. |
categories | String | Категории, связанные с контактом. |
children | String | Имена детей контакта. |
CompanyName | String | Название компании контакта. |
department | String | Отдел контакта. |
displayName | String | Отображаемое имя контакта. Обратите внимание, что последующие обновления других свойств могут привести к тому, что автоматически созданное значение перезапишет указанное значение displayName. Чтобы сохранить существующее значение, всегда добавляйте его как displayName в операцию обновления. |
emailAddresses | Коллекция EmailAddress | Электронные адреса контакта. |
fileAs | String | Имя, под которым хранится контакт. |
generation | String | Поколение контакта. |
givenName | String | Имя контакта. |
homeAddress | PhysicalAddress | Домашний адрес контакта. |
homePhones | Коллекция String | Номера домашнего телефона контакта. |
imAddresses | String | Адреса контакта для обмена мгновенными сообщениями. |
initials | String | Инициалы контакта. |
jobTitle | String | Должность контакта. |
manager | String | Имя руководителя контакта. |
middleName | String | Отчество контакта. |
mobilePhone | String | Номер мобильного телефона контакта. |
nickName | String | Псевдоним контакта. |
officeLocation | String | Расположение офиса контакта. |
otherAddress | PhysicalAddress | Другие адреса контакта. |
parentFolderId | String | Идентификатор родительской папки контакта. |
personalNotes | String | Заметки пользователя о контакте. |
profession | String | Профессия контакта. |
spouseName | String | Имя супруга или супруги контакта. |
surname | String | Фамилия контакта. |
title | String | Звание контакта. |
yomiCompanyName | String | Название компании контакта, записанное так, как оно звучит по-японски. Это необязательное свойство. |
yomiGivenName | String | Имя контакта, записанное так, как оно звучит по-японски. Это необязательное свойство. |
yomiSurname | String | Фонетическая японская фамилия (фамилия) контакта. Это необязательное свойство. |
Отклик
В случае успеха этот метод возвратит код отклика 200 OK
и обновленный объект contact в теле отклика.
Примеры
Запрос
Ниже показан пример запроса.
PATCH https://graph.microsoft.com/v1.0/me/contacts/{id}
Content-type: application/json
{
"homeAddress": {
"street": "123 Some street",
"city": "Seattle",
"state": "WA",
"postalCode": "98121"
},
"birthday": "1974-07-22"
}
Отклик
Ниже показан пример отклика.
Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.
HTTP/1.1 200 OK
Content-type: application/json
{
"id": "AAMkAGI2THk0AAA=",
"createdDateTime": "2014-10-19T23:08:24Z",
"lastModifiedDateTime": "2014-10-19T23:08:24Z",
"changeKey": "EQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTIa4",
"categories": [],
"parentFolderId": "AAMkAGI2AAEOAAA=",
"birthday": "1974-07-22",
"fileAs": "Fort, Garth",
"displayName": "Garth Fort",
"givenName": "Garth",
"initials": "G.F.",
"middleName": null,
"nickName": "Garth",
"surname": "Fort",
"title": null,
"yomiGivenName": null,
"yomiSurname": null,
"yomiCompanyName": null,
"generation": null,
"emailAddresses": [
{
"name": "Garth",
"address": "garth@contoso.com"
}
],
"imAddresses": [
"sip:garthf@contoso.com"
],
"jobTitle": "Web Marketing Manager",
"companyName": "Contoso, Inc.",
"department": "Sales & Marketing",
"officeLocation": "20/1101",
"profession": null,
"businessHomePage": "https://www.contoso.com",
"assistantName": null,
"manager": null,
"homePhones": [],
"mobilePhone": null,
"businessPhones": [
"+1 918 555 0101"
],
"homeAddress": {
"street": "123 Some street",
"city": "Seattle",
"state": "WA",
"postalCode": "98121"
},
"businessAddress": {
"street": "10 Contoso Way",
"city": "Redmond",
"state": "WA",
"countryOrRegion": "USA",
"postalCode": "98075"
},
"otherAddress": {},
"spouseName": null,
"personalNotes": null,
"children": []
}
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по