在 Google Classroom 以外的地方建立附件

本指南說明如何在網站或應用程式中建立外掛程式附件。 互動情形與使用 CourseWork API 建立作業類似 端點實作這個歷程，讓使用者建立外掛程式附件 網站或應用程式

重要事項： 如果您符合以下條件，強烈建議您實作這項連結建立流程： 您可以建立 CourseWork 作業。擴充課程作業 功能可讓您將更多使用者轉換為外掛程式， 必須多費工夫。

警告： 目前的資格檢查端點即將由新的端點取代 資格檢查架構你可以要求存取權 完成資格檢查，courses.checkAddOnCreationEligibility 存取權要求表單。

工作流程

大致來說，附件建立流程會依以下順序執行：

1. 老師使用者開啟您的網站或應用程式。他們選擇一段內容 並指派給學生。
2. 檢查使用者是否能建立外掛程式附件。
3. 如果使用者「無法」建立外掛程式附件，請建立 CourseWork 使用所選內容的網址指派為 Link Material。
4. 如果使用者「可以」建立外掛程式附件，請按照下列步驟操作：
   1. 建立作業。
   2. 建立外掛程式附件，連至所選內容，並 並與新作業建立關聯
5. 通知老師作業已成功建立。

我們會在以下各節中說明每個動作。

檢查使用者能否建立外掛程式附件

您可以代表符合資格的使用者建立外掛程式附件。符合資格 使用者是您所在課程中的老師 課程作業包含 Teaching and Learning Upgrade學習或 Education Plus 獲派 Google Workspace for Education 版本授權。

重點： 每個外掛程式附件的建立資格可能不同 稍後您會在 BigQueryML AutoML 和自訂訓練中使用這些模型建立外掛程式前，請務必先確認使用者是否符合使用資格 附件。

首先，請先決定使用者是否能在指定的 Course 中建立外掛程式。 向 courses.checkAddOnCreationEligibility 端點發出要求。 包括課程 ID

Python

eligibility_response = (
  classroom_service.courses()
  .checkAddOnCreationEligibility(courseId=course_id)
  .execute()
)
is_create_attachment_eligible = (
  eligibility_response.get('isCreateAttachmentEligible')
)
print(f'User eligibility for course {eligibility_response.get("courseId")}'
      f': {is_create_attachment_eligible}.')

如果使用者符合資格，回應會包含布林值 isCreateAttachmentEligible的值已設為 true。如果使用者不符合資格 回應不會傳回 isCreateAttachmentEligible 布林值。

根據使用者的資格轉送

您是否可以建立使用者的外掛程式附件取決於資格條件。

重要事項： 外掛程式可為使用者體驗帶來顯著優勢。一律建立 符合資格的使用者適用的外掛程式附件。

不符資格的使用者

如果使用者「無法」建立外掛程式附件，請先建立新的 CourseWork 將使用者所選內容網址指派為 Link。

Python

if not is_create_attachment_eligible:
  coursework = {
    'title': 'My CourseWork Assignment with Link Material',
    'description': 'Created using the Classroom CourseWork API.',
    'workType': 'ASSIGNMENT',
    'state': 'DRAFT',  # Set to 'PUBLISHED' to assign to students.
    'maxPoints': 100,
    'materials': [
      {'link': {'url': my_content_url}}
    ]
  }

  assignment = (
    service.courses()
    .courseWork()
    .create(courseId=course_id, body=coursework)
    .execute()
  )

  print(
    f'Link Material assignment created with ID: {assignment.get("id")}'
  )

回應包含指定課程中的作業，其中含有內容 。使用者只要按一下 Link，就能在新的 分頁。

圖 1. 老師檢視畫面顯示含有 Link Material 的 CourseWork 作業草稿。

符合資格的使用者

如果使用者「可以」建立外掛程式附件，請按照下列步驟操作。

1. 建立不含任何附件的新「CourseWork」作業。
2. 建立外掛程式附件。
   • 將 AddOnAttachment 的 itemId 設為新建的 id 作業。
   • 確認您替使用者在每個資料檢視選取的內容提供網址 問題

Python

if is_create_attachment_eligible:
  coursework = {
    'title': 'My CourseWork Assignment with Add-on Attachment',
    'description': 'Created using the Classroom CourseWork API.',
    'workType': 'ASSIGNMENT',
    'state': 'DRAFT',  # Set to 'PUBLISHED' to assign to students.
    'maxPoints': 100,
  }

  assignment = (
    classroom_service.courses()
    .courseWork()
    .create(courseId=course_id, body=coursework)
    .execute()
  )

  print(
    f'Empty assignment created with ID: {assignment.get("id")}'
  )

  attachment = {
    'teacherViewUri': {'uri': teacher_view_url},
    'studentViewUri': {'uri': student_view_url},
    'studentWorkReviewUri': {'uri': grade_student_work_url},
    'title': f'Test Attachment {test_label}',
  }

  add_on_attachment = (
    service.courses()
    .courseWork()
    .addOnAttachments()
    .create(
      courseId=course_id,
      itemId=assignment.get("id"),  # ID of the new assignment.
      body=attachment,
    )
    .execute()
  )

  print(
    f'Add-on attachment created with ID: {add_on_attachment.get("id")}'
  )

注意： 如要在作業中建立連結，不需要外掛程式權杖 清單。

外掛程式會在 Classroom 中以附件資訊卡的形式顯示。網址 會在 API 的 每個資料檢視的 iframe。