关于通过Google Drive API获取模板及创建文档的技术咨询

1. 能否获取「新建->从模板创建」的模板列表？ #

答案分两部分说明，因为通用官方模板和域内模板的获取逻辑不一样：

域内模板（公司/组织自定义模板）

完全可以通过Drive API获取。这类模板一般存储在域内管理员指定的模板文件夹中，你可以用Files.list接口结合筛选条件来抓取：

• 核心筛选语句：q="YOUR_DOMAIN_TEMPLATE_FOLDER_ID" in parents and mimeType contains 'google-apps' and capabilities.canCopy=true
  • 把YOUR_DOMAIN_TEMPLATE_FOLDER_ID替换成域内模板库的实际文件夹ID
  • mimeType contains 'google-apps'确保只返回Google Workspace类型文件（Docs/Sheets/Slides等）
  • capabilities.canCopy=true筛选出允许被复制的模板文件

如果不清楚模板文件夹ID，可以让域管理员通过Google Workspace管理后台查看，或者给模板文件统一添加标签，再通过标签筛选来获取列表。

通用官方模板（Google默认提供的模板）

遗憾的是，Drive API并没有开放直接获取官方模板列表的端点。不过这些官方模板本质上都是公开可复制的Google Workspace文件，你可以通过两种方式处理：

• 手动维护一份常用官方模板的ID列表（比如简历、项目报表这类高频模板，Google的官方模板ID是公开可查的，注意偶尔会有更新）
• 引导用户在Drive界面选好模板后，获取该模板的文件ID，再通过API使用

2. 模板是否可复制，能否通过API创建新文档？ #

完全可以！不管是域内模板还是官方模板，只要是Google Docs/Sheets/Slides这类原生格式的文件（且模板默认开启了允许复制权限），都可以用Drive API的Files.copy方法生成新文档。

示例代码（Python）

这里用服务账号演示（如果是域内应用，记得提前启用域范围授权）：

首先安装依赖：

pip install google-api-python-client google-auth-httplib2 google-auth-oauthlib

然后编写代码：

from googleapiclient.discovery import build
from google.oauth2 import service_account

# 加载服务账号密钥文件
SERVICE_ACCOUNT_KEY_PATH = "path/to/your/service-account-key.json"
# 复制文件所需的权限
SCOPES = ["https://www.googleapis.com/auth/drive"]

# 初始化凭证
credentials = service_account.Credentials.from_service_account_file(
    SERVICE_ACCOUNT_KEY_PATH, scopes=SCOPES
)
# 如果需要代表域内某个用户创建文档（文档归属该用户），添加下面一行
# credentials = credentials.with_subject("user@your-domain.com")

# 创建Drive API服务实例
drive_service = build("drive", "v3", credentials=credentials)

# 复制模板生成新文档
template_file_id = "your-template-file-id-here"
new_doc_metadata = {
    "name": "基于模板生成的新文档",  # 新文档名称
    # 可选：指定新文档的父文件夹
    # "parents": ["target-folder-id"]
}

# 调用copy接口
response = drive_service.files().copy(
    fileId=template_file_id, body=new_doc_metadata
).execute()

print(f"新文档创建成功！文档ID: {response['id']}")

注意事项 #

• 权限验证：域内模板需要确保API调用账号有读取该模板的权限；官方公开模板无需额外权限，直接复制即可。
• 格式匹配：要确保模板是Google原生格式（比如Docs的application/vnd.google-apps.document），如果是Office文件转成的模板，复制后会保持对应格式。
• 域用户模拟：如果需要让新文档归属域内普通用户，必须给服务账号启用域范围授权，并通过with_subject指定模拟用户。

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