People API

프로필 및 연락처에 대한 정보에 대한 액세스를 제공합니다.

서비스: people.googleapis.com

이 서비스를 호출하려면 Google에서 제공하는 클라이언트 라이브러리를 사용하는 것이 좋습니다. 애플리케이션이 이 서비스를 호출하기 위해 자체 라이브러리를 사용해야 하는 경우, API 요청을 할 때 다음 정보를 사용합니다.

검색 문서

검색 문서는 머신에서 읽을 수 있는 사양이며 REST API를 설명하고 사용하는 데 참조할 수 있습니다. 또한 클라이언트 라이브러리, IDE 플러그인, 기타 Google API와 상호작용하는 도구를 빌드하는 데 사용됩니다. 하나의 서비스는 여러 개의 검색 문서를 제공할 수 있습니다. 이 서비스는 다음 검색 문서를 제공합니다.

서비스 엔드포인트

서비스 엔드포인트는 API 서비스의 네트워크 주소를 지정하는 기본 URL입니다. 하나의 서비스에 여러 서비스 엔드포인트가 있을 수 있습니다. 이 서비스에는 다음 서비스 엔드포인트가 포함되고, 그 아래의 모든 URI가 이 서비스 엔드포인트와 관련됩니다.

  • https://people.googleapis.com

REST 리소스: v1.contactGroups

방법
batchGet GET /v1/contactGroups:batchGet
연락처 그룹 리소스 이름 목록을 지정하여 인증된 사용자가 소유한 연락처 그룹 목록을 가져옵니다.
create POST /v1/contactGroups
인증된 사용자가 소유한 새 연락처 그룹을 만듭니다.
delete DELETE /v1/{resourceName=contactGroups/*}
연락처 그룹 리소스 이름을 지정하여 인증된 사용자가 소유한 기존 연락처 그룹을 삭제합니다.
get GET /v1/{resourceName=contactGroups/*}
연락처 그룹 리소스 이름을 지정하여 인증된 사용자가 소유한 특정 연락처 그룹을 가져옵니다.
list GET /v1/contactGroups
인증된 사용자가 소유한 모든 연락처 그룹을 나열합니다.
update PUT /v1/{contactGroup.resourceName=contactGroups/*}
인증된 사용자가 소유한 기존 연락처 그룹의 이름을 업데이트합니다.

REST 리소스: v1.contactGroups.members

방법
modify POST /v1/{resourceName=contactGroups/*}/members:modify
인증된 사용자가 소유한 연락처 그룹의 구성원을 수정합니다.

REST 리소스: v1.otherContacts

방법
copyOtherContactToMyContactsGroup POST /v1/{resourceName=otherContacts/*}:copyOtherContactToMyContactsGroup

'기타 연락처'를 사용자의 'myContacts' 그룹에 있는 새 연락처에 복사합니다.

지연 시간 증가 및 실패를 방지하기 위해 동일한 사용자에 대한 변경 요청을 순차적으로 전송해야 합니다.

list GET /v1/otherContacts
연락처 그룹에 없는 연락처인 모든 '기타 연락처'를 나열합니다.
search GET /v1/otherContacts:search
검색어와 일치하는 인증된 사용자의 다른 연락처에 있는 연락처 목록을 제공합니다.

REST 리소스: v1.people

방법
batchCreateContacts POST /v1/people:batchCreateContacts

새 연락처 배치를 만들고 새로 다음에 대한 PersonResponses를 반환

지연 시간 증가 및 실패를 방지하기 위해 동일한 사용자에 대한 변경 요청을 순차적으로 전송해야 합니다.

batchDeleteContacts POST /v1/people:batchDeleteContacts
연락처를 일괄 삭제합니다.
batchUpdateContacts POST /v1/people:batchUpdateContacts
연락처 배치를 업데이트하고 업데이트된 연락처의 PersonResponses에 리소스 이름 맵을 반환합니다.
createContact POST /v1/people:createContact
새 연락처를 만들고 해당 연락처의 사람 리소스를 반환합니다.
deleteContact DELETE /v1/{resourceName=people/*}:deleteContact
담당자를 삭제합니다.
deleteContactPhoto DELETE /v1/{resourceName=people/*}:deleteContactPhoto
연락처 사진을 삭제합니다.
get GET /v1/{resourceName=people/*}
리소스 이름을 지정하여 사람에 대한 정보를 제공합니다.
getBatchGet GET /v1/people:batchGet
요청된 리소스 이름 목록을 지정하여 특정 사람들 목록에 관한 정보를 제공합니다.
listDirectoryPeople GET /v1/people:listDirectoryPeople
인증된 사용자의 도메인 디렉터리에 있는 도메인 프로필 및 도메인 연락처 목록을 제공합니다.
searchContacts GET /v1/people:searchContacts
검색어와 일치하는 인증된 사용자의 그룹화된 연락처에 있는 연락처 목록을 제공합니다.
searchDirectoryPeople GET /v1/people:searchDirectoryPeople
검색어와 일치하는 인증된 사용자의 도메인 디렉터리에 있는 도메인 프로필 및 도메인 연락처 목록을 제공합니다.
updateContact PATCH /v1/{person.resourceName=people/*}:updateContact
기존 담당자의 연락처 데이터를 업데이트합니다.
updateContactPhoto PATCH /v1/{resourceName=people/*}:updateContactPhoto
연락처 사진을 업데이트합니다.

REST 리소스: v1.people.connections

방법
list GET /v1/{resourceName=people/*}/connections
인증된 사용자의 연락처 목록을 제공합니다.