공유 연락처 요소

도메인 공유 주소록 API는 표준 Google Data API 요소와 공유 주소록 전용 요소를 사용합니다.

연락처 항목은 사람, 장소(클럽이나 레스토랑과 같은 장소) 또는 조직을 나타내는 확장된 연락처 종류의 형태를 취합니다. 연락처 종류는 XML에 Google 데이터 네임스페이스의 다양한 확장 요소를 포함하는 <atom:entry> 요소로 표시됩니다.

항목이 연락처임을 나타내는 category 요소는 다음과 같습니다.

<atom:category scheme="http://schemas.google.com/g/2005#kind"
  term="http://schemas.google.com/contact/2008#contact"/>

Domain Shared Contacts API에서는 일부 요소가 연락처 종류보다 약간 더 제한적입니다. 다음 요소의 경우 rel 속성 또는 label 속성 중 하나만 제공합니다.

  • gd:email
  • gd:im
  • gd:organization
  • gd:phoneNumber
  • gd:structuredPostalAddress

공유 연락처를 만들거나 업데이트할 때 이러한 요소에 rel와 label를 모두 제공하거나 모두 제공하지 않으면 서버에서 항목을 거부합니다.

포토 지원

self 또는 edit과 같은 표준 속성 값과 함께 atom:link 요소에 rel 값을 사용할 수 있습니다. 사진 링크를 사용할 때 HTTP 헤더의 승인 토큰을 지정해야 합니다. 자세한 내용은 인증 및 승인 알아보기를 참조하세요.

  • rel="http://schemas.google.com/contacts/2008/rel#photo"는 GET 명령어를 사용하여 연락처와 연결된 사진을 읽을 수 있는 기능을 추가합니다. href에 지정된 URL을 사용하여 연락처와 연결된 최신 버전의 사진을 읽을 수 있습니다. 연락처의 사진이 없으면 링크가 표시되지 않습니다.

예:

<atom:link rel="http://schemas.google.com/contacts/2008/rel#photo"
           href="https://www.google.com/m8/feeds/photos/media/jo%40example.com/1234" type="image/*" />
  • rel="http://schemas.google.com/contacts/2008/rel#edit-photo"는 PUT 또는 DELETE 명령어를 사용하여 연락처와 연결된 로컬 사진을 업데이트하거나 삭제하는 기능을 추가합니다.

예:

<atom:link rel="http://schemas.google.com/contacts/2008/rel#edit-photo"
           href="https://www.google.com/m8/feeds/photos/media/jo%40example.com/1234/photo4524" />

gContact 네임스페이스

gContact의 XML 네임스페이스 URL은 http://schemas.google.com/contact/2008입니다.

이 네임스페이스에서 요소는 연락처가 속한 그룹을 나타내는 정의됩니다.

숙박 시설 gContact:groupMembershipInfo개

속성 설명
href 연락처가 속해 있거나 속한 그룹을 식별합니다. 그룹은 그룹 ID로 참조됩니다.
deleted="true" 연락처의 그룹 멤버십이 삭제되었음을 의미합니다. 이 속성은 showdeleted가 쿼리 매개변수로 지정된 경우에만 포함되며, 그렇지 않으면 연락처가 더 이상 속하지 않는 그룹의 groupMembershipInfo가 반환되지 않습니다.