更新或删除共享联系人

更新或删除共享联系人的过程类似。

更新共享联系人

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

要更新现有共享联系人，请执行以下操作：

  1. 获取要更新的条目。
  2. 修改条目。

  3. 向联系人的修改网址发送 PUT 请求，并在消息正文中包含更新后的条目。使用 application/atom+xml 内容类型，并确保更新后的条目中的 <id> 值与现有条目的 <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：共享联系人的名字，例如 Alex。
    • LAST_NAME：共享联系人的姓氏，例如 Kim。
    • PROJECTION：指定 gd:extendedProperty 元素的投影值。如需查看支持的值的列表，请参阅投影值。
    • PRIMARY_PHONE_NUMBER：共享联系人的首选电话号码，例如 (206)555-1212。
    • 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 查询参数请求占位符。

后续步骤

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