Обновление контакта — Microsoft Graph v1.0
Изменить
Twitter LinkedIn Facebook Адрес электронной почты
- Статья
- Чтение занимает 4 мин
Пространство имен: microsoft.
graph
Обновление свойств объекта contact.
Разрешения
Для вызова этого 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. Обязательный. |
Текст запроса
В тексте запроса укажите значения для соответствующих полей, которые необходимо обновить. Предыдущие значения существующих свойств, не включенных в текст запроса, останутся прежними или будут повторно вычислены с учетом измененных значений других свойств. Для достижения оптимальной производительности не следует включать существующие значения, которые не изменились.
| Свойство | Тип | Описание |
|---|---|---|
| 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 | Имя контакта. | |
| 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 | Фамилия контакта, записанная так, как она звучит по-японски. Это необязательное свойство. |
Отклик
В случае успеха этот метод возвратит код отклика 200 OK и обновленный объект contact в теле отклика.
Пример
Запрос
Ниже приведен пример запроса.
- HTTP
- C#
- JavaScript
- Objective-C
- Java
- Go
- PowerShell
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": "[email protected]"
}
],
"imAddresses": [
"sip:[email protected]"
],
"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": []
}
Обратная связь
Просмотреть все отзывы по странице
|
Обновлено и расширено содержание: представлена более подробная информация по выпускаемой продукции, добавлено множество иллюстраций, выложены руководства по эксплуатации, рекламные материалы и пр. CRM | Контакты
В HubSpot контакты хранят информацию об отдельных людях, взаимодействующих с вашим бизнесом.
Конечные точки контактов позволяют создавать и управлять записями контактов в вашей учетной записи HubSpot, а также синхронизировать данные контактов между HubSpot и другими системами.
Узнайте больше об объектах, записях, свойствах и API-интерфейсах ассоциаций в руководстве Общие сведения о CRM. Для получения более общей информации об объектах и записях в HubSpot узнайте, как управлять базой данных CRM.
Чтобы создать новые контакты, отправьте запрос POST на адрес /crm/v3/objects/contacts . В своем запросе включите свои контактные данные в объект свойств.
Обратите внимание, : вы не можете создать контакт и связать его с записью или действием в том же запросе. Чтобы связать контакт с другими записями или действиями, создайте контакт, затем обновите его или создайте ассоциацию с помощью API ассоциаций.
Характеристики
Сведения о контакте хранятся в свойствах контакта. Существуют свойства контактов HubSpot по умолчанию, но вы также можете создавать собственные свойства контактов.
При создании нового контакта вы должны включить в запрос хотя бы одно из следующих свойств: электронная почта , имя или фамилия . Рекомендуется всегда указывать адрес электронной почты , так как адрес электронной почты является основным уникальным идентификатором, чтобы избежать дублирования контактов в HubSpot.
Чтобы просмотреть все доступные свойства, вы можете получить список свойств контактов вашей учетной записи, отправив запрос GET на адрес /crm/v3/properties/contacts . Узнайте больше об API свойств.
Обратите внимание, : если вы включили в запрос этап жизненного цикла , значения должны относиться к внутреннему имени этапа жизненного цикла. Внутренние имена стадий по умолчанию являются текстовыми значениями и не меняются, даже если вы редактируете метку стадии (например, 9).0007 подписчик или marketingqualifiedlead ).
Внутренние имена пользовательских стадий представляют собой числовые значения. Вы можете найти внутренний идентификатор этапа в настройках этапа жизненного цикла или получить свойство этапа жизненного цикла через API.
Например, чтобы создать новый контакт, ваш запрос может выглядеть следующим образом:
///Пример тела запроса { «характеристики»: { «электронная почта»: «[email protected]», «имя»: «Джейн», «lastname»: «Доу», «телефон»: «(555) 555-5555», «компания»: «HubSpot», «веб-сайт»: «hubspot.com», «lifecyclestage»: «marketingqualifiedlead» } } Вы можете получать контакты по отдельности или группами. Чтобы получить отдельный контакт, отправьте запрос GET на адрес /crm/v3/objects/contacts/{contactId} .
Чтобы запросить список всех контактов, отправьте GET запрос на /crm/v3/objects/contacts .
Для обеих конечных точек в URL-адрес запроса можно включить следующие параметры запроса:
| Параметр | Описание |
|---|---|
| Список свойств, разделенных запятыми, которые должны быть возвращены в ответе. |
| Список объектов, разделенных запятыми, для которых необходимо получить связанные идентификаторы. Любые указанные ассоциации, которые не существуют, не будут возвращены в ответе. Узнайте больше об API ассоциаций. |
Если запрошенный контакт не имеет значения свойства, он не будет отображаться в ответе. Например, чтобы получить контакты с их адресами электронной почты и связанными компаниями, ваш URL-адрес запроса будет выглядеть так: https://api.hubspot.com/crm/v3/objects/contacts?properties=email&associations= компании .
Узнайте больше о получении контактов, щелкнув вкладку Конечные точки в верхней части этой статьи.
Вы можете обновлять контакты по отдельности или в пакетном режиме. Для существующих контактов адрес электронной почты и идентификатор контакта являются уникальными значениями, поэтому вы можете использовать либо электронная почта или id для обновления контакта через API.
Чтобы обновить отдельный контакт по его идентификатору контакта, отправьте запрос PATCH на адрес /crm/v3/objects/contacts/{contactId} и включите данные, которые вы хотите обновить.
Обратите внимание, : параметр запроса idProperty не отображается на вкладке Конечные точки из-за технических ограничений, но его можно использовать исключительно для контактов с адресом электронной почты . Чтобы использовать адрес электронной почты в качестве уникального идентификатора, установите idProperty как электронная почта и введите адрес электронной почты вместо идентификатора контакта. Это должно быть установлено как параметр запроса, а не добавлено в тело запроса.
Чтобы связать контакт с другими записями CRM или действием, сделайте запрос PUT на адрес /crm/v3/objects/contacts/{contactId}/associations/{toObjectType}/{toObjectId}/{associationTypeId} .
Чтобы получить значение AssociationTypeId , выполните запрос GET на /crm/v4/associations/{fromObjectType}/{toObjectType}/labels .
Узнайте больше об API ассоциаций.
Удалить связь
Чтобы удалить связь между контактом и записью или действием, сделайте запрос DELETE по следующему URL-адресу: /crm/v3/objects/contacts/{contactID}/associations/{toObjectType}/{toObjectId}/ {ассоциатионтипеид} .
Вы можете удалять контакты по отдельности или группами, что приведет к добавлению контакта в корзину для мусора в HubSpot. Позже вы сможете восстановить контакт в HubSpot.
Чтобы удалить отдельный контакт по его идентификатору, отправьте DELETE запрос на /crm/v3/objects/contacts/{contactId} .
Узнайте больше о пакетном удалении контактов на вкладке Конечные точки в верхней части этой статьи.
Ограничения
Пакетные операции по созданию, обновлению и архивированию ограничены пакетами из 100. Также существуют ограничения на отправку контактов и форм.
Поделитесь своим отзывом
Была ли эта статья полезна? Да Нет Извините, для работы этой формы обратной связи требуется JavaScript.Эта форма используется только для обратной связи по документации. Узнайте, как получить помощь с HubSpot.
Обновление контактной информации
Чтобы обновить информацию, выполните следующие действия:
- Соберите самую актуальную информацию, в том числе о вас имя, домашний адрес, почтовый адрес, номер телефона и адрес электронной почты . Также подготовьте свой номер социального страхования или номер дела Medicaid для подтверждения вашей личности.
- Выберите свой округ в раскрывающемся списке ниже.
- У вас есть три варианта обновления информации. Вы можете обратиться непосредственно на горячую линию для потребителей Medicaid в штате Огайо, связаться с работником, ведущим ваше дело, через местный отдел по трудоустройству и семейным услугам, или, если у вас есть учетная запись самообслуживания по льготам в штате Огайо, вы можете сообщить об изменении через онлайн-портал.
*Если вам необходимо изменить или обновить свое имя, обратите внимание, что вам необходимо обратиться в местный офис JFS или воспользоваться порталом самообслуживания пособий штата Огайо. Вы не сможете изменить или обновить свое имя, обратившись на горячую линию Medicaid штата Огайо для потребителей.
Горячая линия Medicaid для потребителей штата Огайо Все лица могут позвонить на горячую линию Medicaid для потребителей штата Огайо, чтобы обновить свою контактную информацию, включая домашний адрес, почтовый адрес, номер телефона и адрес электронной почты.
Если вам необходимо обновить или изменить свое имя, вам необходимо обратиться в местный офис JFS или воспользоваться порталом самообслуживания пособий штата Огайо.
Номер телефона: 1-800-324-8680
Часы работы: Понедельник – Пятница: 7:00 – 20:00, Суббота: 8:00 – 17:00
В каком округе вы живете?
SelectAdamsAllenAshlandAshtabulaAthensAuglaizeBelmontBrownButlerCarrollChampaignClarkClermontClintonColumbianaCoshoctonCrawfordCuyahogaDarkeDefianceDelawareErieFairfieldFayetteFranklinFultonGalliaGeaugaGreeneGuernseyHamiltonHancockHardinHarrisonHenryHighlandHockingHolmesHuronJacksonJeffersonKnoxLakeLawrenceLickingLoganLorainLucasMadisonMahoningMarionMedinaMeigsMercerMiamiMonroeMontgomeryMorganMorrowMuskingumNobleOttawaPauldingPerryPickawayPikePortagePreblePutnamRichlandRossSanduskySciotoSenecaShelbyStarkSummitTrumbullTuscarawasUnionVan WertVintonWarrenWashingtonWayneWilliamsWoodWyandot
Часто задаваемые вопросы
Что мне нужно сделать?
Получателям Medicaid необходимо обновить свою контактную информацию или проверить правильность текущей контактной информации.
Вы можете сделать это одним из следующих способов:
- Позвонить на горячую линию Medicaid для потребителей штата Огайо: Горячая линия для потребителей Medicaid штата Огайо свяжет вас с представителем, который поможет вам обновить вашу контактную информацию. Горячая линия Medicaid штата Огайо доступна с понедельника по пятницу с 7:00 до 20:00, а также в субботу с 8:00 до 17:00 по телефону 1-800-324-8680.
- Интернет-портал : Если у вас есть учетная запись на портале самообслуживания пособий штата Огайо, вы можете войти в систему и сообщить об изменениях своей контактной информации.
- Обратитесь в местный офис JFS . Самый лучший и простой вариант — обратиться в Департамент по трудоустройству и семейным делам вашего округа. Вы поговорите напрямую с куратором, который сможет обновить вашу информацию. Это самый быстрый и простой способ сообщить об изменении вашей контактной информации или проверить ее актуальность.
Убедитесь, что ваша контактная информация в штате является полной и актуальной, чтобы не пропустить грядущие важные изменения, связанные с вашими льготами Medicaid.
Я недавно зарегистрировался в Medicaid; мне все еще нужно обновить мою информацию?
Если вы недавно зарегистрировались в программе Medicaid и ваши демографические или контактные данные не изменились, вам не нужно ничего делать. Вы находитесь в нашем списке рассылки и будете получать информацию о предстоящих интересных изменениях, поскольку мы готовимся к запуску следующего поколения управляемого медицинского обслуживания Medicaid.
Могу ли я связаться со своим планом управляемого медицинского обслуживания, чтобы обновить свою информацию?
Центры услуг Medicare и Medicaid (CMS) требуют, чтобы все, у кого есть страховка Medicaid, обновляли свою личную информацию в назначенных организациях. В штате Огайо вы можете обратиться к сотруднику Департамента по трудоустройству и семейным делам вашего округа или воспользоваться онлайн-системой регистрации штата, порталом самообслуживания пособий штата Огайо.