Method: notes.list

Liệt kê ghi chú.

Mỗi lệnh gọi danh sách sẽ trả về một trang kết quả với pageSize là giới hạn trên của các mục được trả về. pageSize bằng 0 cho phép máy chủ chọn giới hạn trên.

ListNotesResponse chứa tối đa pageSize mục nhập. Nếu còn nhiều nội dung cần liệt kê, thì hàm này sẽ cung cấp giá trị nextPageToken. (Mã thông báo trang là các giá trị mờ.)

Để nhận trang kết quả tiếp theo, hãy sao chép nextPageToken của kết quả vào pageToken của yêu cầu tiếp theo. Lặp lại cho đến khi nextPageToken trả về một trang kết quả trống.

notes.list trả về kết quả nhất quán khi gặp các thay đổi đồng thời hoặc báo hiệu rằng không thể trả về kết quả với lỗi ABORTED.

Yêu cầu HTTP

GET https://keep.googleapis.com/v1/notes

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số truy vấn

Thông số
pageSize

integer

Số kết quả tối đa cần trả về.

pageToken

string

Trường nextPageToken của trang trước.

filter

string

Lọc kết quả danh sách. Nếu bạn không cung cấp bộ lọc nào, thì bộ lọc trashed sẽ được áp dụng theo mặc định. Các trường hợp lệ để lọc là: createTime, updateTime, trashTimetrashed.

Cú pháp bộ lọc tuân theo thông số kỹ thuật lọc AIP của Google.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Phản hồi khi liệt kê một trang ghi chú.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON
{
  "notes": [
    {
      object (Note)
    }
  ],
  "nextPageToken": string
}
Trường
notes[]

object (Note)

Một trang ghi chú.

nextPageToken

string

Trường pageToken của trang tiếp theo.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

  • https://www.googleapis.com/auth/keep
  • https://www.googleapis.com/auth/keep.readonly

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.