共享联系人元素

Domain Shared Contacts 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"/>

在 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。