확장 속성 및 프로젝션

공유 연락처의 맞춤 특성을 정의하려면 확장된 속성과 프로젝션을 사용하세요.

확장된 속성

공유 연락처 항목에 임의의 이름-값 쌍과 함께 공유 연락처 관련 정보를 추가 확장 속성으로 설정할 수 있습니다. 키 고유성을 유지하는 것은 사용자의 책임입니다. 확장된 속성의 값은 값 (임의의 문자열) 또는 XML blob (일반 텍스트)으로 저장할 수 있습니다. 공유 연락처마다 최대 10개의 확장 속성을 연결할 수 있습니다. 각 확장 속성은 크기가 적당해야 합니다. 사진이나 벨소리는 사용하지 마세요.

예

다음 예는 키와 값이 있는 확장 속성을 보여줍니다.

&lt;gd:extendedProperty name="com.google" value="<var>VALUE</var>"/&gt;

다음 예는 키와 XML 블롭이 있는 확장된 속성을 보여줍니다.

&lt;gd:extendedProperty name="com.google"&gt;
  &lt;<var>XML_PARAMETER</var>&gt;&lt;/<var>XML_PARAMETER</var>&gt;
&lt;/gd:extendedProperty>

예측 값

확장 속성 공개 범위를 제한하려면 프로젝션을 사용하세요. 확장된 속성 (gd:extendedElement 요소) 설정은 full 또는 property-KEY 프로젝션 내에서만 허용됩니다.

다음 표에는 지원되는 투영 값이 설명되어 있습니다.

프로젝션 이름 설명
thin gd:extendedProperty 요소가 반환되거나 업데이트되지 않습니다.
property-KEY KEY는 반환되는 (GET 요청의 경우) 또는 업데이트되어야 하는(PUT 또는 POST 요청의 경우) 확장된 속성 (gd:extendedProperty 요소)의 키를 나타냅니다. 업데이트 작업 중에 확장 속성이 사용되지 않으면 속성이 삭제됩니다.
full 모든 gd:extendedProperty 요소가 반환되며 업데이트 중에 모든 요소를 포함해야 합니다.