使用Google Apps Script生成Etag字符串及解决Google People API更新联系人的Etag缺失报错问题

1. 未保存创建时的Etag，如何获取当前有效的Etag？ #

你没法凭空生成Etag，必须先通过API获取该联系人的最新状态来拿到对应的Etag。具体来说，调用People.People.get()方法，指定要获取的字段包含metadata（或者直接关联metadata.sources.etag的相关字段），示例代码如下：

const contact = People.People.get("people/c6679930577989153852", {
  personFields: "metadata,emailAddresses" // 按需添加你需要的其他字段
});
// 提取全局Etag，适用于整体更新
const etag = contact.etag;
// 或者提取特定来源的Etag（如果需要针对某个数据源更新）：
// const sourceEtag = contact.metadata.sources[0].etag;

拿到这个Etag后，把它加入更新请求的body里即可。

2. 是否可以通过函数生成新的Etag来强制更新整个联系人？ #

不行。Etag是Google服务器为每个联系人的当前版本生成的唯一标识，核心作用是实现乐观锁——确保你更新的是联系人的最新状态，避免并发修改冲突。你自己生成的任意字符串都不被API认可，会直接触发错误。所以必须获取当前联系人的有效Etag才能进行合法更新。

3. 如何创建updatePersonFields掩码？ #

updatePersonFields是用来指定你要更新的字段的掩码，API只会处理你明确列出的字段。比如你要更新邮箱地址，就把这个参数设为"emailAddresses"；如果要同时更新邮箱和姓名，就用逗号分隔多个字段："emailAddresses,names"。

结合Etag的完整更新代码示例：

// 先获取联系人最新信息和对应Etag
const contact = People.People.get("people/c6679930577989153852", {
  personFields: "metadata,emailAddresses"
});

// 构造更新请求体，带上获取到的Etag
const updateBody = {
  etag: contact.etag,
  emailAddresses: [{ "type": "work", "value": "example@gmail.com" }]
};

// 执行更新操作，指定要更新的字段掩码
People.People.updateContact(
  updateBody,
  "people/c6679930577989153852",
  { updatePersonFields: "emailAddresses" }
);

关于Google Apps Script生成Etag字符串的说明 #

再次明确：Etag无法通过本地函数生成。它是Google服务器根据联系人的当前数据状态计算出的专属标识，只能通过调用People.People.get()或People.People.list()等接口，从返回的联系人数据中提取，没有其他合法途径生成有效的Etag。

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