共用方式為

Google 通訊錄

Google 通訊錄是一個在線通訊錄，集成在您的 Google 產品等中。

此連接器適用於以下產品和區域：

服務 Class Regions
副駕駛工作室 標準 除下列區域外的所有 Power Automate 區域 ：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
邏輯應用程式 標準 所有 Logic Apps 區域， 但下列區域除外：
     - Azure Government 區域
     - Azure 中國區域
     - 美國國防部 （DoD）
Power Apps 標準 除下列區域外的所有 Power Apps 區域 ：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
Power Automate（自動化服務） 標準 除下列區域外的所有 Power Automate 區域 ：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
連絡人​​
名稱 Microsoft
URL Microsoft LogicApps 支援
Microsoft Power Automate 支援
Microsoft Power Apps 支援
連接器中繼資料
Publisher 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 秒

動作

取得我的聯絡人 [已淘汰]

此動作已被取代。 請改用 [取得我的聯絡人 V4 ]。

取得我的聯絡人。
取得我的聯絡人 V2 [已棄用]

此動作已被取代。 請改用 [取得我的聯絡人 V4 ]。

取得我的聯絡人 V2。
取得我的聯絡人 V3 [已棄用]

此動作已被取代。 請改用 [取得我的聯絡人 V4 ]。

取得我的聯絡人 V3。
取得我的聯絡人 V4

獲取我的聯繫人 V4。
建立聯絡人 [已棄用]

此動作已被取代。 請改用 建立聯絡人 V3 。

在 Google 通訊錄中建立聯絡人
建立聯絡人 V2

在 Google 通訊錄 V2 中建立聯絡人
建立連絡人 V3 （預覽版）

在 Google 通訊錄 V3 中建立聯絡人

取得我的聯絡人 [已淘汰]

作業識別碼：
ListContacts

此動作已被取代。 請改用 [取得我的聯絡人 V4 ]。

取得我的聯絡人。

傳回

名稱 路徑 類型 Description
連絡人​​
 feed.entry array of Entry

取得我的聯絡人 V2 [已棄用]

作業識別碼：
ListContactsV2

此動作已被取代。 請改用 [取得我的聯絡人 V4 ]。

取得我的聯絡人 V2。

傳回

名稱 路徑 類型 Description
連絡人​​
 value array of Entry

取得我的聯絡人 V3 [已棄用]

作業識別碼：
PeopleApiListContactsV3

此動作已被取代。 請改用 [取得我的聯絡人 V4 ]。

取得我的聯絡人 V3。

傳回

名稱 路徑 類型 Description
connections
 connections array of PeopleApiConnection

取得我的聯絡人 V4

作業識別碼：
PeopleApiListContactsV4

獲取我的聯繫人 V4。

傳回

名稱 路徑 類型 Description
connections
 connections array of PeopleApiConnectionV2

建立聯絡人 [已棄用]

作業識別碼：
CreateContact

此動作已被取代。 請改用 建立聯絡人 V3 。

在 Google 通訊錄中建立聯絡人

參數

名稱 機碼 必要 類型 Description
顯示名稱
 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

傳回

名稱 路徑 類型 Description
輸入
 entry Entry

建立聯絡人 V2

作業識別碼：
PeopleApiCreateContactV2

在 Google 通訊錄 V2 中建立聯絡人

參數

名稱 機碼 必要 類型 Description
名字
 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

傳回

身體
PeopleApiConnection

建立連絡人 V3 （預覽版）

作業識別碼：
PeopleApiCreateContactV3

在 Google 通訊錄 V3 中建立聯絡人

參數

名稱 機碼 必要 類型 Description
名字
 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

傳回

身體
PeopleApiConnectionV2

觸發程序

當聯絡人變更 V2 時 [已棄用]

此動作已被取代。 請改用 When a contact changes V3 。

當聯絡人在 Google 通訊錄 V2 中發生變化時。
當聯絡人變更 V3 時

當聯絡人在 Google 通訊錄 V3 中發生變化時。
當聯絡人變更時 [已棄用]

當聯絡人在 Google 通訊錄中變更時。

當聯絡人變更 V2 時 [已棄用]

作業識別碼：
PeopleApiOnContactUpdatedV2

此動作已被取代。 請改用 When a contact changes V3 。

當聯絡人在 Google 通訊錄 V2 中發生變化時。

傳回

名稱 路徑 類型 Description
connections
 connections array of PeopleApiConnection

當聯絡人變更 V3 時

作業識別碼：
PeopleApiOnContactUpdatedV3

當聯絡人在 Google 通訊錄 V3 中發生變化時。

傳回

名稱 路徑 類型 Description
connections
 connections array of PeopleApiConnectionV2

當聯絡人變更時 [已棄用]

作業識別碼：
OnContactUpdated

當聯絡人在 Google 通訊錄中變更時。

傳回

名稱 路徑 類型 Description
輸入
 feed.entry array of Entry

定義

Entry

名稱 路徑 類型 Description
Id
 id.$t string

連絡人的識別碼。
更新日期時間
 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$組織
 gd$organization array of object
名稱
 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

連絡人的另一個位址。

人員Api連線

名稱 路徑 類型 Description
Id
 metadata.source.id string

連絡人的識別碼。
更新日期時間
 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
名稱
 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

聯絡人的另一個電話號碼。

人員Api連線V2

名稱 路徑 類型 Description
Id
 metadata.source.id string

連絡人的識別碼。
更新日期時間
 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
名稱
 organizations.name string

原始名稱。
Title
 organizations.title string

組織標題。
addresses
 addresses array of object
Address
 addresses.formattedValue string

聯絡人的地址。
電子郵件位址
 emailAddresses array of object
Email
 emailAddresses.value string

連絡人的電子郵件地址。
類型
 emailAddresses.formattedType string

連絡人的電子郵件地址類型。
電話號碼
 phoneNumbers array of object
電話號碼
 phoneNumbers.value string

聯繫人的電話號碼。
類型
 phoneNumbers.formattedType string

聯繫人的電話號碼。