簡介

People API 可讓您：

• 讀取及管理已驗證使用者的「聯絡人」
• 讀取及複製已驗證使用者的「其他聯絡人」
• 讀取已驗證使用者及其聯絡人的設定檔資訊
• 讀取網域設定檔和聯絡人

舉例來說，假設通過驗證的使用者 Jen 有 Fabian 和 Ranjith 的私人聯絡人。當應用程式呼叫 people.connections.list 以讀取她的連線清單時，系統會顯示同意畫面，要求 Jen 允許應用程式存取清單。如果 Jen 同意，應用程式會讀取包含 Fabian 和 Ranjith 的 person resources 清單。

如果應用程式需要特定使用者的資訊，只要呼叫 people.get 並傳入資源名稱，就能取得該使用者的 person resource。

應用程式也可以管理聯絡人，例如使用 people.createContact 建立新聯絡人、使用 people.updateContact 更新已讀取 people.connections.list 的現有聯絡人，以及使用 people.deleteContact 刪除聯絡人。

Google Workspace 使用者也可以使用 people.listDirectoryPeople 列出其目錄網域設定檔和網域聯絡人，或使用 people.searchDirectoryPeople 進行搜尋。

使用者資訊的合併檢視畫面

People API 讀取的使用者資訊會從多個來源合併，具體情況取決於以下條件：

來源	條件
公開的 Google 設定檔資料	永遠。
Google Workspace 網域設定檔資料	網域管理員已針對網域範圍資料啟用外部聯絡人和設定檔共用功能，並授予 directory.readonly 範圍
已驗證使用者的私人個人資訊	已經授予其中一個 profile 範圍。
已驗證使用者的聯絡人	已授予 contacts 範圍。

瞭解合併個人資料

個人的資料衍生自一個主要來源類型。如果來源是透過已驗證的電子郵件地址、電話號碼或個人資料網址建立連結，系統就會將其他來源的資料與這些資料合併。這些屬性是由使用者組成：

主要來源	聯絡人	設定檔	Google Workspace 網域設定檔	Google Workspace 網域聯絡人	使用方法
聯絡	1	0+	0+	0+	大部分端點會傳回相同的內容
設定檔	0+	1	0 或 1	0	用於取得已登入的使用者或其他使用者的 Google 帳戶的人員時，會傳回 people.get。
網域聯絡人	0+	0	0	1	已發還給people.listDirectoryPeople或people.searchDirectoryPeople。

您只能透過異動端點修改聯絡人名單。不支援設定檔與網域聯絡人異動。