Элементы общих контактов

API для общих контактов домена использует стандартные элементы Google Data API , а также элементы, специфичные для общих контактов.

Контактная информация представляет собой расширенный тип «Контакт» , обозначающий человека, место (например, клуб или ресторан) или организацию. В XML тип «Контакт» отображается как элемент <atom:entry> , содержащий различные элементы расширения из пространства имен Google Data.

Элемент category , указывающий на то, что запись является контактом, выглядит следующим образом:

<atom:category scheme="http://schemas.google.com/g/2005#kind"
  term="http://schemas.google.com/contact/2008#contact"/>

В API для общих контактов домена некоторые элементы имеют несколько более строгие ограничения, чем тип контакта. Для следующих элементов необходимо указать либо атрибут rel , либо атрибут label , но не оба одновременно:

  • gd:email
  • gd:im
  • gd:organization
  • gd:phoneNumber
  • gd:structuredPostalAddress

При создании или обновлении общего контакта, если вы указываете одновременно и rel , и label , или ни один из этих параметров, сервер отклоняет запись.

Поддержка фотографий

Наряду со значениями стандартных свойств, таких как self или edit, вы можете использовать значения rel для элементов atom:link . При использовании ссылок на фотографии необходимо указать токен авторизации в заголовке HTTP. Для получения дополнительной информации см. раздел «Подробнее об аутентификации и авторизации» .

  • С помощью команды GET ` rel="http://schemas.google.com/contacts/2008/rel#photo" добавляется возможность чтения фотографии, связанной с контактом. Вы можете использовать URL-адрес, указанный в href , чтобы прочитать последнюю версию фотографии, связанной с контактом. Ссылка не отображается, если для контакта нет изображения.

Пример:

<atom:link rel="http://schemas.google.com/contacts/2008/rel#photo"
           href="https://www.google.com/m8/feeds/photos/media/jo%40example.com/1234" type="image/*" />
  • С помощью команд PUT или DELETE rel="http://schemas.google.com/contacts/2008/rel#edit-photo" добавляет возможность обновления или удаления локальной фотографии, связанной с контактом.

Пример:

<atom:link rel="http://schemas.google.com/contacts/2008/rel#edit-photo"
           href="https://www.google.com/m8/feeds/photos/media/jo%40example.com/1234/photo4524" />

пространство имен gContact

URL-адрес пространства имен XML для gContact : http://schemas.google.com/contact/2008 .

В этом пространстве имен определен элемент, представляющий группу, к которой принадлежит контакт.

gContact:groupMembershipInfo properties

Свойство Описание
href Определяет группу, к которой принадлежит или принадлежал контакт. Группа обозначается своим идентификатором.
deleted="true" Это означает, что членство контакта в группе было удалено. Этот атрибут включается только в том случае, если в качестве параметра запроса указан showdeleted ; в противном случае groupMembershipInfo для групп, к которым контакт больше не принадлежит, не возвращается.