Settings: list

傳回已驗證使用者的所有使用者設定。立即試用。

要求

HTTP 要求

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

參數

參數名稱 值 說明
選用查詢參數
maxResults integer 單一結果頁面傳回的項目數量上限。預設值為 100 個項目。頁面大小不得超過 250 個項目。選用。
pageToken string 指定要傳回哪個結果頁面的權杖。選用。
syncToken string 從先前清單要求最後一頁結果傳回的 nextSyncToken 欄位取得的權杖。這項清單要求只會傳回自該時間點後變更的項目。
如果 syncToken 過期,伺服器會傳回 410 GONE 回應代碼,用戶端應清除儲存空間,並在不使用任何 syncToken 的情況下執行完整同步處理。
進一步瞭解增量同步處理。
選用。預設會傳回所有項目。

授權

這項要求必須至少具備下列其中一個範圍的授權:

範圍
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

詳情請參閱驗證與授權頁面。

要求主體

請勿透過這個方法提供要求主體。

回應

如果成功的話,這個方法會傳回回應內文,其結構如下:

{
  "kind": "calendar#settings",
  "etag": etag,
  "nextPageToken": string,
  "nextSyncToken": string,
  "items": [
    settings Resource
  ]
}
屬性名稱 值 說明 附註
kind string 集合類型 (「calendar#settings」)。
etag etag 集合的 Etag。
items[] list 使用者設定清單。
nextPageToken string 用於存取這項結果下一頁的權杖。如果沒有其他結果,則會省略,並提供 nextSyncToken。
nextSyncToken string 這個權杖可用於日後擷取自傳回這項結果以來,有變更的項目。如果還有其他結果,則會省略這個屬性,並提供 nextPageToken。

試試看!

使用下方的 APIs Explorer,對即時資料呼叫這個方法,並查看回應。