如何通过Java SDK删除Google Drive的appProperties字段

问题重现 #

Google Drive V3官方文档仅说明公开properties的删除方法，私有appProperties的删除仅在V2转V3迁移指南中提及——与删除properties逻辑一致，将对应值设为null。但实际测试发现，非空值的更新操作可成功执行，设为null却无效果：

例如文件ID为123的appProperties为{"hello":"world"}，执行以下代码后，返回结果中的appProperties仍保持原样：

Map<String, String> appProperties = Map.of("hello", null);
File file = new File();
file.setAppProperties(appProperties);
File response = drive.files().update("123", file).execute();

解决办法 #

要成功删除appProperties中的指定字段，核心是让API明确识别到你要修改appProperties字段，以下是两种可行方案：

方式1：使用update方法并指定setFields #

调用update时，必须通过setFields明确声明要更新appProperties字段，否则API会忽略该修改：

Map<String, String> appProperties = Map.of("hello", null);
File file = new File();
file.setAppProperties(appProperties);
File response = drive.files().update("123", file)
        .setFields("appProperties") // 必须指定该字段
        .execute();

方式2：使用patch方法（更推荐） #

patch请求本身为增量更新模式，仅处理你指定的字段，无需额外设置setFields，直接将目标key设为null即可：

Map<String, String> appProperties = Map.of("hello", null);
File file = new File();
file.setAppProperties(appProperties);
File response = drive.files().patch("123", file).execute();

额外：清空所有appProperties #

若需一次性删除所有私有属性，可直接将appProperties设为null，配合setFields（使用update时）或直接用patch：

// update写法
File file = new File();
file.setAppProperties(null);
File response = drive.files().update("123", file)
        .setFields("appProperties")
        .execute();

// patch写法
File file = new File();
file.setAppProperties(null);
File response = drive.files().patch("123", file).execute();

原因说明 #

Drive V3的update方法默认是全量替换模式，若不指定setFields，API不会主动识别你要修改appProperties字段；而patch为增量更新模式，会自动处理传入的字段修改。将key设为null确实是删除属性的正确标记，但必须让API明确知晓要操作appProperties字段，否则该修改会被忽略。

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