확장 속성 및 프로젝션

공유 연락처의 맞춤 특성을 정의하려면 확장 속성 및 프로젝션을 사용합니다.

확장 속성

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

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

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

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

&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 요소가 반환되며 모든 요소가 업데이트 중에 포함되어야 합니다.