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

CalendarList

ユーザーのカレンダーリスト内のカレンダーのコレクション。 Calendars と CalendarList.

このリソースのメソッドの一覧は、このページの最後に掲載されています。

リソースの表記

{
  "kind": "calendar#calendarListEntry",
  "etag": etag,
  "id": string,
  "summary": string,
  "description": string,
  "location": string,
  "timeZone": string,
  "summaryOverride": string,
  "colorId": string,
  "backgroundColor": string,
  "foregroundColor": string,
  "hidden": boolean,
  "selected": boolean,
  "accessRole": string,
  "defaultReminders": [
    {
      "method": string,
      "minutes": integer
    }
  ],
  "notificationSettings": {
    "notifications": [
      {
        "type": string,
        "method": string
      }
    ]
  },
  "primary": boolean,
  "deleted": boolean,
  "conferenceProperties": {
    "allowedConferenceSolutionTypes": [
      string
    ]
  }
}

プロパティ名	値	説明	メモ
`accessRole`	`string`	認証されたユーザーがカレンダーに対して持っている有効なアクセスロール。読み取り専用。有効な値は次のとおりです。「`freeBusyReader`」 - 空き時間情報への読み取りアクセス権を付与します。「`reader`」 - カレンダーへの読み取り権限を付与します。非公開の予定は閲覧権限を持つユーザーに表示されますが、予定の詳細は非表示になります。「`writer`」 - カレンダーへの読み取りおよび書き込み権限を付与します。非公開イベントは書き込み権限を持つユーザーに表示され、イベントの詳細が表示されます。「`owner`」 - カレンダーの所有権を提供します。このロールにはライターロールのすべての権限に加え、ACL を表示および操作する権限が含まれています。
`backgroundColor`	`string`	カレンダーのメインの色（16 進数形式「`#0088aa`」）。このプロパティは、インデックスベースの `colorId` プロパティよりも優先されます。このプロパティを設定または変更するには、insert、update、patch の各メソッドのパラメータで `colorRgbFormat=true` を指定する必要があります。省略可。	書き込み可能
`colorId`	`string`	カレンダーの色。これは、色定義の `calendar` セクション内のエントリを参照する ID です（カラーエンドポイントを参照）。このプロパティは `backgroundColor` プロパティと `foregroundColor` プロパティより優先されており、これらのプロパティを使用する場合は無視されます。省略可。	書き込み可能
`conferenceProperties`	`nested object`	このカレンダーの会議プロパティ（許可する会議の種類など）。
`conferenceProperties.allowedConferenceSolutionTypes[]`	`list`	このカレンダーでサポートされている会議ソリューションの種類。可能な値は次のとおりです。 `"eventHangout"` `"eventNamedHangout"` `"hangoutsMeet"` 省略可。
`defaultReminders[]`	`list`	認証されたユーザーがこのカレンダーに設定するデフォルトのリマインダー。	書き込み可能
`defaultReminders[].method`	`string`	このリマインダーで使用されるメソッド。有効な値は次のとおりです。「`email`」 - リマインダーがメールで送信されます。「`popup`」- リマインダーは UI ポップアップを介して送信されます。リマインダーを追加する場合は必須です。	書き込み可能
`defaultReminders[].minutes`	`integer`	リマインダーがトリガーされる、イベント開始前の分数。有効な値は 0 ～ 40320（4 週間分）です。リマインダーを追加する場合は必須です。	書き込み可能
`deleted`	`boolean`	このカレンダーリストのエントリがカレンダーリストから削除されているかどうか。読み取り専用。（省略可）デフォルトは False です。
`description`	`string`	カレンダーの説明。（省略可）読み取り専用です。
`etag`	`etag`	リソースの ETag。
`foregroundColor`	`string`	カレンダーのフォアグラウンドの色を 16 進数形式「`#ffffff`」で表したものです。このプロパティは、インデックスベースの `colorId` プロパティよりも優先されます。このプロパティを設定または変更するには、insert、update、patch の各メソッドのパラメータで `colorRgbFormat=true` を指定する必要があります。省略可。	書き込み可能
`hidden`	`boolean`	カレンダーがリストで非表示になっているかどうか。（省略可）この属性はカレンダーが非表示の場合にのみ返されます。その場合、値は `true` です。	書き込み可能
`id`	`string`	カレンダーの識別子。
`kind`	`string`	リソースのタイプ（「calendar#calendarListEntry」）。
`location`	`string`	自由形式のテキストで表されるカレンダーの地域。（省略可）読み取り専用です。
`notificationSettings`	`object`	認証されたユーザーがこのカレンダーについて受け取る通知。	書き込み可能
`notificationSettings.notifications[]`	`list`	このカレンダーに設定された通知のリスト。
`notificationSettings.notifications[].method`	`string`	通知の配信に使用された方法。可能な値: 「`email`」 - 通知はメールで送信されます。通知を追加する場合は必須です。	書き込み可能
`notificationSettings.notifications[].type`	`string`	通知のタイプ。有効な値は次のとおりです。「`eventCreation`」 - カレンダーに新しい予定が追加されたときに送信される通知。「`eventChange`」 - イベントが変更されたときに送信される通知。「`eventCancellation`」 - イベントがキャンセルされたときに送信される通知。「`eventResponse`」 - 参加者が予定の招待状に返信したときに送信される通知。「`agenda`」 - その日の予定を含む予定リスト（午前中に送信されます）。通知を追加する場合は必須です。	書き込み可能
`primary`	`boolean`	カレンダーが認証済みユーザーのメインカレンダーかどうか。読み取り専用。（省略可）デフォルトは False です。
`selected`	`boolean`	カレンダーのコンテンツをカレンダー UI に表示するかどうかを指定します。（省略可）デフォルトは False です。	書き込み可能
`summary`	`string`	カレンダーのタイトル。読み取り専用です。
`summaryOverride`	`string`	認証されたユーザーがこのカレンダーに設定した概要。省略可。	書き込み可能
`timeZone`	`string`	カレンダーのタイムゾーン。（省略可）読み取り専用です。

Methods

delete: ユーザーのカレンダーリストからカレンダーを削除します。
get: ユーザーのカレンダーリストからカレンダーを返します。
挿入: ユーザーのカレンダーリストに既存のカレンダーを挿入します。
list: ユーザーのカレンダーリストのカレンダーを返します。
パッチ: ユーザーのカレンダーリストにある既存のカレンダーを更新します。このメソッドは、パッチセマンティクスをサポートしています。各パッチリクエストは 3 つの割り当てユニットを消費します。get の後に update を続けることをおすすめします。指定したフィールド値によって既存の値が置き換えられます。リクエストで指定しないフィールドは変更されません。配列フィールドを指定すると、既存の配列が上書きされます。以前の配列要素は破棄されます。
update: ユーザーのカレンダーリストにある既存のカレンダーを更新します。
スマートウォッチ: CalendarList リソースの変更を監視します。