Domain Shared Contacts API 使用标准 Google Data API 元素以及共享联系人专用的元素。
联系人条目采用扩展联系人种类的形式,表示人员、场所(如俱乐部或餐馆)或组织。联系人种类在 XML 中显示为 <atom:entry>
元素,其中包含 Google 数据命名空间中的各种扩展元素。
指示条目是联系人的 category
元素如下所示:
<atom:category scheme="http://schemas.google.com/g/2005#kind"
term="http://schemas.google.com/contact/2008#contact"/>
在 Domain Shared Contacts API 中,有几个元素比联系人种类的限制稍微严格一些。对于以下元素,您需要提供 rel
属性或 label
属性,但不能同时提供两者:
gd:email
gd:im
gd:organization
gd:phoneNumber
gd:structuredPostalAddress
创建或更新共享联系人时,如果针对其中任何元素同时提供 rel
和 label
或都不提供,则服务器会拒绝该条目。
Google 相册支持
您可以与标准属性值(如 self 或 edit 等)一起为 atom:link
元素使用 rel
值。使用照片链接时,必须指定 HTTP 标头中的授权令牌。如需了解详情,请参阅了解身份验证和授权。
- 使用
GET
命令时,rel="http://schemas.google.com/contacts/2008/rel#photo"
添加了读取与联系人关联的照片的功能。您可以使用href
中指定的网址读取与联系人关联的照片的最新版本。如果联系人没有图片,则系统不会显示该链接。
例如:
<atom:link rel="http://schemas.google.com/contacts/2008/rel#photo"
href="https://www.google.com/m8/feeds/photos/media/jo%40example.com/1234" type="image/*" />
- 借助
PUT
或DELETE
命令,rel="http://schemas.google.com/contacts/2008/rel#edit-photo"
添加了更新或删除与联系人关联的本地照片的功能。
例如:
<atom:link rel="http://schemas.google.com/contacts/2008/rel#edit-photo"
href="https://www.google.com/m8/feeds/photos/media/jo%40example.com/1234/photo4524" />
gContact
命名空间
gContact
的 XML 命名空间网址为 http://schemas.google.com/contact/2008
。
此命名空间中定义了一个元素,以表示联系人所属的群组。
gContact:groupMembershipInfo
个房源
媒体资源 | 说明 |
---|---|
href |
标识联系人所属的或所属的群组。该群组通过其 ID 进行引用。 |
deleted="true" |
表示删除了联系人的群组成员资格。只有在将 showdeleted 指定为查询参数时,才会包含此属性,否则针对联系人不再属于的群组,不会返回 groupMembershipInfo 。 |