Propriedades e projeções estendidas

Para definir características personalizadas para um contato compartilhado, use propriedades e projeções estendidas.

Propriedades estendidas

Você pode definir outras informações relacionadas a um contato compartilhado como uma propriedade estendida, com pares de nome-valor arbitrários, para uma entrada de contato compartilhado. É sua responsabilidade preservar a exclusividade da chave. O valor de uma propriedade estendida pode ser armazenado como um valor (string arbitrária) ou um blob XML (texto simples). Cada contato compartilhado pode ter no máximo 10 propriedades estendidas associadas. Cada propriedade estendida precisa ser razoavelmente pequena. Não use uma foto ou um toque.

Exemplo

O exemplo a seguir mostra uma propriedade estendida com uma chave e um valor:

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

O exemplo a seguir mostra uma propriedade estendida com chave e um blob XML:

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

Valores de projeção

Para limitar a visibilidade de propriedades estendidas, use projeções. A definição de propriedades estendidas (elementos gd:extendedElement) só é permitida em uma projeção full ou property-KEY.

A tabela a seguir descreve os valores de projeção permitidos:

Nome da projeção Descrição
thin Nenhum elemento gd:extendedProperty é retornado ou atualizado.
property-KEY KEY indica a chave de uma propriedade estendida (elemento gd:extendedProperty) que é retornada (para solicitações GET) ou precisa ser atualizada (para uma solicitação PUT ou POST). Se a propriedade estendida não for usada durante as operações de atualização, ela será excluída.
full Todos os elementos gd:extendedProperty são retornados e precisam ser incluídos durante uma atualização.