更新或删除共享联系人

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

更新共享联系人

更新条目时，您必须保留从服务器检索条目时存在的所有 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：共享联系人的首选电话号码，例如 [phone]。
   • 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 查询参数请求占位符。

后续步骤

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