공유 연락처 요소

Domain Shared Contacts 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 헤더의 승인 토큰을 지정해야 합니다. 자세한 내용은 인증 및 승인 알아보기를 참고하세요.

• GET 명령어를 사용하면 rel="http://schemas.google.com/contacts/2008/rel#photo"에 연락처와 연결된 사진을 읽는 기능이 추가됩니다. 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/*" />

• PUT 또는 DELETE 명령어를 사용하여 rel="http://schemas.google.com/contacts/2008/rel#edit-photo"는 연락처와 연결된 로컬 사진을 업데이트하거나 삭제하는 기능을 추가합니다.

예:

<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가 반환되지 않습니다.