
Google Forms API本身不提供在特定Google Drive文件夹中创建表单的功能。本教程将指导您如何结合使用Google Drive API和Google Forms API,首先利用Drive API在目标文件夹中创建表单的占位符文件,然后使用Forms API填充表单内容,从而实现在指定位置创建Google表单。
在使用Python通过Google Forms API创建Google表单时,一个常见的限制是无法直接指定表单的存储位置。默认情况下,所有新创建的表单都会被放置在您的Google Drive根目录中。这对于需要将表单组织到特定项目或分类文件夹中的用户来说,带来了额外的手动管理负担。Google Forms API的文档中并未提供类似parents这样的参数来在创建时指定父文件夹。
要解决这一问题,我们需要理解Google表单在Google生态系统中的本质:它被视为Google Drive中的一种特殊文件类型(MIME类型为application/vnd.google-apps.form)。因此,我们可以利用Google Drive API的强大功能来管理这些“文件”的位置。
核心思路是:
立即学习“Python免费学习笔记(深入)”;
通过这种两步走的策略,我们既能利用Drive API的文件夹管理能力,又能利用Forms API的表单内容编辑能力。
在开始编写代码之前,请确保您已完成以下准备工作:
安装必要的库:
pip install google-api-python-client google-auth-oauthlib google-auth-httplib2
启用Google API: 在Google Cloud Console中,为您的项目启用“Google Drive API”和“Google Forms API”。
设置认证凭据: 下载您的OAuth 2.0客户端凭据文件(通常命名为credentials.json),并将其放置在您的Python脚本同一目录下。 您需要配置正确的API作用域(Scopes)。对于本教程,以下作用域是推荐的:
以下是认证代码的通用模板:
import os
from google.auth.transport.requests import Request
from google.oauth2.credentials import Credentials
from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build
# 定义API作用域
SCOPES = [
"https://www.googleapis.com/auth/drive.file",
"https://www.googleapis.com/auth/forms.body"
]
creds = None
# token.json 存储了用户上一次授权的凭据,如果存在,则直接加载
if os.path.exists("token.json"):
creds = Credentials.from_authorized_user_file("token.json", SCOPES)
# 如果没有有效的凭据,则让用户登录
if not creds or not creds.valid:
if creds and creds.expired and creds.refresh_token:
creds.refresh(Request())
else:
flow = InstalledAppFlow.from_client_secrets_file("credentials.json", SCOPES)
creds = flow.run_local_server(port=0)
# 将凭据保存到 token.json,以便下次使用
with open("token.json", "w") as token:
token.write(creds.to_json())
# 构建Drive和Forms服务客户端
drive_service = build("drive", "v3", credentials=creds)
form_service = build("forms", "v1", credentials=creds)接下来,我们将详细介绍如何实现上述两步策略。
首先,您需要知道目标Google Drive文件夹的ID。您可以通过以下方式获取:
# 替换为您的目标文件夹ID target_folder_id = "YOUR_TARGET_FOLDER_ID"
使用drive_service.files().create()方法来创建文件。关键在于设置正确的mimeType为application/vnd.google-apps.form,并指定parents参数为目标文件夹ID。
# 文件元数据,指定名称、MIME类型和父文件夹
file_metadata = {
"name": "我的新项目表单", # 这是在Drive中显示的文件名
"mimeType": "application/vnd.google-apps.form",
"parents": [target_folder_id]
}
try:
# 创建文件,并请求返回文件ID
created_file = drive_service.files().create(
body=file_metadata,
fields="id"
).execute()
form_id = created_file.get("id")
print(f"空白表单已在指定文件夹中创建,ID: {form_id}")
except Exception as e:
print(f"创建表单文件时发生错误: {e}")
form_id = None # 确保在出错时form_id为None执行此步骤后,一个名为“我的新项目表单”的空白Google表单将出现在您指定的Google Drive文件夹中。form_id变量将包含此新表单的唯一标识符。
现在我们有了form_id,可以使用form_service.forms().batchUpdate()方法来修改表单的标题、描述以及添加问题等。
if form_id:
# 构建更新请求体
# 这里我们更新表单的标题和文档标题,并添加一个文本问题
update_requests = {
"requests": [
{
"updateFormInfo": {
"info": {
"title": "项目反馈表单", # 这是表单在Forms界面中显示的标题
"documentTitle": "项目反馈表单 - 2023 Q4" # 这是Drive中显示的文件名,与name一致更佳
},
"updateMask": "title,documentTitle"
}
},
{
"createItem": {
"item": {
"title": "您的姓名?",
"questionItem": {
"question": {
"textQuestion": {
"paragraph": False
}
}
}
},
"location": {
"index": 0 # 在表单开头添加
}
}
},
{
"createItem": {
"item": {
"title": "您对本次项目的总体评价是?",
"questionItem": {
"question": {
"choiceQuestion": {
"type": "RADIO",
"options": [
{"value": "非常满意"},
{"value": "满意"},
{"value": "一般"},
{"value": "不满意"}
]
}
}
}
},
"location": {
"index": 1 # 在第一个问题之后添加
}
}
}
]
}
try:
# 执行批量更新操作
form_service.forms().batchUpdate(
formId=form_id,
body=update_requests
).execute()
print(f"表单 '{form_id}' 内容已成功更新。")
except Exception as e:
print(f"更新表单内容时发生错误: {e}")
else:
print("无法更新表单,因为表单ID无效。")将上述认证、创建和更新步骤整合到一个脚本中:
import os
from google.auth.transport.requests import Request
from google.oauth2.credentials import Credentials
from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build
# --- 1. 认证和API服务构建 ---
SCOPES = [
"https://www.googleapis.com/auth/drive.file",
"https://www.googleapis.com/auth/forms.body"
]
creds = None
if os.path.exists("token.json"):
creds = Credentials.from_authorized_user_file("token.json", SCOPES)
if not creds or not creds.valid:
if creds and creds.expired and creds.refresh_token:
creds.refresh(Request())
else:
flow = InstalledAppFlow.from_client_secrets_file("credentials.json", SCOPES)
creds = flow.run_local_server(port=0)
with open("token.json", "w") as token:
token.write(creds.to_json())
drive_service = build("drive", "v3", credentials=creds)
form_service = build("forms", "v1", credentials=creds)
# --- 2. 定义目标文件夹ID ---
# 替换为您的目标文件夹ID
target_folder_id = "YOUR_TARGET_FOLDER_ID"
if target_folder_id == "YOUR_TARGET_FOLDER_ID":
print("错误:请将 'YOUR_TARGET_FOLDER_ID' 替换为实际的Google Drive文件夹ID。")
exit()
form_id = None
try:
# --- 3. 通过Drive API在指定文件夹中创建空白Google表单 ---
file_metadata = {
"name": "我的新项目表单",
"mimeType": "application/vnd.google-apps.form",
"parents": [target_folder_id]
}
created_file = drive_service.files().create(
body=file_metadata,
fields="id"
).execute()
form_id = created_file.get("id")
print(f"空白表单已在指定文件夹中创建,ID: {form_id}")
# --- 4. 通过Forms API填充和更新表单内容 ---
if form_id:以上就是使用Python在指定Google Drive文件夹中创建Google表单的教程的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号