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

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

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

Вы можете задать дополнительную информацию, связанную с общим контактом, в качестве расширенного свойства, используя произвольные пары «имя-значение», для записи общего контакта. Вы несете ответственность за сохранение уникальности ключа. Значение расширенного свойства может храниться как значение (произвольная строка) или 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 , и все эти элементы должны быть включены при обновлении.