更新或删除共享联系人的过程类似。
更新共享联系人
更新条目时,您必须保留 从服务器检索该条目。否则,会被忽略的元素 已删除。更新最长可能需要 24 小时才能反映在电子邮件地址中 自动完成和联系人管理器。
如需更新现有的共享联系人,请执行以下操作:
- 获取要更新的条目。
- 修改条目。
使用消息正文中的更新后的条目发送
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
:共享的姓氏 例如李明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
请求占位符
查询参数。