Контакты Google
Google Contacts — это адресная книга в Интернете, интегрированная в продукты Google и многое другое.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Стандарт | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Стандарт | Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD) |
| Power Apps | Стандарт | Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Стандарт | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Контакт | |
|---|---|
| Имя | Microsoft |
| URL |
Поддержка Microsoft LogicApps Поддержка Microsoft Power Automate Поддержка Microsoft Power Apps |
| Метаданные соединителя | |
|---|---|
| Publisher | Microsoft |
| Веб-сайт | https://contacts.google.com/ |
| Политика конфиденциальности | https://policies.google.com/privacy |
Чтобы использовать эту интеграцию, вам потребуется учетная запись Google. Если вы еще не являетесь пользователем, зарегистрируйтесь для новой учетной записи. При попытке подключиться вам будет предложено пройти проверку подлинности в вашей учетной записи. Если у вас несколько учетных записей, выберите нужный и войдите. После проверки вам потребуется авторизовать корпорацию Майкрософт для доступа к контактам. Нажмите кнопку "Разрешить продолжить".
Теперь вы готовы начать использовать эту интеграцию.
Известные проблемы и ограничения
Действие "Получить мои контакты" в настоящее время не поддерживает разбиение на страницы. Он возвращает максимум 1024 контактов. Если у вас есть больше контактов, будет возвращено только первое значение 1024.
Это важно
Начиная с 15 июня 2021 г. некоторые действия начнут завершать сбой из-за нерекомендуемого использования конечных точек Google. Чтобы узнать об этом больше, см. следующую запись из Google: https://developers.google.com/contacts/v3/announcement
Затронуты следующие действия:
Создание контакта; Получение моих контактов; Получение моих контактов версии 2; и при изменении контакта.
Чтобы избежать прерываний, используйте следующие действия:
Создание контакта версии 2; Получение моих контактов версии 4; и при изменении контакта версии 3.
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Получение моих контактов [DEPRECATED] |
Это действие устарело. Вместо этого используйте мои контакты версии 4 .
|
| Получение моих контактов версии 2 [НЕ РЕКОМЕНДУЕТСЯ] |
Это действие устарело. Вместо этого используйте мои контакты версии 4 .
|
| Получение моих контактов версии 3 [НЕ РЕКОМЕНДУЕТСЯ] |
Это действие устарело. Вместо этого используйте мои контакты версии 4 .
|
| Получение моих контактов версии 4 |
Получите мои контакты версии 4. |
| Создание контакта [DEPRECATED] |
Это действие устарело. Вместо этого используйте контакт версии 3 .
|
| Создание контакта версии 2 |
Создание контакта в Google Contacts версии 2 |
| Создание контакта версии 3 (предварительная версия) |
Создание контакта в Google Contacts версии 3 |
Получение моих контактов [DEPRECATED]
Это действие устарело. Вместо этого используйте мои контакты версии 4 .
Получите мои контакты.
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Контакт
|
feed.entry | array of Entry |
Получение моих контактов версии 2 [НЕ РЕКОМЕНДУЕТСЯ]
Это действие устарело. Вместо этого используйте мои контакты версии 4 .
Получите мои контакты версии 2.
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Контакт
|
value | array of Entry |
Получение моих контактов версии 3 [НЕ РЕКОМЕНДУЕТСЯ]
Это действие устарело. Вместо этого используйте мои контакты версии 4 .
Получите мои контакты версии 3.
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
connections
|
connections | array of PeopleApiConnection |
Получение моих контактов версии 4
Получите мои контакты версии 4.
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
connections
|
connections | array of PeopleApiConnectionV2 |
Создание контакта [DEPRECATED]
Это действие устарело. Вместо этого используйте контакт версии 3 .
Создание контакта в Google Contacts
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Отображаемое имя
|
displayName | True | string |
Отображаемое имя контакта. |
|
Рабочий адрес электронной почты
|
workEmail | string | ||
|
Группа
|
group | string |
Группировать, чтобы добавить контакт в. |
|
|
Компания
|
company | string | ||
|
Рабочий номер телефона
|
workPhoneNumber | string | ||
|
Номер мобильного телефона
|
mobilePhoneNumber | string | ||
|
Адрес домашней электронной почты
|
homeEmail | string |
Адрес домашней электронной почты для контакта. |
|
|
Другой адрес электронной почты
|
otherEmail | string | ||
|
Nickname
|
nickName | string | ||
|
Домашний адрес
|
homeAddress | string | ||
|
Рабочий адрес
|
workAddress | string | ||
|
Другой адрес
|
otherAddress | string | ||
|
Должность
|
jobTitle | string | ||
|
Номер домашнего телефона
|
homePhoneNumber | string | ||
|
Другой номер телефона
|
otherPhoneNumber | string | ||
|
Примечания.
|
notes | string |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
entry
|
entry | Entry |
Создание контакта версии 2
Создание контакта в Google Contacts версии 2
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Заданное имя
|
givenName | True | string |
Заданное имя контакта. |
|
Фамилия
|
familyName | string |
Имя семьи для контакта. |
|
|
Рабочий адрес электронной почты
|
workEmail | string | ||
|
Группа
|
group | string |
Группировать, чтобы добавить контакт в. |
|
|
Компания
|
company | string | ||
|
Рабочий номер телефона
|
workPhoneNumber | string | ||
|
Номер мобильного телефона
|
mobilePhoneNumber | string | ||
|
Адрес домашней электронной почты
|
homeEmail | string |
Адрес домашней электронной почты для контакта. |
|
|
Другой адрес электронной почты
|
otherEmail | string | ||
|
Nickname
|
nickName | string | ||
|
Домашний адрес
|
homeAddress | string | ||
|
Рабочий адрес
|
workAddress | string | ||
|
Другой адрес
|
otherAddress | string | ||
|
Должность
|
jobTitle | string | ||
|
Номер домашнего телефона
|
homePhoneNumber | string | ||
|
Другой номер телефона
|
otherPhoneNumber | string |
Возвращаемое значение
- Тело
- PeopleApiConnection
Создание контакта версии 3 (предварительная версия)
Создание контакта в Google Contacts версии 3
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Заданное имя
|
givenName | True | string |
Заданное имя контакта. |
|
Фамилия
|
familyName | string |
Имя семьи для контакта. |
|
|
Рабочий адрес электронной почты
|
workEmail | string | ||
|
Группа
|
group | string |
Группировать, чтобы добавить контакт в. |
|
|
Компания
|
company | string | ||
|
Рабочий номер телефона
|
workPhoneNumber | string | ||
|
Номер мобильного телефона
|
mobilePhoneNumber | string | ||
|
Адрес домашней электронной почты
|
homeEmail | string |
Адрес домашней электронной почты для контакта. |
|
|
Другой адрес электронной почты
|
otherEmail | string | ||
|
Nickname
|
nickName | string | ||
|
Домашний адрес
|
homeAddress | string | ||
|
Рабочий адрес
|
workAddress | string | ||
|
Другой адрес
|
otherAddress | string | ||
|
Должность
|
jobTitle | string | ||
|
Номер домашнего телефона
|
homePhoneNumber | string | ||
|
Другой номер телефона
|
otherPhoneNumber | string |
Возвращаемое значение
Триггеры
| При изменении контакта [не рекомендуется] |
При изменении контакта в Google Contact. |
| При изменении контакта версии 2 [не рекомендуется] |
Это действие устарело. Используйте, если вместо этого изменится контакт версии 3 .
|
| При изменении контакта версии 3 |
При изменении контакта в Google Contact Версии 3. |
При изменении контакта [не рекомендуется]
При изменении контакта в Google Contact.
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
entry
|
feed.entry | array of Entry |
При изменении контакта версии 2 [не рекомендуется]
Это действие устарело. Используйте, если вместо этого изменится контакт версии 3 .
При изменении контакта в Google Contacts версии 2.
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
connections
|
connections | array of PeopleApiConnection |
При изменении контакта версии 3
При изменении контакта в Google Contact Версии 3.
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
connections
|
connections | array of PeopleApiConnectionV2 |
Определения
Entry
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор
|
id.$t | string |
Идентификатор контакта. |
|
Обновлено DateTime
|
updated.$t | date-time |
Дата последнего обновления контакта в y-MM-ddTHH:mm:ss.fffZ (2016-07-20T08:00:59.000Z). |
|
Название
|
title.$t | string |
Название задания контакта. |
|
Полное имя
|
gd$name.gd$fullName.$t | string |
Полное имя контакта. |
|
Заданное имя
|
gd$name.gd$givenName.$t | string |
Заданное имя контакта. |
|
Фамилия
|
gd$name.gd$familyName.$t | string |
Имя семьи контакта. |
|
Nickname
|
gContact$nickname.$t | string |
Прозвище контакта. |
|
gd$organization
|
gd$organization | array of object | |
|
Имя
|
gd$organization.gd$orgName.$t | string |
Имя origanization. |
|
Название
|
gd$organization.gd$orgTitle.$t | string |
Название организации. |
|
Рабочий адрес электронной почты
|
workEmail | string |
Рабочий адрес электронной почты контакта. |
|
Домашняя электронная почта
|
homeEmail | string |
Домашний адрес контакта. |
|
Другие сообщения электронной почты
|
otherEmail | string |
Другой адрес контакта. |
|
Рабочий номер телефона
|
workPhoneNumber | string |
Рабочий номер телефона контакта. |
|
Номер домашнего телефона
|
homePhoneNumber | string |
Номер домашнего телефона контакта. |
|
Другой номер телефона
|
otherPhoneNumber | string |
Другой номер телефона контакта. |
|
Номер мобильного телефона
|
mobilePhoneNumber | string |
Номер мобильного телефона контакта. |
|
Рабочий адрес
|
workAddress | string |
Рабочий адрес контакта. |
|
Домашний адрес
|
homeAddress | string |
Домашний адрес контакта. |
|
Другой адрес
|
otherAddress | string |
Другой адрес контакта. |
PeopleApiConnection
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор
|
metadata.source.id | string |
Идентификатор контакта. |
|
Обновлено DateTime
|
metadata.source.updatedTime | date-time |
Дата последнего обновления контакта в y-MM-ddTHH:mm:ss.fffZ (2016-07-20T08:00:59.000Z). |
|
Полное имя
|
name.displayName | string |
Полное имя контакта. |
|
Заданное имя
|
name.givenName | string |
Заданное имя контакта. |
|
Фамилия
|
name.familyName | string |
Имя семьи контакта. |
|
Nickname
|
nickname.value | string |
Прозвище контакта. |
|
organizations
|
organizations | array of object | |
|
Имя
|
organizations.name | string |
Имя origanization. |
|
Название
|
organizations.title | string |
Название организации. |
|
Рабочий адрес
|
addressesObject.work.formattedValue | string |
Рабочий адрес контакта. |
|
Домашний адрес
|
addressesObject.home.formattedValue | string |
Домашний адрес контакта. |
|
Другой адрес
|
addressesObject.other.formattedValue | string |
Другой адрес контакта. |
|
Рабочий адрес электронной почты
|
emailAddressesObject.work.value | string |
Рабочий адрес электронной почты контакта. |
|
Домашняя электронная почта
|
emailAddressesObject.home.value | string |
Адрес домашней электронной почты контакта. |
|
Другие сообщения электронной почты
|
emailAddressesObject.other.value | string |
Другой адрес электронной почты контакта. |
|
Рабочий номер телефона
|
phoneNumbersObject.work.value | string |
Рабочий номер телефона контакта. |
|
Номер домашнего телефона
|
phoneNumbersObject.home.value | string |
Номер домашнего телефона контакта. |
|
Номер мобильного телефона
|
phoneNumbersObject.mobile.value | string |
Номер мобильного телефона контакта. |
|
Другой номер телефона
|
phoneNumbersObject.other.value | string |
Другой номер телефона контакта. |
PeopleApiConnectionV2
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор
|
metadata.source.id | string |
Идентификатор контакта. |
|
Обновлено DateTime
|
metadata.source.updateTime | date-time |
Дата последнего обновления контакта в y-MM-ddTHH:mm:ss.fffZ (2016-07-20T08:00:59.000Z). |
|
Полное имя
|
name.displayName | string |
Полное имя контакта. |
|
Заданное имя
|
name.givenName | string |
Заданное имя контакта. |
|
Фамилия
|
name.familyName | string |
Имя семьи контакта. |
|
Nickname
|
nickname.value | string |
Прозвище контакта. |
|
organizations
|
organizations | array of object | |
|
Имя
|
organizations.name | string |
Имя origanization. |
|
Название
|
organizations.title | string |
Название организации. |
|
addresses
|
addresses | array of object | |
|
Address
|
addresses.formattedValue | string |
Адрес контакта. |
|
emailАдреса
|
emailAddresses | array of object | |
|
Адрес электронной почты
|
emailAddresses.value | string |
Адрес электронной почты контакта. |
|
Тип
|
emailAddresses.formattedType | string |
Тип адреса электронной почты контакта. |
|
Телефонные номера
|
phoneNumbers | array of object | |
|
Номер телефона
|
phoneNumbers.value | string |
Номер телефона контакта. |
|
Тип
|
phoneNumbers.formattedType | string |
Номер телефона контакта. |