簡介

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

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 透過 people.get 取得使用者的已登入使用者,或取得其他使用者的 Google 帳戶
網域聯絡人 0+ 0 0 1 已發還給people.listDirectoryPeoplepeople.searchDirectoryPeople

異動項目只能由聯絡人聯絡人修改。不支援設定檔與網域聯絡人的異動。