このページは Cloud Translation API によって翻訳されました。

CalendarList: list

ユーザーのカレンダーリストにあるカレンダーを返します。実習をご覧ください。

リクエスト

HTTP リクエスト

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

パラメータ

パラメータ名	値	説明
省略可能なクエリパラメータ
`maxResults`	`integer`	1 つの結果ページで返されるエントリの最大数。デフォルトでは、値は 100 エントリです。ページサイズは 250 エントリを超えることはできません。省略可能。
`minAccessRole`	`string`	返されたエントリ内のユーザーの最小アクセスロール。省略可。デフォルトは制限なしです。有効な値は次のとおりです。「`freeBusyReader`」: ユーザーは空き時間情報を読み取ることができます。「`owner`」: イベントとアクセス制御リストの読み取りと変更が可能です。「`reader`」: ユーザーは非公開以外のイベントを読み取ることができます。「`writer`」: ユーザーはイベントの読み取りと変更を行うことができます。
`pageToken`	`string`	返される結果ページを指定するトークン。省略可能。
`showDeleted`	`boolean`	削除されたカレンダーリストのエントリを結果に含めるかどうか。省略可。デフォルトは False です。
`showHidden`	`boolean`	非表示のエントリを表示するかどうか。省略可。デフォルトは False です。
`syncToken`	`string`	前のリストリクエストの結果の最後のページで返された `nextSyncToken` フィールドから取得したトークン。これにより、このリストリクエストの結果には、それ以降に変更されたエントリのみが含まれます。カレンダーのプロパティや ACL などの読み取り専用フィールドのみが変更された場合、エントリは返されません。前回のリストリクエスト以降に削除または非表示になったエントリは、常に結果セットに含まれます。`showDeleted` と `showHidden` のどちらも False に設定することはできません。クライアント状態の整合性を確保するため、`minAccessRole` クエリパラメータを `nextSyncToken` と同時に指定することはできません。 `syncToken` が期限切れになると、サーバーは 410 GONE レスポンスコードで応答します。クライアントはストレージを消去し、`syncToken` なしで完全同期を実行する必要があります。増分同期の詳細省略可。デフォルトでは、すべてのエントリが返されます。

承認

このリクエストは、少なくとも次のうち 1 つのスコープによる承認が必要です。

範囲
`https://www.googleapis.com/auth/calendar.readonly`
`https://www.googleapis.com/auth/calendar`
`https://www.googleapis.com/auth/calendar.calendarlist`
`https://www.googleapis.com/auth/calendar.calendarlist.readonly`

詳しくは、認証と認可のページをご覧ください。

リクエストの本文

このメソッドをリクエストの本文に含めないでください。

レスポンス

成功すると、このメソッドは次の構造を含むレスポンスの本文を返します。

{
  "kind": "calendar#calendarList",
  "etag": etag,
  "nextPageToken": string,
  "nextSyncToken": string,
  "items": [
    calendarList Resource
  ]
}

プロパティ名	値	説明
`kind`	`string`	コレクションのタイプ（「`calendar#calendarList`」）。
`etag`	`etag`	コレクションの ETag。
`nextPageToken`	`string`	この結果の次のページにアクセスするために使用されるトークン。検索結果がこれ以上ない場合は省略されます。その場合は `nextSyncToken` が指定されます。
`items[]`	`list`	ユーザーのカレンダーリストに表示されているカレンダー。
`nextSyncToken`	`string`	この結果が返されてから変更されたエントリのみを取得するために、後で使用されるトークン。追加の結果が利用可能な場合は省略されます。その場合は `nextPageToken` が指定されます。

試してみよう:

以下の API Explorer を使用して、ライブデータに対してこのメソッドを呼び出し、レスポンスを確認します。