Domain Shared Contacts API를 사용하면 Google Workspace 도메인의 모든 사용자와 공유되는 외부 연락처를 가져와 업데이트할 수 있습니다. 공유 연락처는 Google Workspace 도메인의 모든 사용자에게 표시되며 모든 Google 서비스는 연락처 목록에 액세스할 수 있습니다.
애플리케이션은 Domain Shared Contacts API를 사용하여 공유 연락처를 만들고 기존 공유 연락처를 수정 또는 삭제하며 특정 기준과 일치하는 공유 연락처를 쿼리할 수 있습니다.
Domain Shared Contacts API는 Google Workspace 계정에서만 사용할 수 있습니다. API를 사용하려면 관리 콘솔에서 Domain Shared Contacts API를 사용 설정합니다. 공유 연락처 변경사항이 이메일 주소 자동 완성 및 연락처 관리자에 반영되는 데 최대 24시간이 걸릴 수 있습니다.
이 문서에서는 Domain Shared Contacts API의 기능에 대한 배경 지식이 있을 뿐만 아니라 XML과 HTTP를 사용해 연락처를 관리하는 방법에 관한 예시도 제공합니다. 이 문서를 읽은 후 클라이언트 라이브러리를 사용하여 API와 상호작용하는 방법을 자세히 알아볼 수 있습니다.
대상
이 문서는 HTTP 및 XML을 사용하여 Google의 연락처 목록을 조작할 수 있는 클라이언트 애플리케이션을 작성하려는 개발자를 대상으로 합니다. 이 문서에서는 사용자가 Google Data API 프로토콜의 기초를 이해하고 있다고 가정합니다.
UNIX 운영체제를 사용하는 경우 이 문서의 예를 작성하지 않고 코드를 작성하려면 UNIX 명령줄 유틸리티 curl 또는 wget을 사용하세요. Google 데이터 서비스에서 cURL을 사용하는 방법을 알아보세요.
원칙
이 버전의 Domain Shared Contacts API는 Google Data API 원칙을 따릅니다. Google 데이터 API는 Atom 게시 프로토콜 외에 Atom 1.0 및 RSS 2.0 신디케이션 형식을 모두 기반으로 합니다.
버전 지정
Domain Shared Contacts API를 사용하여 보내는 모든 요청은 API 버전 3.0을 지정해야 합니다.
GData-Version: 3.0
HTTP 헤더를 설정할 수 없는 경우 URL에 v=3.0
를 쿼리 매개변수로 지정할 수 있지만 HTTP 헤더 메서드를 사용하는 것이 좋습니다.