本指南介绍了将您的服务或应用与 Google 课堂相关联的选项。选择以下任一途径,即可在 Google 课堂的信息流内容中向用户提供您的内容。
集成选项
您可以通过以下三种方式将学习资料关联到 Google 课堂:
- 在您的产品中嵌入 Google 课堂分享按钮
 - 使用 
CourseWorkAPI 创建和管理包含指向商品的超链接的直播内容 - 构建 Google 课堂插件,让用户能够在 Google 课堂中发现和访问您的内容
 
“课堂分享”按钮的集成最为简单。您在 Web 应用中嵌入脚本。该脚本会生成一个按钮,用户点击该按钮即可创建 Google 课堂动态项。不过,您的应用在创建这些数据流项后将无法访问这些数据流项,也无法访问任何其他 Google 课堂数据。
CourseWork API 和 Google 课堂插件路径要求您的 Web 应用使用 Google 课堂 API 请求直接控制信息流项及其内容。您的应用会保留对通过任一路径创建的直播内容或其他资源的访问权限。您还可以请求用户授予权限,以访问其他 Google 课堂数据。不过,您需要负责托管、测试和维护与 Google 交互的所有代码。
Google 课堂插件可为您的产品提供最佳用户体验和可被发现的机会。
支持哪些用户历程?
每种集成途径都会提供不同的用户体验,以及对 Google 课堂资源的不同访问权限。请参阅以下用户体验历程矩阵,比较这三条路径。
下表中的图标表示用户体验历程是否完全受支持、不受支持或 受支持但有附加条件。点击任意 即可查看澄清信息。
| 历程 | “课堂”分享按钮 | CourseWork API | 课堂插件 | 
|---|---|---|---|
| 用户向我的应用提供 OAuth 同意 | |||
| 我可以查看与用户关联的 Google 课堂资源,例如学生名单和课程 | |||
| 我可以创建与我的内容相关联的课程 | |||
| 我可以修改自己创建的课程 | |||
| 我可以修改用户创建的课程 | |||
| 我可以为学生提交的作业设置成绩 | 
       您只能为通过程序化方式创建的课程设置成绩。您无法在 Google 课堂界面中为教师创建的课业设置成绩。 
        
       | 
      
      
    
  
    
      ||
| 我可以访问学生提交的作业中的附件 | 
       您只能访问以编程方式创建的课程作业的附件。您无法访问教师创建的课程作业附件。 
        
       | 
      
      
    
  
    
      ||
| 老师在 Google 课堂界面中发现我的资源 | 
开发者体验有何不同?
每种集成路径都会提供不同的开发者体验。请参阅以下开发者期望矩阵,比较这三种途径。
下表中的图标表示集成选项与每个开发者历程的契合度。点击任意 即可查看澄清信息。
| 历程 | “课堂”分享按钮 | CourseWork API | 课堂插件 | 
|---|---|---|---|
| 我可以构建集成,而无需购买 Google 产品 | |||
| 我可以在 Google 课堂中自定义内容的外观 | 
       您可以直接设置作业字段。Google 的网页抓取工具会检索您指定的网址链接的图标和标题。 
        
       | 
      
      
    
  
    
      ||
| 当用户在 Google 课堂中打开我的内容时,我会收到有关用户或课程的信息 | 
       您可以在 Google 课堂中创建的网址链接中编码标识详细信息。不过,这些链接很脆弱,在用户将课程作业复制到其他课程时,很容易损坏。 
        
       |