谷歌ContactsGroup API报错：缺少Fingerprint参数，无法更新标签

Fingerprint参数是什么？ #

Fingerprint是Google People API的乐观并发控制标识，说白了就是目标联系人标签的「版本号」。每次标签被修改（包括刚创建时），API都会生成一个新的fingerprint。它的作用是防止多人同时修改同一个标签时，出现旧数据覆盖新数据的冲突——只有携带当前最新的fingerprint，更新请求才会被认可。

怎么解决这个错误？ #

1. 先获取目标标签的fingerprint #

更新前必须先调用contactGroups.get接口，拿到目标标签的完整数据，从中提取fingerprint字段。返回的示例数据大概是这样：

{
  "resourceName": "contactGroups/xxxxxx",
  "fingerprint": "aBcD1234EfGh",
  "name": "原标签名称",
  ...
}

2. 携带fingerprint发起更新请求 #

更新的请求体里必须包含fingerprint，再加上你要修改的内容（比如新的标签名）。示例请求体：

{
  "fingerprint": "aBcD1234EfGh",
  "name": "我的新标签"
}

不需要提交标签的全部字段，只带fingerprint和要改的内容就行。

3. API Explorer里的操作步骤 #

在API Explorer里操作时，别直接去填更新的内容：先调用contactGroups.get拿到fingerprint，然后切到contactGroups.update的请求体，手动加上这个fingerprint字段再提交。

额外提醒 #

• 如果收到"Fingerprint mismatch"错误，说明你用的fingerprint不是最新的，重新调用contactGroups.get获取就行。
• 为啥创建、删除标签没问题？因为这俩操作是新建或销毁资源，不存在并发修改的冲突，所以不需要验证fingerprint。

内容的提问来源于stack exchange，提问作者Sergey Kozlovskiy