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。 |
您只能透過異動端點修改聯絡人名單。不支援設定檔與網域聯絡人異動。