傳回已驗證使用者的所有使用者設定。立即試用。
要求
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,對即時資料呼叫這個方法,並查看回應。