更新共享联系人的照片与更新共享联系人的信息略有不同。如需了解如何使用共享联系人的信息,请参阅更新或删除共享联系人。使用照片链接时,您必须在 HTTP 标头中指定授权令牌。如需了解详情,请参阅了解身份验证和授权。
更新共享联系人的照片
每个共享联系人都有一个照片链接元素。无论联系人是否有关联的照片,都会显示照片链接元素。如果联系人确实有照片,则该元素会包含一个 gd:etag
属性,该属性为照片指定 ETag
HTTP 标头。ETag
可让您引用特定条目的特定版本。在本例中,它让您可以引用照片的特定版本。如果联系人没有照片,则没有 gd:etag
属性,而 href
属性提供用于为联系人添加照片的网址。
如要添加或更新照片,请发送新照片:
PUT https://www.google.com/m8/feeds/photos/media/liz%40DOMAIN/PHOTO_LINK
请替换以下内容:
DOMAIN
:您的网域的网址,例如 example.com。PHOTO_LINK
:表示共享联系人的照片链接的唯一数字值,例如 c9012de。
以下是照片链接元素的示例:
<link rel="http://schemas.google.com/contacts/2008/rel#photo" type="image/*" href="https://www.google.com/m8/feeds/photos/media/liz%40example.com/c9012de">
删除共享联系人的照片
如需删除照片,您必须使用 HTTP DELETE
方法。
更新或删除照片时,在 HTTP 请求的 If-Match
标头中发送照片的 ETag
。如果您没有最新版本的照片,请使用 If-Match: *
替换版本控制系统并删除照片。
如需详细了解 ETags
,请参阅 Google 数据 API 协议参考文档。