高度なカレンダー サービスを使用すると、Apps Script で一般公開の Google Calendar API を使用できます。Apps Script の組み込みカレンダー サービスと同様に、この API を使用すると、スクリプトからユーザーの Google カレンダー(ユーザーが登録している他のカレンダーを含む)にアクセスして変更できます。ほとんどの場合、組み込みサービスの方が使いやすいですが、この拡張サービスでは、個々のイベントの背景色の設定など、いくつかの追加機能を利用できます。
リファレンス
このサービスの詳細については、一般公開の Google Calendar API のリファレンス ドキュメントをご覧ください。Apps Script のすべての拡張サービスと同様に、高度なカレンダー サービスでは公開 API と同じオブジェクト、メソッド、パラメータを使用します。詳細については、メソッド シグネチャの決定方法をご覧ください。
問題の報告やその他のサポートについては、カレンダー サポートガイドをご覧ください。
HTTP リクエスト ヘッダー
高度なカレンダー サービスでは、HTTP リクエスト ヘッダー If-Match
と If-None-Match
を使用できます。詳細については、リファレンス ドキュメントをご覧ください。
サンプルコード
以下のサンプルコードでは、API のバージョン 3 を使用しています。
イベントの作成
次の例は、ユーザーのデフォルト カレンダーにイベントを作成する方法を示しています。
カレンダーの一覧表示
次の例は、ユーザーのカレンダー リストに表示されているカレンダーの詳細を取得する方法を示しています。
イベントの一覧表示
次の例は、ユーザーのデフォルトのカレンダーで、次の 10 件の今後の予定を表示する方法を示しています。
イベントを条件付きで変更する
次の例は、If-Match
ヘッダーを使用して、条件付きでカレンダーの予定を更新する方法を示しています。このスクリプトは新しいイベントを作成し、30 秒待ってから、イベントの作成後にイベントの詳細が変更されていない場合にのみ、イベントを更新します。
イベントを条件付きで取得する
次の例は、If-None-Match
ヘッダーを使用して、条件付きでカレンダーの予定を取得する方法を示しています。このスクリプトは新しいイベントを作成し、30 秒間の変更をポーリングします。イベントが変更されるたびに新しいバージョンが取得されます。
イベントを同期する
次の例は、同期トークンを使用してイベントを取得する方法を示しています。 カレンダー拡張サービス リクエストに同期トークンを含めると、トークンの生成後に変更されたアイテムのみがレスポンスに含まれるため、処理の効率が向上します。同期プロセスの詳細については、リソースを効率的に同期するをご覧ください。
次の例では、上記の例で定義したものと同じ getRelativeDate(daysOffset, hour)
メソッドを使用します。