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.listDirectoryPeople 或people.searchDirectoryPeople 。 |
異動項目只能由聯絡人聯絡人修改。不支援設定檔與網域聯絡人的異動。