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

イベントタイプ

このページでは、eventType プロパティとイベントタイプの仕様について説明します。サポートしています。

Google カレンダーでは、一般的な予定だけでなく、特定のユースケース向けに設計されており、カスタムプロパティが使用されています。

イベントタイプは API の次の場所で確認できます。

すべてのイベントは eventType で返されます。
eventType イベントリソースを作成または更新するときに設定する必要があります。未設定の場合、 'default' 型が使用されます。
eventTypes Events:list で指定できます。呼び出しを使用して、特定の種類のイベントを一覧表示します。タイプが指定されていない場合、すべてのイベントタイプがが返されます。
eventTypes Events:watch 引数で指定でき、呼び出しを使用して、特定の種類のイベントの最新情報を入手できます。タイプが指定すると、そのリクエストではすべてのイベントタイプがサブスクライブされます。

で確認できます。

デフォルトのイベント

default イベントタイプのイベントが作成され、主なイベントの一つとして使用されます。リソースをご覧くださいこれらのサービスはプロパティイベントをさらにカスタマイズできます。

詳しくは、作業を開始するイベントを作成します Google カレンダーの予定。

誕生日

誕生日は、毎年恒例の終日の特別なイベントです。この会社には仕様は次のとおりです。

eventType の設定 'birthday'。
start、 end フィールドでは、終日のイベントとして選択できます。
visibility フィールド値 'private' にする必要があります。
transparency フィールド値 'transparent' にする必要があります。
年 1 回の繰り返しが必要です。つまり、 recurrence フィールドには次の項目を指定する必要があります。 'RRULE:FREQ=YEARLY'。2 月 29 日の誕生日イベントに必要なもの: 次の繰り返しルールが適用されます。 'RRULE:FREQ=YEARLY;BYMONTH=2;BYMONTHDAY=-1'。
colorId を含めることができます。 summary、 reminders。
その他のイベントプロパティはサポートされていません。

Gmail からの予定

Gmail から自動生成された予定イベントタイプは 'fromGmail' です。

Google Calendar API では、 insert メソッドを使用します。

この API を使用すると、 colorId, reminders, visibility, transparency, status, private および shared update を使用した拡張プロパティ patch メソッドを使用します。

API は get とイベントを読み取るための list メソッド Gmail。eventTypes は次のいずれかです。 'fromGmail' に設定すると、Gmail から生成された予定のみが一覧表示されます。タイプがを指定すると、Gmail からの予定が、他のすべての種類の予定とともに一覧表示されます。

この API では、以下を行うための watch メソッドがサポートされています。 Gmail からの予定の変更情報を Google カレンダーで受け取る。タイプが指定すると、'fromGmail' を含むすべてのイベントタイプがサブスクライブされます。

Gmail からの予定は、 delete メソッド Google Calendar API

Gmail から予定の主催者を変更するには、 move または update メソッドはサポートされていません。

サイレントモード、不在、勤務場所

Google Calendar API を使用すると、カレンダーの予定にステータスが表示されます。

これらの機能はメインカレンダーでのみご利用いただけます。また、 Google カレンダーユーザーの場合。サイレントモード、不在、出勤時間を管理する位置情報イベントをご覧ください。

Google Apps Script のイベントタイプを確認する

Google Apps Script は、JavaScript ベースのクラウド統合するビジネスアプリケーションを構築できるスクリプト言語を Google Workspace ですスクリプトはブラウザベースのコードエディタで開発され、 Google のサーバーに保存され、実行されます。Google Apps Script もご覧ください。クイックスタートをご覧ください。 Google Calendar API にリクエストを送信する Apps Script。

次の手順では、 Google Calendar API（Google の高度なサービス） Google Apps Script。Google Calendar API のリソースとメソッドの完全なリストについては、リファレンスドキュメントをご覧ください。

スクリプトを作成して設定する

スクリプトを作成するには script.google.com/create.
左側のペインで [サービス] の横にある [サービスを追加] をクリックします。
[Google Calendar API] を選択し、[追加] をクリックします。
有効にすると、API が左側のペインに表示されます。利用可能なメソッドと API のクラスをリストするには、エディタで Calendar キーワードを使用します。

（省略可）Google Cloud プロジェクトを更新する

各 Google Apps Script プロジェクトには Google Cloud プロジェクトが関連付けられています。お客様の Google Apps Script がデフォルトプロジェクトを使用して作成します。カスタム Google Cloud プロジェクトを使用する場合は、別の標準 Cloud プロジェクトを使用します。 Google Cloud プロジェクトを設定したら、左側にある [編集者] を選択してできます。

スクリプトにコードを追加する

次のコードサンプルは、 eventType の値が異なるためです。

次のコードをコードエディタに貼り付けます。

const CALENDAR_ID = 'CALENDAR_ID' || 'primary';

/** Lists default events. */
function listDefaultEvents() {
  listEvents('default');
}

/** Lists events from Gmail. */
function listEventsFromGmail() {
  listEvents('fromGmail');
}

/**
  * Lists events with the given event type. If no type is specified, lists all events.
  * See https://developers.google.com/calendar/api/v3/reference/events/list
  */
function listEvents(eventType = undefined) {
  // Query parameters for the list request.
  const optionalArgs = {
    eventTypes: eventType ? [eventType] : undefined,
    singleEvents: true,
    timeMax: '2024-07-30T00:00:00+01:00',
    timeMin: '2024-07-29T00:00:00+01:00',
  }
  try {
    var response = Calendar.Events.list(CALENDAR_ID, optionalArgs);
    response.items.forEach(event => console.log(event));
  } catch (exception) {
    console.log(exception.message);
  }
}

/**
  * Reads the event with the given eventId.
  * See https://developers.google.com/calendar/api/v3/reference/events/get
  */
function readEvent() {
  try {
    var response = Calendar.Events.get(CALENDAR_ID, 'EVENT_ID');
    console.log(response);
  } catch (exception) {
    console.log(exception.message);
  }
}

/** Creates a default event. */
function createDefaultEvent() {
  const event = {
    start: { dateTime: '2024-07-30T10:30:00+01:00'},
    end: { dateTime: '2024-07-30T12:30:00+01:00'},
    description: 'Created from Apps Script.',
    eventType: 'default',
    summary: 'Sample event',
  }
  createEvent(event);
}

/**
  * Creates a Calendar event.
  * See https://developers.google.com/calendar/api/v3/reference/events/insert
  */
function createEvent(event) {

  try {
    var response = Calendar.Events.insert(event, CALENDAR_ID);
    console.log(response);
  } catch (exception) {
    console.log(exception.message);
  }
}

次のように置き換えます。

CALENDAR_ID: 共有先のカレンダーのメールアドレスイベントの取得と作成ができますこの定数の初期値は 'primary'。これは、メインカレンダーにアクセスするためのキーワードです。できます。この値を変更すると、次のカレンダーの予定を読めるようになります: できます。
EVENT_ID: イベントの ID。この関数を呼び出すには、 Events:list を使用してイベント ID を取得します。

サンプルコードの実行

コードエディタの上にあるプルダウンメニューから、実行する関数を選択します。 [実行] をクリックします。
最初の実行で、アクセスの承認を求められます。確認して許可 Apps Script を使用してカレンダーにアクセスできます。
スクリプトの実行結果は、 実行ログ: ウィンドウの下部に表示されます。