Propriedades e projeções estendidas

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

Propriedades estendidas

Você pode definir outras informações relacionadas aos contatos compartilhados como uma propriedade estendida, com pares arbitrários de nome-valor, para uma entrada de contato compartilhado. Você é responsável por 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 da propriedade estendida, 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 todos os elementos precisam ser incluídos durante uma atualização.