创建共享联系人

设置身份验证后，您可以使用 Domain Shared Contacts API 将新的共享联系人条目发布到 Google Workspace 网域。共享的联系人最长可能需要 24 小时才能显示在电子邮件地址自动补全功能和联系人管理器中。

  1. 创建您要发布的共享联系人的 XML 表示形式，该表示形式应为 Contact kind（联系人类型）的 Atom <entry> 元素，可能类似于以下内容：

    <atom:entry xmlns:atom='http://www.w3.org/2005/Atom'
    xmlns:gd='http://schemas.google.com/g/2005'>
  <atom:category scheme='http://schemas.google.com/g/2005#kind'
    term='http://schemas.google.com/contact/2008#contact' />
  <gd:name>
     <gd:givenName>FIRST_NAME</gd:givenName>
     <gd:familyName>LAST_NAME</gd:familyName>
     <gd:fullName>FIRST_NAME LAST_NAME</gd:fullName>
  </gd:name>
  <atom:content type='text'>NOTES</atom:content>
  <gd:email rel='http://schemas.google.com/g/2005#work'
    primary='true'
    address='PRIMARY_EMAIL_ADDRESS' displayName='PREFERRED_NAME' />
  <gd:email rel='http://schemas.google.com/g/2005#home'
    address='SECONDARY_EMAIL_ADDRESS' />
  <gd:phoneNumber rel='http://schemas.google.com/g/2005#work'
    primary='true'>
    PRIMARY_PHONE_NUMBER
  </gd:phoneNumber>
  <gd:phoneNumber rel='http://schemas.google.com/g/2005#home'>
    SECONDARY_PHONE_NUMBER
  </gd:phoneNumber>
  <gd:im address='INSTANT_MESSAGING_ADDRESS'
    protocol='http://schemas.google.com/g/2005#GOOGLE_TALK'
    primary='true'
    rel='http://schemas.google.com/g/2005#home' />
  <gd:structuredPostalAddress
      rel='http://schemas.google.com/g/2005#work'
      primary='true'>
    <gd:city>CITY_NAME</gd:city>
    <gd:street>ADDRESS</gd:street>
    <gd:region>REGION_NAME</gd:region>
    <gd:postcode>POST_CODE</gd:postcode>
    <gd:country>COUNTRY_NAME</gd:country>
    <gd:formattedAddress>
      FORMATTED_ADDRESS
    </gd:formattedAddress>
  </gd:structuredPostalAddress>
</atom:entry>

    替换以下内容：

    • FIRST_NAME：所分享联系人的名字，例如 Alex。
    • LAST_NAME：要共享的联系人的姓氏，例如“Kim”。
    • PRIMARY_EMAIL_ADDRESS：共享联系人的首选电子邮件地址，例如 alk@gmail.com。
    • PREFERRED_NAME：向用户显示的名称，例如 Alex Kim
    • SECONDARY_EMAIL_ADDRESS：共享联系人的另一个电子邮件地址，例如 alk@example.org。
    • PRIMARY_PHONE_NUMBER：共享联系人的首选电话号码，例如 (800) 555-0100。
    • SECONDARY_PHONE_NUMBER：所分享联系人的另一个电话号码，例如 (800) 555-0101。
    • INSTANT_MESSAGING_ADDRESS：与所分享联系人的即时通讯信息关联的电子邮件地址，例如 alk@gmail.com。
    • CITY_NAME：共享联系人的城市名称，例如山景城。
    • ADDRESS：共享联系人的街道地址，例如 1600 Amphibious Blvd。
    • REGION_NAME：共享联系人的州或省级行政区，例如 CA。
    • POST_CODE：共享联系人的邮政编码，例如 94045。
    • COUNTRY_NAME：共享联系人的所在国家/地区，例如美国。
    • FORMATTED_ADDRESS：共享联系人的地址，采用其所在国家/地区的惯例设置格式，例如 1800 Amphibious Blvd Mountain View。

  2. 如需发布此条目，请将其发送到联系人名单 Feed 网址：

    1. 使用 application/atom+xml 内容类型将 Atom <entry> 元素放入新的 POST 请求正文中。
    2. 向 Feed 网址发送 POST 请求。

    例如，如需将网域共享联系人添加到 example.com 所属的列表，请将包含新条目的 POST 请求发送到以下网址：

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

    Google 服务器会使用您发送的条目创建联系人，然后返回 HTTP 201 CREATED 状态代码以及新联系人的副本（采用 <entry> 元素的形式）。返回的条目与您发送的条目相同，但还包含服务器添加的各种元素，例如 <id> 元素。

    如果您的请求失败，Google 可能会返回其他状态代码。如需了解状态代码，请参阅 Google Data API 协议参考文档。

后续步骤