REST Resource: notes

资源：备注

一条记事。

JSON 表示法 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "trashTime": string,
  "trashed": boolean,
  "attachments": [
    {
      object (Attachment)
    }
  ],
  "permissions": [
    {
      object (Permission)
    }
  ],
  "title": string,
  "body": {
    object (Section)
  }
}
字段
name

string

仅限输出。此备注的资源名称。请参阅有关 KeepService 中标识符的一般说明。
createTime

string (Timestamp format)

仅限输出。此备注的创建时间。
updateTime

string (Timestamp format)

仅限输出。此备注的上次修改时间。
trashTime

string (Timestamp format)

仅限输出。将此记事移到回收站的时间。如果值为 trashed，则备注最终将被删除。如果记事未移至回收站，则表示此字段未设置（且已移入回收站的字段为 false）。
trashed

boolean

仅限输出。true（如果此记事已移入回收站）。移至回收站后，该记事最终将被删除。
attachments[]

object (Attachment)

仅限输出。附加到此备注的附件。
permissions[]

object (Permission)

仅限输出。针对记事设置的权限列表。至少包含一个备注所有者条目。
title

string

备注的标题。长度必须少于 1,000 个字符。
body

object (Section)

备注的正文。

附件

备注的附件。

JSON 表示法 
{
  "name": string,
  "mimeType": [
    string
  ]
}
字段
name

string

资源名称；
mimeType[]

string

附件可用的 MIME 类型（IANA 媒体类型）。

权限

针对备注的单一权限。将 member 与 role 相关联。

JSON 表示法 
{
  "name": string,
  "role": enum (Role),
  "email": string,
  "deleted": boolean,

  // Union field member can be only one of the following:
  "user": {
    object (User)
  },
  "group": {
    object (Group)
  },
  "family": {
    object (Family)
  }
  // End of list of possible types for union field member.
}
字段
name

string

仅限输出。资源名称。
role

enum (Role)

此权限授予的角色。该角色决定了实体读取、写入和共享备注的能力。
email

string

与成员关联的电子邮件地址。如果在创建时设置，User 或 Group 消息中的 email 字段必须为空或与此字段匹配。读取时，如果成员没有关联的电子邮件地址，则此设置可以取消。
deleted

boolean

仅限输出。此成员是否已被删除。如果成员已恢复，则此值会设为 false，且已恢复成员将保留记事中的角色。
联合字段 member。指定被授予该角色的身份。如果成员已被删除，则系统不会取消该成员。member 只能是下列其中一项：
user

object (User)

仅限输出。此角色适用的用户。
group

object (Group)

仅限输出。此角色适用的群组。
family

object (Family)

仅限输出。此角色适用的 Google 家人群组。

角色

定义实体可以具有的各种角色。

枚举
ROLE_UNSPECIFIED 未定义的角色。
OWNER 可授予完整访问权限的角色。无法添加或移除此角色。由备注的创建者定义。
WRITER 授予提供内容和修改备注权限的角色。

用户

描述单个用户。

JSON 表示法 
{
  "email": string
}
字段
email

string

用户的电子邮件地址。

群组

描述单个群组。

JSON 表示法 
{
  "email": string
}
字段
email

string

群组电子邮件地址。

家庭

此类型没有字段。

描述单个 Google 家人群组。

部分

备注的内容。

JSON 表示法 
{

  // Union field Content can be only one of the following:
  "text": {
    object (TextContent)
  },
  "list": {
    object (ListContent)
  }
  // End of list of possible types for union field Content.
}
字段
联合字段 Content。此部分的内容必须是以下值类型之一。Content 只能是下列其中一项：
text

object (TextContent)

如果此部分的内容是一段文本，使用此属性。文本内容的长度必须小于 20,000 个字符。
list

object (ListContent)

如果此部分的内容是列表，则使用此属性。

TextContent

单个文本部分或列表项的文本块。

JSON 表示法 
{
  "text": string
}
字段
text

string

备注的文本。此字段的限制因使用此类型的特定字段而异。

ListContent

单个清单记事的项目列表。

JSON 表示法 
{
  "listItems": [
    {
      object (ListItem)
    }
  ]
}
字段
listItems[]

object (ListItem)

列表中的项。项目数量必须小于 1,000。

ListItem

记事列表中的单个列表项。

JSON 表示法 
{
  "childListItems": [
    {
      object (ListItem)
    }
  ],
  "text": {
    object (TextContent)
  },
  "checked": boolean
}
字段
childListItems[]

object (ListItem)

如果设置，则为嵌套在此列表项下的列表项列表。只允许嵌套一级。
text

object (TextContent)

此项目的文本。长度必须少于 1,000 个字符。
checked

boolean

此商品是否已结账。

方法

create

 创建新记事。

delete

 删除记事。

get

 获取备注。

list

 列出记事。