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

Обновление и удаление общего контакта осуществляются аналогично, поскольку в обоих случаях используется URL-адрес для редактирования контакта.

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

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

Чтобы обновить существующий общий контакт:

  1. Получите запись для обновления .
  2. Отредактируйте запись.
  3. Отправьте 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 , чтобы запросить их.

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

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