People API를 사용하면 다음과 같은 작업을 할 수 있습니다.
예를 들어 인증된 사용자 젠의 비공개 연락처에 페이비안과 랜지스가 있다고 가정해 보겠습니다. 앱에서 people.connections.list를 호출하여 연결 목록을 읽으면 젠이 앱에 목록 액세스 권한을 부여할 것을 요청하는 동의 화면이 표시됩니다. 젠이 동의하면 앱은 페이비언과 랜지스의 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 범위가 부여되었습니다. |
병합된 사용자 데이터 이해하기
개인의 데이터는 하나의 기본 소스 유형에서 파생됩니다. 소스가 인증된 이메일 주소, 전화번호 또는 프로필 URL을 통해 연결된 경우 다른 소스의 데이터가 이 데이터와 병합됩니다. 다음은 사용자를 구성하는 방법입니다.
| 주요 출처 | 연락처 | 프로필 | Google Workspace 도메인 프로필 | Google Workspace 도메인 연락처 | 사용 |
|---|---|---|---|---|---|
| Contact | 1 | 0+ | 0+ | 0+ | 대부분의 엔드포인트에서 반환됨 |
| 프로필 | 0+ | 1 | 0 또는 1 | 0 | 로그인한 사용자의 사용자 또는 다른 사용자의 Google 계정의 사용자를 가져오는 데 사용되는 경우 people.get에서 반환됩니다. |
| 도메인 연락처 | 0+ | 0 | 0 | 1 | people.listDirectoryPeople 또는 people.searchDirectoryPeople에서 반환됨 |
변형 엔드포인트는 연락처 기반 사용자만 수정할 수 있습니다. 프로필 및 도메인 연락처 변형은 지원되지 않습니다.