如何用Domain Shared Contacts API+Python创建全员可见的Google Workspace外部联系人？

核心原因 #

Domain Shared Contacts API 创建的外部联系人默认不会出现在Gmail联系人的「目录」标签下（该标签仅默认展示域内用户/群组），且普通用户需手动开启共享联系人的显示权限，同时创建联系人时需明确设置域可见性。

步骤1：检查Admin控制台共享联系人配置 #

• 登录Google Workspace Admin控制台
• 进入「应用」>「Google Workspace」>「联系人」>「共享联系人设置」
• 确保「启用域共享联系人」已勾选，且权限设置为「所有域用户均可查看共享联系人」

步骤2：调整联系人创建的XML内容 #

在POST的联系人XML中，必须添加域可见性标记，确保联系人对整个域开放：

<entry xmlns="http://www.w3.org/2005/Atom"
       xmlns:gd="http://schemas.google.com/g/2005"
       xmlns:gContact="http://schemas.google.com/contact/2008">
  <category scheme="http://schemas.google.com/g/2005#kind"
            term="http://schemas.google.com/contact/2008#contact"/>
  <title type="text">John Doe</title>
  <gd:email address="john.doe@example.com" primary="true"/>
  <gd:phoneNumber rel="http://schemas.google.com/g/2005#work" primary="true">+1-555-123-4567</gd:phoneNumber>
  <!-- 关键：添加域可见性设置 -->
  <gd:visibility value="domain"/>
</entry>

步骤3：指导用户开启共享联系人显示 #

普通用户需手动在联系人管理器中开启显示：

• 打开contacts.google.com并登录
• 点击左侧菜单的「更多」选项
• 勾选「显示域共享联系人」
• 此时共享联系人会出现在「其他联系人」列表或单独的「域共享联系人」分组中（而非「目录」标签，这是正常设计）

补充说明 #

如果需要让外部联系人在邮件撰写的自动补全中更优先展示，或在Admin控制台的「目录」>「联系人」中可见，上述步骤已覆盖——Admin控制台的「目录联系人」就是通过Domain Shared Contacts API管理的资源，普通用户通过开启显示权限即可访问。

内容的提问来源于stack exchange，提问作者Raman K.