建立共用聯絡人

設定驗證程序後，您可以使用 Domain Shared Contacts API 將新的共用聯絡人項目發布至 Google Workspace 網域。共用聯絡人資料最多可能要經過 24 小時才會顯示在電子郵件地址自動完成功能和聯絡人管理員中。

1. 建立要以 聯絡人類型的 Atom <entry> 元素形式發布的共用聯絡人的 XML 表示法，可能類似以下內容：

   <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：共用聯絡人的首選電子郵件地址，例如 [e-mail]。
   • PREFERRED_NAME：使用者顯示的名稱，例如 Alex Kim
   • SECONDARY_EMAIL_ADDRESS：共用聯絡人的另一個電子郵件地址，例如 [e-mail]。
   • PRIMARY_PHONE_NUMBER：共用聯絡人的首選電話號碼，例如 [phone]。
   • SECONDARY_PHONE_NUMBER：共用聯絡人的其他電話號碼，例如 [phone]。
   • INSTANT_MESSAGING_ADDRESS：與共用聯絡人的即時通訊資訊相關聯的電子郵件地址，例如 [e-mail]。
   • CITY_NAME：共用聯絡人的城市名稱，例如 Mountain View。
   • ADDRESS：共用聯絡人的街道地址，例如 1600 Amphibious Blvd。
   • REGION_NAME：共用聯絡人的州或省，例如 CA。
   • POST_CODE：共用聯絡人的郵遞區號，例如 94045。
   • COUNTRY_NAME：共用聯絡人的國家/地區，例如美國。
   • FORMATTED_ADDRESS：共用聯絡人的地址，其格式採用國家/地區或區域的慣例，例如 1800 Amphibious Blvd Mountain View。

2. 如要發布這項項目，請將其傳送至聯絡人清單動態消息網址：

   1. 使用 application/atom+xml 內容類型，將 Atom <entry> 元素放入新 POST 要求的主體中。
   2. 將 POST 要求傳送至動態饋給網址。

   舉例來說，如要將網域共用聯絡人加入屬於 example.com 的清單，請將 POST 要求連同新項目傳送至以下網址：

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

   Google 伺服器會使用您傳送的項目建立聯絡人，然後傳回 HTTP 201 CREATED 狀態碼，以及新聯絡人的副本，並以 <entry> 元素的形式呈現。系統會傳回與您傳送的項目相同的項目，但也會包含伺服器新增的各種元素，例如 <id> 元素。

   如果要求失敗，Google 可能會傳回不同的狀態碼。如要瞭解狀態碼，請參閱 Google Data API 通訊協定參考文件。

後續步驟

• 更新或刪除共用聯絡人的相片