共享联系人元素

域共享联系人 API 使用 标准 Google Data API 元素 和特定于共享联系人的元素。

联系人条目采用扩展的 联系人种类 代表人物、场所（如俱乐部或餐馆）或 组织。联系人种类在 XML 中显示为 <atom:entry> 元素， 包含来自 Google Data 命名空间的各种扩展元素。

指示条目是联系人的 category 元素类似于 以下：

<atom:category scheme="http://schemas.google.com/g/2005#kind"
  term="http://schemas.google.com/contact/2008#contact"/>

在域共享联系人 API 中，有几个元素比 联系人种类。对于以下元素，您需要提供 rel 属性或 label 属性，但不能同时设置这两者：

• gd:email
• gd:im
• gd:organization
• gd:phoneNumber
• gd:structuredPostalAddress

创建或更新共享联系人时，如果您同时提供 rel 和 label 或两者都没有，服务器会拒绝 条目。

Google 相册支持

与标准媒体资源一起值（例如 self 或 edit），可以使用 rel atom:link 元素的值。使用照片链接时， 必须指定 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 不再属于某个联系人的群组。