通过

Google 联系人

Google Contacts 是一个在线通讯簿，可跨 Google 产品等集成。

此连接器在以下产品和区域中可用：

服务 Class 区域
Copilot Studio 标准 除以下各项外的所有 Power Automate 区域 ：
     - 美国政府 （GCC）
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
逻辑应用程序 标准 除以下各项外的所有 逻辑应用区域 ：
     - Azure 政府区域
     - Azure 中国区域
     - 美国国防部（DoD）
Power Apps 标准 除以下各项外的所有 Power Apps 区域 ：
     - 美国政府 （GCC）
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
Power Automate 标准 除以下各项外的所有 Power Automate 区域 ：
     - 美国政府 （GCC）
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
联系人​​
Name Microsoft
URL Microsoft LogicApps 支持
Microsoft Power Automate 支持
Microsoft Power Apps 支持
连接器元数据
发布者 Microsoft
网站 https://contacts.google.com/
隐私策略 https://policies.google.com/privacy

若要使用此集成，需要一个 Google 帐户。 如果尚未成为用户， 请注册 新帐户。 尝试建立连接时，系统会提示你对帐户进行身份验证。 如果有多个帐户，请选择要使用的帐户并 登录。 验证后，需要授权Microsoft访问联系人。 单击“ 允许 ”继续。

图像 1

现在，你已准备好开始使用此集成。

已知问题和限制

作“获取我的联系人”当前不支持分页。 它返回最多 1024 个联系人。 如果你有更多联系人，则作仅返回前 1024 个联系人。

重要

从 2021 年 6 月 15 日起，由于 Google 弃用了这些作所使用的终结点，某些作将开始失败。 若要了解详细信息，请参阅 Google 的以下帖子： https://developers.google.com/contacts/v3/announcement

以下作受到影响：

创建联系人; 获取我的联系人; 获取我的联系人 V2;联系人 更改时。

若要避免中断，请使用以下作：

创建联系人 V2; 获取我的联系人 V4;当 联系人更改 V3 时。

限制

名称 调用 续订期
每个连接的 API 调用数 100 60 秒

操作

创建联系人 [已弃用]

此作已弃用。 请改用 “创建联系人 V3 ”。

在 Google 联系人中创建联系人
创建联系人 V2

在 Google 联系人 V2 中创建联系人
创建联系人 V3 （预览版）

在 Google 联系人 V3 中创建联系人
获取我的联系人 [已弃用]

此作已弃用。 请改用 “获取我的联系人 V4 ”。

获取我的联系人。
获取我的联系人 V2 [已弃用]

此作已弃用。 请改用 “获取我的联系人 V4 ”。

获取我的联系人 V2。
获取我的联系人 V3 [已弃用]

此作已弃用。 请改用 “获取我的联系人 V4 ”。

获取我的联系人 V3。
获取我的联系人 V4

获取我的联系人 V4。

创建联系人 [已弃用]

操作 ID:
CreateContact

此作已弃用。 请改用 “创建联系人 V3 ”。

在 Google 联系人中创建联系人

参数

名称 密钥 必需 类型 说明
显示名称
 displayName True string

联系人的显示名称。
工作电子邮件地址
 workEmail string
组
 group string

要向其添加联系人的组。
公司
 company string
工作电话号码
 workPhoneNumber string
移动电话号码
 mobilePhoneNumber string
家庭电子邮件地址
 homeEmail string

联系人的主电子邮件地址。
其他电子邮件地址
 otherEmail string
昵称
 nickName string
家庭地址
 homeAddress string
工作地址
 workAddress string
其他地址
 otherAddress string
职务
 jobTitle string
家庭电话号码
 homePhoneNumber string
其他电话号码
 otherPhoneNumber string
注释
 notes string

返回

名称 路径 类型 说明
输入
 entry Entry

创建联系人 V2

操作 ID:
PeopleApiCreateContactV2

在 Google 联系人 V2 中创建联系人

参数

名称 密钥 必需 类型 说明
名
 givenName True string

联系人的给定名称。
姓
 familyName string

联系人的姓氏。
工作电子邮件地址
 workEmail string
组
 group string

要向其添加联系人的组。
公司
 company string
工作电话号码
 workPhoneNumber string
移动电话号码
 mobilePhoneNumber string
家庭电子邮件地址
 homeEmail string

联系人的主电子邮件地址。
其他电子邮件地址
 otherEmail string
昵称
 nickName string
家庭地址
 homeAddress string
工作地址
 workAddress string
其他地址
 otherAddress string
职务
 jobTitle string
家庭电话号码
 homePhoneNumber string
其他电话号码
 otherPhoneNumber string

返回

Body
PeopleApiConnection

创建联系人 V3 （预览版）

操作 ID:
PeopleApiCreateContactV3

在 Google 联系人 V3 中创建联系人

参数

名称 密钥 必需 类型 说明
名
 givenName True string

联系人的给定名称。
姓
 familyName string

联系人的姓氏。
工作电子邮件地址
 workEmail string
组
 group string

要向其添加联系人的组。
公司
 company string
工作电话号码
 workPhoneNumber string
移动电话号码
 mobilePhoneNumber string
家庭电子邮件地址
 homeEmail string

联系人的主电子邮件地址。
其他电子邮件地址
 otherEmail string
昵称
 nickName string
家庭地址
 homeAddress string
工作地址
 workAddress string
其他地址
 otherAddress string
职务
 jobTitle string
家庭电话号码
 homePhoneNumber string
其他电话号码
 otherPhoneNumber string

返回

Body
PeopleApiConnectionV2

获取我的联系人 [已弃用]

操作 ID:
ListContacts

此作已弃用。 请改用 “获取我的联系人 V4 ”。

获取我的联系人。

返回

名称 路径 类型 说明
联系人​​
 feed.entry array of Entry

获取我的联系人 V2 [已弃用]

操作 ID:
ListContactsV2

此作已弃用。 请改用 “获取我的联系人 V4 ”。

获取我的联系人 V2。

返回

名称 路径 类型 说明
联系人​​
 value array of Entry

获取我的联系人 V3 [已弃用]

操作 ID:
PeopleApiListContactsV3

此作已弃用。 请改用 “获取我的联系人 V4 ”。

获取我的联系人 V3。

返回

名称 路径 类型 说明
connections
 connections array of PeopleApiConnection

获取我的联系人 V4

操作 ID:
PeopleApiListContactsV4

获取我的联系人 V4。

返回

名称 路径 类型 说明
connections
 connections array of PeopleApiConnectionV2

触发器

联系人更改 V2 时 [已弃用]

此作已弃用。 请改用联系人更改 V3。

当联系人在 Google Contacts V2 中更改时。
联系人更改 V3 时

当联系人在 Google Contacts V3 中更改时。
联系人更改时 [已弃用]

当联系人在 Google Contacts 中更改时。

联系人更改 V2 时 [已弃用]

操作 ID:
PeopleApiOnContactUpdatedV2

此作已弃用。 请改用联系人更改 V3。

当联系人在 Google Contacts V2 中更改时。

返回

名称 路径 类型 说明
connections
 connections array of PeopleApiConnection

联系人更改 V3 时

操作 ID:
PeopleApiOnContactUpdatedV3

当联系人在 Google Contacts V3 中更改时。

返回

名称 路径 类型 说明
connections
 connections array of PeopleApiConnectionV2

联系人更改时 [已弃用]

操作 ID:
OnContactUpdated

当联系人在 Google Contacts 中更改时。

返回

名称 路径 类型 说明
输入
 feed.entry array of Entry

定义

项

名称 路径 类型 说明
Id
 id.$t string

联系人的 ID。
更新的 DateTime
 updated.$t date-time

上次更新联系人的日期/时间，在 yyyy-MM-ddTHH：mm：ss.fffZ （2016-07-20T08：00：59.000Z） 中。
Title
 title.$t string

联系人的职务。
完整姓名
 gd$name.gd$fullName.$t string

联系人的全名。
名
 gd$name.gd$givenName.$t string

联系人的给定名称。
姓氏
 gd$name.gd$familyName.$t string

联系人的系列名称。
昵称
 gContact$nickname.$t string

联系人的昵称。
gd$organization
 gd$organization array of object
Name
 gd$organization.gd$orgName.$t string

组织名称。
Title
 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

名称 路径 类型 说明
Id
 metadata.source.id string

联系人的 ID。
更新的 DateTime
 metadata.source.updatedTime date-time

上次更新联系人的日期/时间，在 yyyy-MM-ddTHH：mm：ss.fffZ （2016-07-20T08：00：59.000Z） 中。
完整姓名
 name.displayName string

联系人的全名。
名
 name.givenName string

联系人的给定名称。
姓
 name.familyName string

联系人的系列名称。
昵称
 nickname.value string

联系人的昵称。
组织
 organizations array of object
Name
 organizations.name string

组织名称。
Title
 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

名称 路径 类型 说明
Id
 metadata.source.id string

联系人的 ID。
更新的 DateTime
 metadata.source.updateTime date-time

上次更新联系人的日期/时间，在 yyyy-MM-ddTHH：mm：ss.fffZ （2016-07-20T08：00：59.000Z） 中。
完整姓名
 name.displayName string

联系人的全名。
名
 name.givenName string

联系人的给定名称。
姓
 name.familyName string

联系人的系列名称。
昵称
 nickname.value string

联系人的昵称。
组织
 organizations array of object
Name
 organizations.name string

组织名称。
Title
 organizations.title string

组织标题。
地址
 addresses array of object
地址
 addresses.formattedValue string

联系人的地址。
电子邮件地址
 emailAddresses array of object
Email
 emailAddresses.value string

联系人的电子邮件地址。
类型
 emailAddresses.formattedType string

联系人的电子邮件地址类型。
电话号码
 phoneNumbers array of object
电话号码
 phoneNumbers.value string

联系人的电话号码。
类型
 phoneNumbers.formattedType string

联系人的电话号码。