更新和删除共享联系人的方式类似,因为两者都使用联系人的修改网址。
更新共享的联系人
更新条目时,保留从服务器检索到的所有 XML。 否则,系统会删除忽略的元素。更新最长可能需要 24 小时才能反映在自动补全功能和联系人管理器中。
如需更新现有共享联系人,请执行以下操作:
- 获取要更新的条目。
- 修改条目。
向联系人的编辑网址发送包含更新后条目的
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 查询参数来请求这些数据。