Settings: list

Trả về tất cả chế độ cài đặt người dùng cho người dùng đã xác thực. Thử ngay.

Yêu cầu

Yêu cầu HTTP

GET https://www.googleapis.com/calendar/v3/users/me/settings

Thông số

Tên thông số Giá trị Mô tả
Tham số truy vấn không bắt buộc
maxResults integer Số mục tối đa được trả về trên một trang kết quả. Theo mặc định, giá trị này là 100 mục. Kích thước trang không được lớn hơn 250 mục. Không bắt buộc.
pageToken string Mã thông báo chỉ định trang kết quả cần trả về. Không bắt buộc.
syncToken string Mã thông báo lấy từ trường nextSyncToken được trả về trên trang kết quả cuối cùng của yêu cầu danh sách trước đó. Tham số này giúp kết quả của yêu cầu danh sách này chỉ chứa những mục đã thay đổi kể từ thời điểm đó.
Nếu syncToken hết hạn, máy chủ sẽ phản hồi bằng mã phản hồi 410 GONE và ứng dụng khách sẽ xoá bộ nhớ của mình và thực hiện đồng bộ hoá đầy đủ mà không có syncToken.
Tìm hiểu thêm về tính năng đồng bộ hoá gia tăng.
Không bắt buộc. Chế độ mặc định là trả về tất cả các mục.

Ủy quyền

Yêu cầu này cần được uỷ quyền với ít nhất một trong các phạm vi sau:

Phạm vi
https://www.googleapis.com/auth/calendar.readonly
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.settings.readonly
https://www.googleapis.com/auth/calendar.settings

Để biết thêm thông tin, hãy xem trang xác thực và uỷ quyền.

Nội dung yêu cầu

Đừng cung cấp nội dung yêu cầu bằng phương thức này.

Phản hồi

Nếu thành công, phương thức này sẽ trả về nội dung phản hồi có cấu trúc như sau:

{
  "kind": "calendar#settings",
  "etag": etag,
  "nextPageToken": string,
  "nextSyncToken": string,
  "items": [
    settings Resource
  ]
}
Tên tài sản Giá trị Mô tả Ghi chú
kind string Loại bộ sưu tập ("calendar#settings").
etag etag Etag của bộ sưu tập.
items[] list Danh sách chế độ cài đặt người dùng.
nextPageToken string Mã thông báo dùng để truy cập vào trang tiếp theo của kết quả này. Bị bỏ qua nếu không có thêm kết quả, trong trường hợp đó, nextSyncToken sẽ được cung cấp.
nextSyncToken string Mã thông báo được dùng vào thời điểm sau đó để chỉ truy xuất các mục đã thay đổi kể từ khi kết quả này được trả về. Bị bỏ qua nếu có thêm kết quả, trong trường hợp đó, nextPageToken sẽ được cung cấp.

Hãy dùng thử!

Sử dụng APIs Explorer bên dưới để gọi phương thức này trên dữ liệu trực tiếp và xem phản hồi.