Google Drive API中allowFileDiscovery权限何时生效？能否通过API设置？

Google Drive中，即便将文件权限设为「域内任何人可访问」或「互联网持链接用户可访问」，这类文件默认也不会被搜索引擎或Drive内部搜索发现——因为默认遵循私下分享逻辑，allowFileDiscovery字段默认值为false。

何时allowFileDiscovery会为true？ #

仅当文件被设置为完全公开可搜索的场景下，该字段值才会是true：

• 在Drive网页端，将文件权限设置为「互联网上任何人可查找并查看」（区别于仅持链接可访问的权限）
• 通过域管理员配置的全局共享规则，强制指定文件可被域内搜索发现

能否通过API设置该标志？ #

可以。调用Drive API的权限创建或更新接口时，指定allowFileDiscovery: true即可，但需满足两个前提：

1. 权限类型必须为anyone或domain（与官方定义一致）
2. 操作账号拥有文件的所有者权限或可编辑的协作权限

以下是创建权限时设置该字段的请求示例：

{
  "type": "anyone",
  "role": "reader",
  "allowFileDiscovery": true
}

执行该请求后，文件会变为可公开搜索状态，对应allowFileDiscovery字段值为true。

注意：设置为true后，文件可能被Google索引并出现在公开搜索结果中，操作前请确认内容适合公开。

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