如何获取Classroom中特定日期的用户CourseWork？技术咨询

嘿Will，我明白你为啥觉得Calendar功能不够用了——它确实只给你日程概览，没法拿到作业的元数据或者单独的作业条目。要搞定这个，直接用Google Classroom API是最靠谱的办法，我给你详细说说怎么弄：

核心思路 #

Google Classroom API提供了专门的端点来获取CourseWork的完整元数据（比如截止日期、创建时间、作业类型、提交状态等），你可以先拉取目标课程的所有作业，再根据特定日期条件筛选出你需要的内容。

具体步骤 #

1. 前期准备 #

• 先在Google Cloud Console里启用Google Classroom API，并创建OAuth 2.0凭据（用于授权你的应用访问Classroom数据）。
• 确保你的账号有对应的权限：如果是查看自己的作业，需要classroom.coursework.me.readonly权限；如果是查看学生的作业，需要classroom.coursework.students.readonly之类的权限。

2. 调用API拉取CourseWork #

使用courses.courseWork.list端点来获取目标课程的所有作业。关键参数包括：

• courseId：目标课程的ID（你可以通过courses.list端点获取自己的课程列表）
• courseWorkStates：可选，比如指定PUBLISHED只看已发布的作业，过滤掉草稿

3. 筛选特定日期的作业 #

API没有直接的日期过滤参数，所以需要在拉取到数据后，根据作业的时间字段筛选：

• 如果要找截止日期为特定日期的作业：检查dueDate字段（包含year、month、day）
• 如果要找创建日期为特定日期的作业：检查creationTime字段（ISO 8601格式的时间戳）
• 如果要找计划发布日期为特定日期的作业：检查scheduleTime字段

代码示例（Python） #

这里用google-api-python-client库来演示：

from googleapiclient.discovery import build
from google.oauth2.credentials import Credentials
from datetime import date

# 加载凭据（假设你已经完成OAuth授权，凭据存在token.json里）
creds = Credentials.from_authorized_user_file('token.json')
service = build('classroom', 'v1', credentials=creds)

# 目标课程ID和特定日期
TARGET_COURSE_ID = 'your_course_id_here'
TARGET_DATE = date(2024, 5, 20)  # 示例：2024年5月20日

# 拉取课程的所有已发布作业
results = service.courses().courseWork().list(
    courseId=TARGET_COURSE_ID,
    courseWorkStates=['PUBLISHED']
).execute()
courseworks = results.get('courseWork', [])

# 筛选特定截止日期的作业
target_courseworks = []
for coursework in courseworks:
    due_date = coursework.get('dueDate')
    if due_date:
        # 转换为date对象对比
        coursework_date = date(
            due_date['year'],
            due_date['month'],
            due_date['day']
        )
        if coursework_date == TARGET_DATE:
            target_courseworks.append(coursework)

# 输出结果
print(f"找到{len(target_courseworks)}个截止日期为{TARGET_DATE}的作业：")
for cw in target_courseworks:
    print(f"- 作业标题：{cw['title']}")
    print(f"  作业类型：{cw['workType']}")
    print(f"  创建时间：{cw['creationTime']}\n")

注意事项 #

• 如果作业数量较多，API会返回分页结果，需要处理nextPageToken来获取所有作业。
• 有些作业可能没有dueDate（比如无截止日期的作业），筛选时要注意空值判断。
• 确保你的凭据有足够的权限，避免出现403权限错误。

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