Propriedades e projeções estendidas

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

Propriedades estendidas

É possível definir outras informações relacionadas a contatos compartilhados como uma propriedade estendida, com pares de nome-valor arbitrários, para uma entrada de contato compartilhada. É sua responsabilidade preservar a exclusividade da chave. O valor de uma propriedade estendida pode ser armazenado como um valor (string arbitrário) 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 de chamada.

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 da propriedade estendida, use projeções. A definição de propriedades estendidas (elementos gd:extendedElement) é permitida apenas 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 que 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 todos os elementos precisam ser incluídos durante uma atualização.