更新或删除共享联系人

更新和删除共享联系人的方式类似,因为两者都使用联系人的修改网址。

更新共享的联系人

更新条目时,保留从服务器检索到的所有 XML。 否则,系统会删除忽略的元素。更新最长可能需要 24 小时才能反映在自动补全功能和联系人管理器中。

如需更新现有共享联系人,请执行以下操作:

  1. 获取要更新的条目
  2. 修改条目。
  3. 向联系人的编辑网址发送包含更新后条目的 PUT 请求。 使用 application/atom+xml 内容类型,并确保 <id> 值与现有条目完全一致。编辑网址以版本号结尾,以检测冲突。如需了解详情,请参阅版本控制

    更新条目:

    <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:自定义属性的值。

      突出显示了修改网址的更新后条目示例:

      <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 请求。此网址与用于更新联系人的网址相同。

Google 会将已删除联系人的占位符保留 30 天。使用 showdeleted 查询参数来请求这些数据。

后续步骤

更新或删除共享联系人的照片