공유 연락처의 맞춤 특성을 정의하려면 확장 속성 및 프로젝션을 사용합니다.
확장 속성
추가 공유 연락처 관련 정보를 공유 연락처 항목에 임의의 이름-값 쌍이 있는 확장된 속성으로 설정할 수 있습니다. 키의 고유성을 유지하는 것은 개발자의 책임입니다. 확장된 속성의 값은 값 (임의의 문자열) 또는 XML blob (일반 텍스트)로 저장할 수 있습니다. 각 공유 연락처에는 최대 10개의 확장 속성이 연결될 수 있습니다. 각 확장 속성은 어느 정도 작아야 합니다. 사진이나 벨소리를 사용하지 마세요.
예
다음 예는 키와 값이 있는 확장된 속성을 보여줍니다.
<gd:extendedProperty name="com.google" value="<var>VALUE</var>"/>
다음 예는 키와 XML blob이 있는 확장된 속성을 보여줍니다.
<gd:extendedProperty name="com.google">
<<var>XML_PARAMETER</var>></<var>XML_PARAMETER</var>>
</gd:extendedProperty>
프로젝션 값
확장된 속성 공개 상태를 제한하려면 프로젝션을 사용하세요. 확장 속성 (gd:extendedElement
요소) 설정은 full
또는 property-KEY
프로젝션 내에서만 허용됩니다.
다음 표에서는 지원되는 투영 값을 설명합니다.
프로젝션 이름 | 설명 |
---|---|
thin |
gd:extendedProperty 요소는 반환되거나 업데이트되지 않습니다. |
property-KEY |
KEY 는 (GET 요청의 경우) 반환되거나(PUT 또는 POST 요청의 경우) 업데이트되어야 하는 확장 속성 (gd:extendedProperty 요소)의 키를 나타냅니다. 업데이트 작업 중에 확장된 속성이 사용되지 않으면 속성이 삭제됩니다. |
full
| 모든 gd:extendedProperty 요소가 반환되며 모든 요소가 업데이트 중에 포함되어야 합니다. |