REST Resource: notes

資源：Note

單一記事。

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 中的 ID 一般注意事項。
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)

如果這個部分的內容為清單，即可使用這個選項。

文字內容

單一文字部分或清單項目的文字區塊。

JSON 表示法 
{
  "text": string
}
欄位
text

string

記事的文字。這個限制會因使用這種類型的特定欄位而異。

清單內容

單一清單附註的項目清單。

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

 列出附註。