Calendar API にはさまざまな種類の予定リソースが用意されています。詳細については、予定についてをご覧ください。
このリソースのメソッドの一覧は、このページの最後に掲載されています。
リソース表現
{ "kind": "calendar#event", "etag": etag, "id": string, "status": string, "htmlLink": string, "created": datetime, "updated": datetime, "summary": string, "description": string, "location": string, "colorId": string, "creator": { "id": string, "email": string, "displayName": string, "self": boolean }, "organizer": { "id": string, "email": string, "displayName": string, "self": boolean }, "start": { "date": date, "dateTime": datetime, "timeZone": string }, "end": { "date": date, "dateTime": datetime, "timeZone": string }, "endTimeUnspecified": boolean, "recurrence": [ string ], "recurringEventId": string, "originalStartTime": { "date": date, "dateTime": datetime, "timeZone": string }, "transparency": string, "visibility": string, "iCalUID": string, "sequence": integer, "attendees": [ { "id": string, "email": string, "displayName": string, "organizer": boolean, "self": boolean, "resource": boolean, "optional": boolean, "responseStatus": string, "comment": string, "additionalGuests": integer } ], "attendeesOmitted": boolean, "extendedProperties": { "private": { (key): string }, "shared": { (key): string } }, "hangoutLink": string, "conferenceData": { "createRequest": { "requestId": string, "conferenceSolutionKey": { "type": string }, "status": { "statusCode": string } }, "entryPoints": [ { "entryPointType": string, "uri": string, "label": string, "pin": string, "accessCode": string, "meetingCode": string, "passcode": string, "password": string } ], "conferenceSolution": { "key": { "type": string }, "name": string, "iconUri": string }, "conferenceId": string, "signature": string, "notes": string, }, "gadget": { "type": string, "title": string, "link": string, "iconLink": string, "width": integer, "height": integer, "display": string, "preferences": { (key): string } }, "anyoneCanAddSelf": boolean, "guestsCanInviteOthers": boolean, "guestsCanModify": boolean, "guestsCanSeeOtherGuests": boolean, "privateCopy": boolean, "locked": boolean, "reminders": { "useDefault": boolean, "overrides": [ { "method": string, "minutes": integer } ] }, "source": { "url": string, "title": string }, "workingLocationProperties": { "type": string, "homeOffice": (value), "customLocation": { "label": string }, "officeLocation": { "buildingId": string, "floorId": string, "floorSectionId": string, "deskId": string, "label": string } }, "outOfOfficeProperties": { "autoDeclineMode": string, "declineMessage": string }, "focusTimeProperties": { "autoDeclineMode": string, "declineMessage": string, "chatStatus": string }, "attachments": [ { "fileUrl": string, "title": string, "mimeType": string, "iconLink": string, "fileId": string } ], "eventType": string }
プロパティ名 | 値 | 説明 | メモ |
---|---|---|---|
anyoneCanAddSelf |
boolean |
誰でも自身をイベントに招待できるかどうか(非推奨)。省略可。デフォルトは False です。 | 書き込み可能 |
attachments[] |
list |
予定の添付ファイル。 添付ファイルを変更するには、 各予定にアップロードできる添付ファイルは 25 個までです |
|
attachments[].fileId |
string |
添付ファイルの ID。読み取り専用。 Google ドライブのファイルの場合は、Drive API の対応する |
|
attachments[].fileUrl |
string |
添付ファイルへの URL リンク。 Google ドライブのファイルの添付ファイルを追加する場合は、Drive API の 添付ファイルを追加する場合は必須です。 |
書き込み可能 |
attachments[].iconLink |
string |
添付ファイルのアイコンへの URL リンク。この項目を変更できるのは、カスタムの第三者添付ファイルのみです。 | |
attachments[].mimeType |
string |
添付ファイルのインターネット メディアタイプ(MIME タイプ)。 | |
attachments[].title |
string |
添付ファイルのタイトル。 | |
attendeesOmitted |
boolean |
参加者が予定の表現から省略されているかどうかを示します。イベントの取得時に、maxAttendee クエリ パラメータで指定された制限が原因である可能性があります。予定を更新するときは、参加者の返答の更新にのみ使用できます。省略可。デフォルトは False です。 |
書き込み可能 |
attendees[] |
list |
イベントの参加者。他のカレンダー ユーザーとの予定のスケジュールを設定する方法について詳しくは、参加者との予定に関するガイドをご覧ください。参加者リストを追加するには、サービス アカウントがドメイン全体の権限の委任を使用する必要があります。 | 書き込み可能 |
attendees[].additionalGuests |
integer |
追加ゲストの人数。省略可。デフォルト値は 0 です。 | 書き込み可能 |
attendees[].comment |
string |
参加者の回答のコメント。省略可。 | 書き込み可能 |
attendees[].displayName |
string |
参加者の名前(利用可能な場合)。省略可。 | 書き込み可能 |
attendees[].email |
string |
参加者のメールアドレス(利用可能な場合)。このフィールドは、参加者を追加するときに必要です。RFC5322 に基づく有効なメールアドレスである必要があります。 参加者を追加するときには必須です。 |
書き込み可能 |
attendees[].id |
string |
参加者のプロフィール ID(利用可能な場合)。 | |
attendees[].optional |
boolean |
これが任意出席のかどうか。省略可。デフォルトは False です。 | 書き込み可能 |
attendees[].organizer |
boolean |
出席者が予定の主催者かどうか読み取り専用。デフォルトは False です。 | |
attendees[].resource |
boolean |
参加者がリソースであるかどうか。参加者をその予定に初めて追加するときにのみ設定できます。その後の変更は無視されます。省略可。デフォルトは False です。 | 書き込み可能 |
attendees[].responseStatus |
string |
参加者の回答ステータス。有効な値は次のとおりです。
|
書き込み可能 |
attendees[].self |
boolean |
このエントリが、この予定のコピーが表示されるカレンダーであるかどうかを指定します。読み取り専用。デフォルトは False です。 | |
colorId |
string |
予定の色。これは、色の定義の event セクションのエントリを参照する ID です( 色のエンドポイントを参照)。省略可。 |
書き込み可能 |
conferenceData |
nested object |
Google Meet 会議の詳細など、会議関連情報。新しい会議の詳細を作成するには、createRequest フィールドを使用します。変更を維持するには、すべてのイベント変更リクエストで conferenceDataVersion リクエスト パラメータを 1 に設定してください。 |
書き込み可能 |
conferenceData.conferenceId |
string |
会議の ID。 デベロッパーが会議を追跡するために使用できますが、ユーザーには表示しないでください。 ID 値の形式は、会議ソリューションのタイプごとに異なります。
|
|
conferenceData.conferenceSolution |
nested object |
Google Meet などの会議ソリューション。 作成リクエストに失敗した会議に対して設定が解除されました。
|
|
conferenceData.conferenceSolution.iconUri |
string |
このソリューションのユーザーに表示されるアイコン。 | |
conferenceData.conferenceSolution.key |
nested object |
このイベントの会議ソリューションを一意に識別できるキー。 | |
conferenceData.conferenceSolution.key.type |
string |
会議ソリューションのタイプ。 クライアントで見慣れないタイプや空のタイプが返されても、エントリ ポイントを表示できるようにする必要があります。ただし、変更は許可されません。 可能な値は次のとおりです。
|
|
conferenceData.conferenceSolution.name |
string |
このソリューションのユーザーに表示される名前。ローカライズされていません。 | |
conferenceData.createRequest |
nested object |
新しい会議を生成して予定に添付するためのリクエスト。データは非同期で生成されます。データが存在するかどうかを確認するには、status フィールドを確認します。
|
|
conferenceData.createRequest.conferenceSolutionKey |
nested object |
ハングアウトや Google Meet などの会議ソリューション。 | |
conferenceData.createRequest.conferenceSolutionKey.type |
string |
会議ソリューションのタイプ。 クライアントで見慣れないタイプや空のタイプが返されても、エントリ ポイントを表示できるようにする必要があります。ただし、変更は許可されません。 可能な値は次のとおりです。
|
|
conferenceData.createRequest.requestId |
string |
クライアントが生成した、このリクエストの一意の ID。 クライアントは、新しいリクエストごとにこの ID を再生成する必要があります。指定された ID が前のリクエストと同じ場合、リクエストは無視されます。 |
|
conferenceData.createRequest.status |
nested object |
会議作成リクエストのステータス。 | |
conferenceData.createRequest.status.statusCode |
string |
会議作成リクエストの現在のステータス。読み取り専用。 可能な値は次のとおりです。
|
|
conferenceData.entryPoints[] |
list |
個々の会議のエントリ ポイントに関する情報(URL や電話番号など)。 これらはすべて同じ会議に属している必要があります。
|
|
conferenceData.entryPoints[].accessCode |
string |
会議にアクセスするためのアクセスコード。最大長は 128 文字です。 新しい会議データを作成するときは、会議プロバイダが使用する用語と一致する { 省略可。 |
|
conferenceData.entryPoints[].entryPointType |
string |
会議のエントリ ポイントのタイプ。 有効な値は次のとおりです:
|
|
conferenceData.entryPoints[].label |
string |
URI のラベル。エンドユーザーに表示されます。ローカライズされていません。最大長は 512 文字です。 例:
省略可。 |
|
conferenceData.entryPoints[].meetingCode |
string |
会議にアクセスするための会議コード。最大長は 128 文字です。 新しい会議データを作成するときは、会議プロバイダが使用する用語と一致する { 省略可。 |
|
conferenceData.entryPoints[].passcode |
string |
会議にアクセスするためのパスコード。最大長は 128 文字です。 新しい会議データを作成するときは、会議プロバイダが使用する用語と一致する { |
|
conferenceData.entryPoints[].password |
string |
会議にアクセスするためのパスワード。最大長は 128 文字です。 新しい会議データを作成するときは、会議プロバイダが使用する用語と一致する { 省略可。 |
|
conferenceData.entryPoints[].pin |
string |
会議にアクセスするための PIN。最大長は 128 文字です。 新しい会議データを作成するときは、会議プロバイダが使用する用語と一致する { 省略可。 |
|
conferenceData.entryPoints[].uri |
string |
エントリ ポイントの URI。最大長は 1,300 文字です。 形式:
|
|
conferenceData.notes |
string |
ユーザーに表示する追加のメモ(ドメイン管理者からの指示、法的通知など)。HTML を含めることができます。最大長は 2,048 文字です。省略可。 | |
conferenceData.signature |
string |
会議データの署名。 サーバーサイドで生成される。 作成リクエストに失敗した会議に対して設定が解除されました。 作成リクエストが保留中の会議の場合は省略可。 |
|
created |
datetime |
イベントの作成時刻(RFC3339 タイムスタンプ形式)。読み取り専用です。 | |
creator |
object |
イベントの作成者。読み取り専用です。 | |
creator.displayName |
string |
作成者の名前(利用可能な場合)。 | |
creator.email |
string |
作成者のメールアドレス(利用可能な場合)。 | |
creator.id |
string |
作成者のプロフィール ID(利用可能な場合)。 | |
creator.self |
boolean |
作成者が、この予定のコピーが表示されるカレンダーに対応しているかどうか。読み取り専用。デフォルトは False です。 | |
description |
string |
イベントの説明。HTML を含めることができます。省略可。 | 書き込み可能 |
end |
nested object |
イベントの(その時間を含まない)終了時間。定期的な予定の場合、これは最初の回の終了時間です。 | |
end.date |
date |
終日イベントの場合は、「yyyy-mm-dd」形式の日付。 | 書き込み可能 |
end.dateTime |
datetime |
結合された日時の値で表される時刻(RFC3339 の形式)。timeZone でタイムゾーンが明示的に指定されていない限り、タイムゾーン オフセットが必要です。 |
書き込み可能 |
end.timeZone |
string |
時刻が指定されているタイムゾーン。(形式は「Europe/Zurich」などの IANA タイムゾーン データベース名になります)。定期的な予定の場合、このフィールドは必須です。展開されるタイムゾーンのタイムゾーンを指定します。単一のイベントの場合、このフィールドは省略可能で、イベントの開始と終了のカスタム タイムゾーンを示します。 | 書き込み可能 |
endTimeUnspecified |
boolean |
終了時間が実際に指定されていないかどうか。この属性が True に設定されている場合でも、互換性の理由から終了時刻は提供されます。デフォルトは False です。 | |
etag |
etag |
リソースの ETag。 | |
eventType |
string |
イベントの特定のタイプ。イベントの作成後にこれを変更することはできません。有効な値は次のとおりです。
|
書き込み可能 |
extendedProperties |
object |
イベントの拡張プロパティ。 | |
extendedProperties.private |
object |
このカレンダーに表示される予定のコピーのみに適用されるプロパティ。 | 書き込み可能 |
extendedProperties.private.(key) |
string |
プライベート プロパティの名前と対応する値。 | |
extendedProperties.shared |
object |
他の参加者の予定のコピー間で共有されるプロパティできます。 | 書き込み可能 |
extendedProperties.shared.(key) |
string |
共有プロパティの名前と対応する値。 | |
focusTimeProperties |
nested object |
サイレント モードのイベントデータ。eventType が focusTime の場合に使用されます。 |
書き込み可能 |
focusTimeProperties.autoDeclineMode |
string |
サイレント モードの予定と重複する会議の招待状を辞退するかどうか。有効な値は declineNone です。これは、会議の招待状が拒否されないことを表します。declineAllConflictingInvitations : この予定と競合する会議への招待はすべて拒否されます。および declineOnlyNewConflictingInvitations です。これにより、サイレント モードの予定がある間に届いた、競合する新しい会議への招待のみが辞退されます。 |
|
focusTimeProperties.chatStatus |
string |
Chat と関連プロダクトでユーザーをマークするステータス。値は available または doNotDisturb です。 |
|
focusTimeProperties.declineMessage |
string |
既存の予定または新しい招待状がカレンダーによって自動的に辞退された場合に設定するレスポンス メッセージ。 | |
gadget |
object |
このイベントを拡張するガジェット。ガジェットのサポートは終了しています。この構造体は、誕生日カレンダーのメタデータを返す場合にのみ使用されます。 | |
gadget.display |
string |
ガジェットの表示モード。非推奨です。有効な値は次のとおりです。
|
書き込み可能 |
gadget.height |
integer |
ガジェットの高さ(ピクセル単位)。高さには 0 より大きい整数を指定してください。省略可。サポート終了。 | 書き込み可能 |
gadget.iconLink |
string |
ガジェットのアイコンの URL です。URL スキームは HTTPS にする必要があります。サポート終了。 | 書き込み可能 |
gadget.link |
string |
ガジェットの URL。URL スキームは HTTPS にする必要があります。サポート終了。 | 書き込み可能 |
gadget.preferences |
object |
設定] をクリックします。 | 書き込み可能 |
gadget.preferences.(key) |
string |
設定名と対応する値。 | |
gadget.title |
string |
ガジェットのタイトル。サポート終了。 | 書き込み可能 |
gadget.type |
string |
ガジェットのタイプ。サポート終了。 | 書き込み可能 |
gadget.width |
integer |
ガジェットの幅(ピクセル単位)。幅には 0 より大きい整数を指定してください。省略可。サポート終了。 | 書き込み可能 |
guestsCanInviteOthers |
boolean |
主催者以外の参加者が他のユーザーを招待できるかどうか。省略可。デフォルトは True です。 | 書き込み可能 |
guestsCanModify |
boolean |
主催者以外の参加者が予定を変更できるかどうか。省略可。デフォルトは False です。 | 書き込み可能 |
guestsCanSeeOtherGuests |
boolean |
主催者以外の参加者が予定の参加者を確認できるかどうかを指定します。省略可。デフォルトは True です。 | 書き込み可能 |
hangoutLink |
string |
このイベントに関連付けられた Google ハングアウトへの絶対リンク。読み取り専用です。 | |
htmlLink |
string |
Google カレンダー ウェブ UI のこの予定への絶対リンク。読み取り専用です。 | |
iCalUID |
string |
RFC5545 で定義されているイベントの一意の識別子。カレンダー システム間でイベントを一意に識別するために使用され、import メソッドでイベントをインポートするときに指定する必要があります。
|
|
id |
string |
イベントの不透明な識別子。1 回限りの予定または定期的な予定を新たに作成するときに、ID を指定できます。指定する ID は、次のルールに従う必要があります。
ID を指定しない場合、ID はサーバーによって自動的に生成されます。
|
書き込み可能 |
kind |
string |
リソースのタイプ(「calendar#event 」)。 |
|
location |
string |
予定の場所(自由形式のテキスト)。省略可。 | 書き込み可能 |
locked |
boolean |
メインイベント フィールドの「summary」、「description」、「location」、「start」、「end」を変更できない、ロックされたイベントコピーであるかどうか“recurrence”などがありますデフォルトは False です。読み取り専用。 | |
organizer |
object |
予定の主催者。主催者も参加者である場合は、attendees に個別のエントリが表示され、organizer フィールドが True に設定されます。主催者を変更するには、move オペレーションを使用します。読み取り専用。ただし、イベントをインポートする場合は除きます。 |
書き込み可能 |
organizer.displayName |
string |
主催者の名前(利用可能な場合)。 | 書き込み可能 |
organizer.email |
string |
主催者のメールアドレス(利用可能な場合)。RFC5322 に基づく有効なメールアドレスである必要があります。 | 書き込み可能 |
organizer.id |
string |
主催者のプロフィール ID(利用可能な場合)。 | |
organizer.self |
boolean |
この予定のコピーが表示されるカレンダーに対応しているかどうか。読み取り専用。デフォルトは False です。 | |
originalStartTime |
nested object |
定期的な予定の場合は、recurringEventId で識別される定期的な予定の繰り返しデータに基づいて、この予定が開始される時刻です。インスタンスが別の時間に移動された場合でも、一連の定期的な予定内でインスタンスを一意に識別します。変更できません。 | |
originalStartTime.date |
date |
終日イベントの場合は、「yyyy-mm-dd」形式の日付。 | 書き込み可能 |
originalStartTime.dateTime |
datetime |
結合された日時の値で表される時刻(RFC3339 の形式)。timeZone でタイムゾーンが明示的に指定されていない限り、タイムゾーン オフセットが必要です。 |
書き込み可能 |
originalStartTime.timeZone |
string |
時刻が指定されているタイムゾーン。(形式は「Europe/Zurich」などの IANA タイムゾーン データベース名になります)。定期的な予定の場合、このフィールドは必須です。展開されるタイムゾーンのタイムゾーンを指定します。単一のイベントの場合、このフィールドは省略可能で、イベントの開始と終了のカスタム タイムゾーンを示します。 | 書き込み可能 |
outOfOfficeProperties |
nested object |
不在の予定データ。eventType が outOfOffice の場合に使用されます。 |
書き込み可能 |
outOfOfficeProperties.autoDeclineMode |
string |
不在の予定と重なる会議の招待状を辞退するかどうか。有効な値は declineNone です。これは、会議の招待状が拒否されないことを表します。declineAllConflictingInvitations : この予定と競合する会議への招待はすべて拒否されます。および declineOnlyNewConflictingInvitations です。これにより、不在の予定がある間に届いた、競合する新しい会議への招待のみが拒否されます。 |
|
outOfOfficeProperties.declineMessage |
string |
既存の予定または新しい招待状がカレンダーによって自動的に辞退された場合に設定するレスポンス メッセージ。 | |
privateCopy |
boolean |
True に設定すると、イベントの伝播は無効になります。これは、非公開イベントのプロパティとは異なります。省略可。変更不可。デフォルトは False です。 | |
recurrence[] |
list |
RFC5545 で指定されている、定期的なイベントの RRULE、EXRULE、RDATE、EXDATE 行のリスト。このフィールドでは、DTSTART 行と DTEND 行は使用できません。イベントの開始時間と終了時間は、start フィールドと end フィールドで指定します。単一の予定または定期的な予定の場合、このフィールドは省略されます。 |
書き込み可能 |
recurringEventId |
string |
定期的な予定のインスタンスの場合、これは、このインスタンスが属する定期的な予定の id です。変更できません。 |
|
reminders |
object |
認証されたユーザー向けの予定のリマインダーに関する情報。なお、リマインダーを変更しても、それを含むイベントの updated プロパティは変更されません。 |
|
reminders.overrides[] |
list |
その予定でデフォルトのリマインダーが使用されていない場合は、その予定に固有のリマインダーが一覧表示されます。未設定の場合は、その予定にリマインダーが設定されていないことを示します。オーバーライドのリマインダーは最大 5 件です。 | 書き込み可能 |
reminders.overrides[].method |
string |
このリマインダーで使用されているメソッド。有効な値は次のとおりです。
リマインダーを追加する場合は必須です。 |
書き込み可能 |
reminders.overrides[].minutes |
integer |
リマインダーをトリガーする予定が始まるまでの時間(分)。有効な値は 0 ~ 40320(4 週間(分))です。 リマインダーを追加する場合は必須です。 |
書き込み可能 |
reminders.useDefault |
boolean |
カレンダーのデフォルトのリマインダーを予定に適用するかどうかを指定します。 | 書き込み可能 |
sequence |
integer |
iCalendar に基づくシーケンス番号。 | 書き込み可能 |
source |
object |
イベントの作成元。たとえば、HTTP または HTTPS スキームの URL で識別可能なウェブページ、メール メッセージ、ドキュメントなどです。イベントの作成者のみが表示または変更できます。 | |
source.title |
string |
ソースのタイトル。たとえば、ウェブページのタイトルやメールの件名などです。 | 書き込み可能 |
source.url |
string |
リソースを指すソースの URL。URL スキームは HTTP または HTTPS にする必要があります。 | 書き込み可能 |
start |
nested object |
イベントの開始時間(両端を含む)。定期的な予定の場合は、最初のインスタンスの開始時間。 | |
start.date |
date |
終日イベントの場合は、「yyyy-mm-dd」形式の日付。 | 書き込み可能 |
start.dateTime |
datetime |
結合された日時の値で表される時刻(RFC3339 の形式)。timeZone でタイムゾーンが明示的に指定されていない限り、タイムゾーン オフセットが必要です。 |
書き込み可能 |
start.timeZone |
string |
時刻が指定されているタイムゾーン。(形式は「Europe/Zurich」などの IANA タイムゾーン データベース名になります)。定期的な予定の場合、このフィールドは必須です。展開されるタイムゾーンのタイムゾーンを指定します。単一のイベントの場合、このフィールドは省略可能で、イベントの開始と終了のカスタム タイムゾーンを示します。 | 書き込み可能 |
status |
string |
イベントのステータス。省略可。有効な値は次のとおりです。
|
書き込み可能 |
summary |
string |
イベントのタイトル。 | 書き込み可能 |
transparency |
string |
その予定によってカレンダーの時間がブロックされるかどうか。省略可。有効な値は次のとおりです。
|
書き込み可能 |
updated |
datetime |
メインイベント データの最終更新日時(RFC3339 タイムスタンプ形式)。予定の通知を更新しても、これは変更されません。読み取り専用です。 | |
visibility |
string |
イベントの公開設定。省略可。有効な値は次のとおりです。
|
書き込み可能 |
workingLocationProperties |
nested object |
勤務場所のイベントデータ。 | 書き込み可能 |
workingLocationProperties.customLocation |
object |
指定すると、ユーザーがカスタムの場所で作業していることを指定します。 | 書き込み可能 |
workingLocationProperties.customLocation.label |
string |
追加情報のためのオプションの追加ラベル。 | 書き込み可能 |
workingLocationProperties.homeOffice |
any value |
これが存在する場合は、ユーザーが在宅勤務であることを指定します。 | 書き込み可能 |
workingLocationProperties.officeLocation |
object |
これが存在する場合は、ユーザーがオフィスで勤務していることを指定します。 | 書き込み可能 |
workingLocationProperties.officeLocation.buildingId |
string |
ビルディング ID(省略可)。組織のリソース データベースにあるビルディング ID を参照する必要があります。 | 書き込み可能 |
workingLocationProperties.officeLocation.deskId |
string |
デスク ID(省略可)。 | 書き込み可能 |
workingLocationProperties.officeLocation.floorId |
string |
オプションの階 ID。 | 書き込み可能 |
workingLocationProperties.officeLocation.floorSectionId |
string |
オプションの階のセクション ID。 | 書き込み可能 |
workingLocationProperties.officeLocation.label |
string |
ウェブ版カレンダーおよびモバイル版カレンダー クライアントに表示されるオフィス名。組織のリソース データベースにあるビルディング名を参照することをおすすめします。 | 書き込み可能 |
workingLocationProperties.type |
string |
勤務場所のタイプ。有効な値は次のとおりです。
勤務場所のプロパティを追加する場合は必須です。 |
書き込み可能 |
メソッド
- delete
- イベントを削除します。
- get
- Google カレンダー ID に基づいて予定を返します。iCalendar ID を使用して予定を取得するには、
iCalUID
パラメータを使用して events.list メソッドを呼び出します。 - インポート
- イベントをインポートします。この操作は、既存の予定の限定公開コピーをカレンダーに追加するために使用されます。インポートできるのは、
eventType
がdefault
のイベントのみです。非推奨の動作:
default
以外のイベントがインポートされると、その型はdefault
に変更され、イベントタイプ固有のプロパティはすべて破棄されます。 - insert
- イベントを作成します。
- インスタンス
- 指定した定期的な予定のインスタンスを返します。
- list
- 指定したカレンダーの予定を返します。
- 移動
- 予定を別のカレンダーに移動する(予定の主催者を変更するなど)。なお、移動できるのは
default
イベントのみです。outOfOffice
、focusTime
、workingLocation
、fromGmail
のイベントを移動できません。 - patch
- イベントを更新します。このメソッドは、パッチ セマンティクスをサポートしています。なお、パッチ リクエストごとに割り当てユニットが 3 つ消費されます。
get
の後にupdate
を付ける方が良いでしょう。指定したフィールド値によって、既存の値が置き換えられます。リクエストで指定しないフィールドは変更されません。配列フィールドを指定すると、既存の配列が上書きされます。前の配列要素が破棄されます。 - quickAdd
- 単純なテキスト文字列に基づいてイベントを作成します。
- update
- イベントを更新します。この方法では、パッチのセマンティクスはサポートされておらず、常にイベント リソース全体を更新します。部分的な更新を行うには、アトミック性を確保するために ETag を使用して
get
の後にupdate
を実行します。 - スマートウォッチ
- イベント リソースの変更を監視する。