如何为Google Contacts的更新与创建实现Webhooks

Google Contacts没有直接提供Webhook支持，但可以通过People API的watch方法搭配Cloud Pub/Sub来实现联系人创建/更新事件的实时推送，满足你的同步需求。

具体实现步骤 #

• 配置Cloud Pub/Sub：

  1. 在Google Cloud控制台创建一个Pub/Sub主题，用于接收Contacts的变更事件
  2. 创建该主题的推送订阅，把你的应用接收通知的HTTPS URL填进去（确保这个URL能被Google公网访问）

• 订阅Contacts变更事件：
  调用People API的people.watchContacts方法（监控所有联系人）或people.watchContactGroups（监控指定分组），向Google注册订阅。示例请求：

  POST https://people.googleapis.com/v1/people/me/connections:watch
  Authorization: Bearer {用户授权后的access_token}
  Content-Type: application/json
  
  {
    "topicName": "projects/{你的GCP项目ID}/topics/{创建的主题名}",
    "label": "contacts_sync_subscription"
  }
  

  成功调用后会返回订阅的有效期（通常7天），你需要定期重新调用watch来续期，避免订阅失效。

• 处理事件并同步数据：
  当Contacts有联系人创建/更新时，Pub/Sub会向你配置的应用URL推送事件通知。你需要：

  1. 验证请求合法性（通过Google Pub/Sub的推送验证规则，拦截恶意请求）
  2. 根据通知里的标识，调用People API拉取最新的联系人详情（比如用people.get或connections.list接口）
  3. 将获取到的联系人数据写入你的应用数据库

关键注意点 #

• 必须获得用户的OAuth 2.0授权权限：需要申请contacts.readonly（只读同步）或contacts（读写）权限
• 订阅续期逻辑：因为watch订阅有有效期，要提前实现自动续期的定时任务
• 幂等处理：同一个变更事件可能被多次推送，要通过联系人ID等唯一标识做重复校验，避免重复存储

内容的提问来源于stack exchange，提问作者Deependra Gupta