Обновление и удаление общего контакта осуществляются аналогично, поскольку в обоих случаях используется URL-адрес для редактирования контакта.
Обновить общий контакт
При обновлении записи необходимо сохранить весь XML-код, полученный с сервера. В противном случае игнорируемые элементы будут удалены. Обновления могут отобразиться в автозаполнении и в менеджере контактов в течение 24 часов.
Чтобы обновить существующий общий контакт:
- Получите запись для обновления .
- Отредактируйте запись.
Отправьте
PUTзапрос с обновленной записью на URL-адрес редактирования контакта. Используйте тип контентаapplication/atom+xmlи убедитесь, что значение<id>точно соответствует существующей записи. URL-адрес редактирования заканчивается номером версии для обнаружения конфликтов. Для получения дополнительной информации см. раздел «Версионирование» .Обновите запись:
<entry> <id>https://www.google.com/m8/feeds/contacts/DOMAIN/base/8411573</id> <updated>2008-02-28T18:47:02.303Z</updated> <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/contact/2008#contact' /> <title type='text'>TITLE_NAME</title> <gd:name> <gd:fullName>FIRST_NAME LAST_NAME</gd:fullName> </gd:name> <content type='text'>NOTES</content> <link rel='self' type='application/atom+xml' href='https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/8411573' /> <link rel='edit' type='application/atom+xml' href='https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/8411573/1204224422303000' /> <gd:phoneNumber rel='http://schemas.google.com/g/2005#other' primary='true'>PRIMARY_PHONE_NUMBER</gd:phoneNumber> <gd:extendedProperty name="CUSTOM_PROPERTY" value="CUSTOM_PROPRTY_VALUE" /> </entry>
Замените следующее:
-
DOMAIN: Ваш домен — например, example.com. -
TITLE_NAME: Название записи — например, список контактов example.com. -
FIRST_NAME: Имя контакта. -
LAST_NAME: Фамилия контакта. -
PROJECTION: Значение проекции. Список поддерживаемых значений см. в разделе «Значения проекции» . -
PRIMARY_PHONE_NUMBER: Предпочитаемый номер телефона. -
CUSTOM_PROPERTY: Название пользовательского свойства. CUSTOM_PROPRTY_VALUE: Значение для пользовательского свойства.Пример обновленной записи с выделенным URL-адресом для редактирования:
<entry> <id>https://www.google.com/m8/feeds/contacts/example.com/base/8411573</id> <updated>2008-02-28T18:47:02.303Z</updated> <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/contact/2008#contact' /> <title type='text'>Fitzgerald</title> <gd:name> <gd:fullName>Fitzgerald</gd:fullName> </gd:name> <content type='text'>Notes</content> <link rel='self' type='application/atom+xml' href='https://www.google.com/m8/feeds/contacts/example.com/full/8411573' /> <link rel='edit' type='application/atom+xml' href='https://www.google.com/m8/feeds/contacts/example.com/full/8411573/1204224422303000' /> <gd:phoneNumber rel='http://schemas.google.com/g/2005#other' primary='true'>456-123-2133</gd:phoneNumber> <gd:extendedProperty name="pet" value="hamster" /> <gd:extendedProperty name="cuisine"> <italian /> </gd:extendedProperty> </entry>
-
Удалить общие контакты
Удаленные контакты могут исчезнуть из автозаполнения и диспетчера контактов в течение 24 часов. Не обновляйте контакты, удаляя и добавляя их заново. Вместо этого ознакомьтесь с разделом «Обновление контактов» .
- Чтобы удалить общий контакт, отправьте запрос
DELETEна URL-адрес редактирования контакта. Это тот же URL-адрес, который используется для обновления контактов .
Google сохраняет временные метки для удаленных контактов в течение 30 дней. Используйте параметр запроса showdeleted , чтобы запросить их.
Следующие шаги
Обновить или удалить фотографию для общего контакта.