创建共享联系人

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

1. 创建要与您共享的联系人的 XML 表示 以<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：共享的姓氏 例如李明
   • PRIMARY_EMAIL_ADDRESS：首选电子邮件地址 共享联系人的电子邮件地址，例如 alk@gmail.com。
   • PREFERRED_NAME：系统显示的名称 用户，例如李明
   • 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. 要发布此条目，请将其发送至联系人列表供稿网址：

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

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

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

   Google 服务器使用您发送的条目创建联系人，然后 将返回 HTTP 201 CREATED 状态代码，以及新 以 <entry> 元素的形式指定联系人。返回的条目 但它还包含由 例如 <id> 元素。

   如果您的请求失败，Google 可能会返回 状态代码。有关状态代码的信息，请参阅 Google 数据 API 协议参考文档。

后续步骤

• 更新或删除共享联系人的照片