Domain Shared Contacts API 總覽

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

警告： Domain Shared Contacts API 僅適用於外部聯絡人。 使用這項 API 為內部使用者或群組建立聯絡資訊，可能會導致資訊重複和發生非預期行為。如要管理 Google Workspace 內部使用者的聯絡資訊，請使用 Directory API。

您可以使用 Domain Shared Contacts API 建立、編輯或刪除共用聯絡人， 並查詢符合特定條件的聯絡人。

Domain Shared Contacts API 僅適用於 Google Workspace 帳戶。 如要使用 API，請在管理控制台中啟用 Domain Shared Contacts API。變更最多可能需要 24 小時才會反映在自動完成功能和聯絡人管理工具中。

本文將介紹 Domain Shared Contacts API 的背景資訊，並提供使用 XML 和 HTTP 管理聯絡人的範例。詳情請參閱用戶端程式庫。

觀眾

本文適用於編寫用戶端應用程式的開發人員，這類應用程式會使用 HTTP 和 XML 操作 Google 聯絡人清單。本文假設您已瞭解 Google Data API 通訊協定。

Linux 和 macOS 使用者可以透過 curl 或 wget 嘗試本文中的範例。請參閱「搭配 Google Data API 使用 curl」。

原則

Domain Shared Contacts API 遵循 Google Data API 的原則。Google Data API 以 Atom 1.0、RSS 2.0 和 Atom 發布通訊協定為基礎。

指定版本

使用 Domain Shared Contacts API 傳送的所有要求都應指定 3.0 版：

GData-Version: 3.0

如果無法設定 HTTP 標頭，請將 v=3.0 指定為查詢參數。 建議使用 HTTP 標頭方法。

注意： 用戶端程式庫會自動提供版本標頭。 請勿搭配用戶端程式庫使用 v=3.0 參數。