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 小時，才會在電子郵件地址自動完成和聯絡人管理員中反映。
除了提供 Domain Shared Contacts API 的功能背景資訊外，本文件還提供範例，協助您瞭解如何使用 XML 和 HTTP 管理聯絡人。閱讀本文件後，建議您使用我們的用戶端程式庫，進一步瞭解如何與 API 互動。
適用對象
本文件可協助開發人員編寫用戶端應用程式，以便使用 HTTP 和 XML 操控 Google 聯絡人清單。本文假設您已瞭解 Google Data API 通訊協定的基礎知識。
如果您使用的是 UNIX 作業系統，且想要在不編寫任何程式碼的情況下嘗試本文中的範例，請使用 UNIX 指令列公用程式 curl 或 wget。瞭解如何將 cURL 與 Google Data 服務搭配使用。
原則
這個版本的 Domain Shared Contacts API 遵循 Google Data API 的原則。除了 Atom 發布通訊協定之外，Google Data API 也同時採用 Atom 1.0 和 RSS 2.0 聯合發布格式。
指定版本
您使用 Domain Shared Contacts API 傳送的所有要求都必須指定 3.0 版的 API：
GData-Version: 3.0
如果您無法設定 HTTP 標頭，可以在網址中將 v=3.0 指定為查詢參數，但建議使用 HTTP 標頭方法。