Расширенные свойства и проекции

Чтобы определить пользовательские характеристики для общего контакта, используйте расширенные свойства и проекции.

Расширенные свойства

Вы можете установить дополнительную информацию, связанную с общим контактом, в качестве расширенного свойства с произвольными парами имя-значение для записи общего контакта. Вы несете ответственность за сохранение уникальности ключа. Значение расширенного свойства может храниться как значение (произвольная строка) или XML-объект (обычный текст). С каждым общим контактом может быть связано не более 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 указывает ключ расширенного свойства (элемент gd:extendedProperty ), который возвращается (для запросов GET ) или должен быть обновлен (для запроса PUT или POST ). Если расширенное свойство не используется во время операций обновления, оно удаляется.
full Возвращаются все элементы gd:extendedProperty , и все элементы должны быть включены во время обновления.
,

Чтобы определить пользовательские характеристики для общего контакта, используйте расширенные свойства и проекции.

Расширенные свойства

Вы можете установить дополнительную информацию, связанную с общим контактом, в качестве расширенного свойства с произвольными парами имя-значение для записи общего контакта. Вы несете ответственность за сохранение уникальности ключа. Значение расширенного свойства может храниться как значение (произвольная строка) или XML-объект (обычный текст). С каждым общим контактом может быть связано не более 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 указывает ключ расширенного свойства (элемент gd:extendedProperty ), который возвращается (для запросов GET ) или должен быть обновлен (для запроса PUT или POST ). Если расширенное свойство не используется во время операций обновления, оно удаляется.
full Возвращаются все элементы gd:extendedProperty , и все элементы должны быть включены во время обновления.