命名空间：microsoft.graph
表示用户 “备注” 文件夹中的简单便笺。 备注支持带有可选内联图像附件的文本内容，适用于快速捕获场景。
继承自 outlookItem。
方法
| 方法 | 返回类型 | Description |
|---|---|---|
| List | 笔记 集合 | 获取用户“备注”文件夹中备注对象的列表。 |
| 创建 | 注释 | 在用户的笔记文件夹中创建新笔记。 |
| Get | 注释 | 读取 注释 对象的属性和关系。 |
| 更新 | 注释 | 更新 注释 对象的属性。 |
| 删除 | 无 | 删除 注释 对象。 |
| 获取增量 | 笔记 集合 | 获取自上次增量查询以来在用户的 Notes 文件夹中添加、更新或删除的一组注释对象。 |
| 列出附件 | attachment 集合 | 获取与 笔记关联的文件附件列表。 |
| 创建附件 | attachment | 创建 fileAttachment 对象，该对象将内联图像附件添加到 备注。 |
| 删除附件 | 无 | 从 笔记中删除内联图像附件。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| body | itemBody | 备注的内容。 支持 text 或 html 内容类型。 |
| bodyPreview | String | 自动生成的注释正文内容预览 (前 ~255 个字符，纯文本) 。 只读。 |
| 类别 | String collection | 与注释关联的类别。 继承自 outlookItem。 |
| changeKey | String | 用于通过标头进行 If-Match 乐观并发控制的版本标识符。 只读。 继承自 outlookItem。 |
| createdDateTime | DateTimeOffset | 创建笔记的日期和时间。 时间戳类型使用 ISO 8601 格式表示日期和时间信息，并且始终采用 UTC 格式。 例如，2024 年 1 月 1 日的午夜 UTC 时间为 2024-01-01T00:00:00Z。 支持 $filter（eq、ne、ge、le、gt、lt）。 只读。 继承自 outlookItem。 |
| hasAttachments | Boolean | 指示便笺是否有文件附件。 支持 $filter（eq）。 只读。 |
| id | String | 注释的唯一标识符。 只读。 继承自 outlookItem。 |
| isDeleted | 布尔值 | 指示是否软删除了便笺。 只读。 |
| lastModifiedDateTime | DateTimeOffset | 上次修改备注的日期和时间。 时间戳类型使用 ISO 8601 格式表示日期和时间信息，并且始终采用 UTC 格式。 例如，2024 年 1 月 1 日的午夜 UTC 时间为 2024-01-01T00:00:00Z。 支持 $filter（eq、ne、ge、le、gt、lt）和 $orderby。 只读。 继承自 outlookItem。 |
| subject | String | 备注的标题。 支持 $filter (eq、 、 ne) startsWith 和 $orderby. |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| attachments | 附件集合 | 便笺的文件附件。 仅支持图像/png、图像/jpeg、图像/gif 或图像/bmp) (内联图像附件，每个附件的最大大小为 3 MB。 用于 $expand 检索附件。 |
| extensions | 扩展集合 | 为备注定义的开放扩展集合。 |
| multiValueExtendedProperties | multiValueLegacyExtendedProperty 集合 | 为注解定义的多值扩展属性的集合。 |
| singleValueExtendedProperties | singleValueLegacyExtendedProperty collection | 为注解定义的单值扩展属性的集合。 |
JSON 表示形式
以下 JSON 表示形式显示资源类型。
{
"@odata.type": "#microsoft.graph.note",
"id": "String (identifier)",
"createdDateTime": "String (timestamp)",
"lastModifiedDateTime": "String (timestamp)",
"changeKey": "String",
"categories": [
"String"
],
"subject": "String",
"body": {
"@odata.type": "microsoft.graph.itemBody"
},
"bodyPreview": "String",
"isDeleted": "Boolean",
"hasAttachments": "Boolean"
}