Обновить или удалить общий контакт

Процессы обновления или удаления общего контакта аналогичны.

Обновить общий контакт

При обновлении записи вы должны сохранить весь XML, который присутствовал при получении записи с сервера. В противном случае игнорируемые элементы удаляются. Обновления могут занять до 24 часов, прежде чем они отразятся в автозаполнении адреса электронной почты и в менеджере контактов.

Чтобы обновить существующий общий контакт, выполните следующие действия:

1. Получите запись, которую вы хотите обновить .
2. Отредактируйте запись.

3. Отправьте запрос 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 : предпочтительный номер телефона для общего контакта, например [phone].
   • 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 .

Следующие шаги

Обновите или удалите фотографию общего контакта