Процессы обновления или удаления общего контакта аналогичны.
Обновить общий контакт
При обновлении записи вы должны сохранить весь XML, который присутствовал при получении записи с сервера. В противном случае игнорируемые элементы удаляются. Обновления могут занять до 24 часов, прежде чем они отразятся в автозаполнении адреса электронной почты и в менеджере контактов.
Чтобы обновить существующий общий контакт, выполните следующие действия:
- Получите запись, которую вы хотите обновить .
- Отредактируйте запись.
Отправьте запрос
PUT
с обновленной записью в теле сообщения на URL-адрес редактирования контакта. Используйте тип контентаapplication/atom+xml
и убедитесь, что значение<id>
в обновленной записи точно соответствует<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
: URL-адрес вашего домена, например example.com. -
TITLE_NAME
: имя записи контакта, например список контактов example.com. -
FIRST_NAME
: имя общего контакта, например Алекс. -
LAST_NAME
: фамилия общего контакта, например Ким. -
PROJECTION
: значение проекции, определяющее элементыgd:extendedProperty
. Список поддерживаемых значений см. в разделе Значения проекции . -
PRIMARY_PHONE_NUMBER
: предпочтительный номер телефона для общего контакта, например (206)555-1212. -
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
.
Следующие шаги
Обновите или удалите фотографию общего контакта