获取共享联系人

您可以通过多种方式请求共享用户联系人， 方式：

  • 所有共享联系人
  • 符合指定条件的一组联系人
  • 单个共享联系人
  • 联系人的照片

默认情况下，供稿中的条目未进行排序。

获取所有共享联系人

  1. 要获取所有共享联系人，请将 HTTP GET 请求发送到 联系人供稿网址：

    GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION

    替换以下内容：

    • DOMAIN：您的网域的网址，例如 example.com。
    • PROJECTION：用于指定 gd:extendedProperty 元素。有关支持的值的列表，请参阅 投影值。

    Feed 会返回 HTTP 200 OK 状态代码和标准 Atom 1.0 包含联系人的 Feed。以下是一个 只有一个条目的供稿：

    <feed xmlns='http://www.w3.org/2005/Atom'
    xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'
    xmlns:gd='http://schemas.google.com/g/2005'
    xmlns:gContact='http://schemas.google.com/contact/2008'
    xmlns:batch='http://schemas.google.com/gdata/batch'>
  <id>https://www.google.com/m8/feeds/contacts/example.com/base</id>
  <updated>2008-03-05T12:36:38.836Z</updated>
  <category scheme='http://schemas.google.com/g/2005#kind'
    term='http://schemas.google.com/contact/2008#contact' />
  <title type='text'>example.com's Contacts</title>
  <link rel='http://schemas.google.com/g/2005#feed'
    type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/example.com/full' />
  <link rel='http://schemas.google.com/g/2005#post'
    type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/example.com/full' />
  <link rel='http://schemas.google.com/g/2005#batch'
    type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/example.com/full/batch' />
  <link rel='self' type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/example.com/full?max-results=25' />
  <author>
    <name>example.com</name>
    <email>example.com</email>
  </author>
  <generator version='1.0' uri='https://www.google.com/m8/feeds/contacts'>
    Contacts
  </generator>
  <openSearch:totalResults>1</openSearch:totalResults>
  <openSearch:startIndex>1</openSearch:startIndex>
  <openSearch:itemsPerPage>25</openSearch:itemsPerPage>
  <entry>
    <id>
      https://www.google.com/m8/feeds/contacts/example.com/base/c9012de
    </id>
    <updated>2008-03-05T12:36:38.835Z</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>
    <link rel="http://schemas.google.com/contacts/2008/rel#photo" type="image/*"
      href="http://google.com/m8/feeds/photos/media/example.com/c9012de"/>
    <link rel='self' type='application/atom+xml'
      href='https://www.google.com/m8/feeds/contacts/example.com/full/c9012de' />
    <link rel='edit' type='application/atom+xml'
      href='https://www.google.com/m8/feeds/contacts/example.com/full/c9012de/1204720598835000' />
    <gd:phoneNumber rel='http://schemas.google.com/g/2005#home'
      primary='true'>
      456
    </gd:phoneNumber>
    <gd:extendedProperty name="pet" value="hamster" />
  </entry>
</feed>

  2. Feed 在一次响应中返回的内容不超过 10MB。接收者 获取整个联系人列表，并反复遵循返回的 Feed 的 下一个链接，直到您在退货 Feed 中不再显示该链接为止。

使用查询参数获取共享联系人

您可以请求获取与指定 条件，例如请求在给定日期之后更新的联系人。没有任何 支持全文查询或按电子邮件地址查找联系人。对于 支持的查询参数的完整列表，请参阅 网域共享联系人 API 参考指南。

  1. 向联系人供稿网址发送 HTTP GET 请求，并指定 参数：

    GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION?PARAMETER

    替换以下内容：

    • DOMAIN：您的网域的网址，例如 example.com。
    • PROJECTION：用于指定 gd:extendedProperty 元素。有关支持的值的列表，请参阅 投影值。
    • PARAMETER：支持的查询之一 参数。如需了解详情，请参阅 网域共享联系人 API 参考指南。

    例如，要使域共享联系人条目在 2022 年 3 月 16 日（针对 example.com）向共享的网域发送 HTTP 请求 联系 Feed 网址，并在请求网址中添加 updated-min 参数：

    GET https://www.google.com/m8/feeds/contacts/example.com/full?updated-min=2022-03-16T00:00:00

    当您发送该 GET 请求时，服务器会返回 HTTP 200 OK 状态代码以及包含以前删除的所有域共享联系人的供稿， 在指定日期之后创建或更新。

  2. Feed 在一次响应中返回的内容不超过 10MB。接收者 获取符合指定条件的完整联系人列表， 点击返回的 Feed 的下一个链接，直到您看不到该链接为止 。

跟踪增量更改

要跟踪对域共享联系人列表的增量更改，请执行以下操作： 以下： 1.发送 Feed 请求时，请跟踪 Feed 的 <updated> 元素。 1. 您只能获取自以下时间以来发生更改的网域共享联系人： 通过设置查询参数 将 updated-min 设置为该 <updated> 值，并设置 showdeleted 到 true。

获取单个共享联系人

要获取单个共享联系人，您必须使用该联系人的自链接。您可以 只能通过在 共享联系人供稿。如果您不确定要为自链接使用什么值， 请参阅获取所有联系人 和 使用查询参数获取联系人。

  1. 要获取特定的网域共享联系人，请发送 HTTP GET 向联系人的自链接提出请求： 
    GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/:SELF_LINK>
    替换以下内容：
  • DOMAIN：您的网域的网址，例如 example.com。
  • PROJECTION：用于指定 gd:extendedProperty 元素。有关支持的值的列表，请参阅 投影值。
  • SELF_LINK：唯一数值，表示 单个共享联系人（例如 12345）。

然后，服务器将返回 HTTP 200 OK 状态代码以及包含 联系。

例如，要获取自链接设置为 https://www.google.com/m8/feeds/contacts/example.com/full/12345，请发送 以下 HTTP 请求：

GET https://www.google.com/m8/feeds/contacts/example.com/full/12345

后续步骤