Google 课堂插件现已面向开发者正式推出!如需了解详情,请参阅
插件文档。
Material
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
附加到课程作业的资料。
创建附件时,不支持设置 form
、gem
或 notebook
字段。
JSON 表示法 |
{
// Union field material can be only one of the following:
"driveFile": {
object (SharedDriveFile )
},
"youtubeVideo": {
object (YouTubeVideo )
},
"link": {
object (Link )
},
"form": {
object (Form )
},
"gem": {
object (GeminiGem )
},
"notebook": {
object (NotebookLmNotebook )
}
// End of list of possible types for union field material .
} |
字段 |
联合字段 material 。素材内容。material 只能是下列其中一项: |
driveFile |
object (SharedDriveFile )
Google 云端硬盘文件素材资源。
|
youtubeVideo |
object (YouTubeVideo )
YouTube 视频素材。
|
link |
object (Link )
链接素材资源。创建时,如果可能,此值会升级为更合适的类型,并在响应中反映出来。
|
form |
object (Form )
Google 表单素材资源。只读。
|
gem |
object (GeminiGem )
Gemini Gem 素材。只读。
|
notebook |
object (NotebookLmNotebook )
NotebookLM 笔记本材料。只读。
|
ShareMode
可能的分享选项。如果未指定,则默认为 VIEW;其他值只能在类型为 ASSIGNMENT 的课程作业对象中指定。
枚举 |
UNKNOWN_SHARE_MODE |
未指定共享模式。此值不应返回。 |
VIEW |
学生可以查看共享文件。 |
EDIT |
学生可以修改共享文件。 |
STUDENT_COPY |
学生拥有共享文件的个人副本。 |
GeminiGem
JSON 表示法 |
{
"id": string,
"title": string,
"url": string
} |
字段 |
id |
string
Gem 资源 ID。
|
title |
string
Gem 的标题。 只读。
|
url |
string
可用于访问 Gem 的网址。 只读。
|
NotebookLmNotebook
JSON 表示法 |
{
"id": string,
"title": string,
"url": string
} |
字段 |
id |
string
笔记本资源 ID。
|
title |
string
笔记本的标题。 只读。
|
url |
string
可用于访问笔记本的网址。 只读。
|
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-08。
[null,null,["最后更新时间 (UTC):2025-08-08。"],[],[],null,["# Material\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [SharedDriveFile](#SharedDriveFile)\n - [JSON representation](#SharedDriveFile.SCHEMA_REPRESENTATION)\n- [ShareMode](#ShareMode)\n- [GeminiGem](#GeminiGem)\n - [JSON representation](#GeminiGem.SCHEMA_REPRESENTATION)\n- [NotebookLmNotebook](#NotebookLmNotebook)\n - [JSON representation](#NotebookLmNotebook.SCHEMA_REPRESENTATION)\n\nMaterial attached to course work.\n\nWhen creating attachments, setting the `form`, `gem`, or `notebook` field is not supported.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { // Union field `material` can be only one of the following: \"driveFile\": { object (/workspace/classroom/reference/rest/v1/Material#SharedDriveFile) }, \"youtubeVideo\": { object (/workspace/classroom/reference/rest/v1/YouTubeVideo) }, \"link\": { object (/workspace/classroom/reference/rest/v1/Link) }, \"form\": { object (/workspace/classroom/reference/rest/v1/Form) }, \"gem\": { object (/workspace/classroom/reference/rest/v1/Material#GeminiGem) }, \"notebook\": { object (/workspace/classroom/reference/rest/v1/Material#NotebookLmNotebook) } // End of list of possible types for union field `material`. } ``` |\n\n| Fields ||\n|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Union field `material`. Material content. `material` can be only one of the following: ||\n| `driveFile` | `object (`[SharedDriveFile](/workspace/classroom/reference/rest/v1/Material#SharedDriveFile)`)` Google Drive file material. |\n| `youtubeVideo` | `object (`[YouTubeVideo](/workspace/classroom/reference/rest/v1/YouTubeVideo)`)` YouTube video material. |\n| `link` | `object (`[Link](/workspace/classroom/reference/rest/v1/Link)`)` Link material. On creation, this is upgraded to a more appropriate type if possible, and this is reflected in the response. |\n| `form` | `object (`[Form](/workspace/classroom/reference/rest/v1/Form)`)` Google Forms material. Read-only. |\n| `gem` | `object (`[GeminiGem](/workspace/classroom/reference/rest/v1/Material#GeminiGem)`)` Gemini Gem material. Read-only. |\n| `notebook` | `object (`[NotebookLmNotebook](/workspace/classroom/reference/rest/v1/Material#NotebookLmNotebook)`)` NotebookLM Notebook material. Read-only. |\n\nSharedDriveFile\n---------------\n\nDrive file that is used as material for course work.\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"driveFile\": { object (/workspace/classroom/reference/rest/v1/DriveFile) }, \"shareMode\": enum (/workspace/classroom/reference/rest/v1/Material#ShareMode) } ``` |\n\n| Fields ||\n|-------------|--------------------------------------------------------------------------------------------------------------------------------------|\n| `driveFile` | `object (`[DriveFile](/workspace/classroom/reference/rest/v1/DriveFile)`)` Drive file details. |\n| `shareMode` | `enum (`[ShareMode](/workspace/classroom/reference/rest/v1/Material#ShareMode)`)` Mechanism by which students access the Drive item. |\n\nShareMode\n---------\n\nPossible sharing options. Defaults to VIEW if left unspecified, and other values may only be specified within a course work object of type ASSIGNMENT.\n\n| Enums ||\n|----------------------|-----------------------------------------------------------|\n| `UNKNOWN_SHARE_MODE` | No sharing mode specified. This should never be returned. |\n| `VIEW` | Students can view the shared file. |\n| `EDIT` | Students can edit the shared file. |\n| `STUDENT_COPY` | Students have a personal copy of the shared file. |\n\nGeminiGem\n---------\n\nGemini Gem link.\n\n| JSON representation |\n|----------------------------------------------------------|\n| ``` { \"id\": string, \"title\": string, \"url\": string } ``` |\n\n| Fields ||\n|---------|-------------------------------------------------------------|\n| `id` | `string` Gems resource id. |\n| `title` | `string` Title of the Gem. Read-only. |\n| `url` | `string` URL that can be used to access the Gem. Read-only. |\n\nNotebookLmNotebook\n------------------\n\nNotebookLM Notebook link.\n\n| JSON representation |\n|----------------------------------------------------------|\n| ``` { \"id\": string, \"title\": string, \"url\": string } ``` |\n\n| Fields ||\n|---------|------------------------------------------------------------------|\n| `id` | `string` Notebook resource id. |\n| `title` | `string` Title of the Notebook. Read-only. |\n| `url` | `string` URL that can be used to access the Notebook. Read-only. |"]]