Domain Shared Contacts API 總覽

Domain Shared Contacts API 可讓您的應用程式取得及更新與 Google Workspace 網域中所有使用者共用的外部聯絡人。Google Workspace 網域的所有使用者都能看到共用聯絡人,且所有 Google 服務都能存取聯絡人清單。

您的應用程式可以使用 Domain Shared Contacts API 建立共用聯絡人、編輯或刪除現有共用聯絡人,以及查詢符合特定條件的共用聯絡人。

Domain Shared Contacts API 僅適用於 Google Workspace 帳戶。 如要使用 API,請在管理控制台中啟用 Domain Shared Contacts API。共用聯絡人的變更最多可能需要 24 小時,才會反映在電子郵件地址自動完成功能和聯絡人管理員中。

除了介紹網域共用聯絡人 API 的功能外,本文也提供範例,說明如何使用 XML 和 HTTP 管理聯絡人。閱讀本文後,您可以進一步瞭解如何使用用戶端程式庫與 API 互動。

觀眾

本文適用於想編寫用戶端應用程式的開發人員,這類應用程式可使用 HTTP 和 XML 操控 Google 聯絡人名單。本文假定您瞭解 Google Data APIs 通訊協定背後的基礎知識

如果您使用 UNIX 作業系統,且想試用本文中的範例,但不想編寫任何程式碼,請使用 UNIX 指令列公用程式 curlwget。瞭解如何搭配 Google Data 服務使用 cURL

原則

這個版本的 Domain Shared Contacts API 遵循 Google Data API 的原則。Google Data API 除了 Atom 發布通訊協定外,也採用 Atom 1.0 和 RSS 2.0 聯合發布格式。

指定版本

使用 Domain Shared Contacts API 傳送的每項要求都應指定 API 3.0 版:

GData-Version: 3.0

如果無法設定 HTTP 標頭,您可以在網址中將 v=3.0 指定為查詢參數,但建議使用 HTTP 標頭方法。