Skip to content

「カレンダーに追加」リンク

イベント、セール、または予約を宣伝する場合、メールに「カレンダーに追加」リンクを追加すると、ユーザーが簡単にイベントをカレンダーに保存できるようになります。

そのためには、メールの下書きを作成し、リンクをどこに配置するかを決めます。次に、2 つのオプションを追加します。1 つは Google カレンダー用、もう 1 つは他のカレンダー (iCal や Outlook など) 用です。たとえば、「Google カレンダーに追加」や「iCal または Outlook に追加」などとします。

ダッシュボードにリンクを追加するときのリンクダイアログ。[リンク情報] タブが選択され、テキストが [Google カレンダーに追加] に設定されます。

URL フォーマット

プレースホルダーを置き換えて、次の URL をリンクに追加します。これら 2 つの URL の唯一の違いは、Google カレンダーには &format=gcal パラメーターが必要な点です。

1

https://ics.agical.io/?subject=EVENT_SUBJECT&location=EVENT_LOCATION&dtstart=START_TIME&dtend=END_TIME&description=EVENT_DESCRIPTION&format=gcal

1

https://ics.agical.io/?subject=EVENT_SUBJECT&location=EVENT_LOCATION&dtstart=START_TIME&dtend=END_TIME&description=EVENT_DESCRIPTION

以下を置き換えます。

  • EVENT_SUBJECT: イベントのタイトル
  • EVENT_LOCATION: イベントの場所
  • START_TIME: ISO 8601 形式 (YYYY-MM-DDTHH: MM: SSZ) の UTC 時刻で表したイベント開始時刻
  • END_TIME: ISO 8601 形式 (YYYY-MM-DDTHH: MM: SSZ) の UTC 時刻で表したイベント終了時刻
  • EVENT_DESCRIPTION: イベントの説明

すべてのスペースを HTML エスケープコード「%20」に置き換えます。たとえば、「Meet Braze」という件名は「Meet%20Braze」になります。

「Google カレンダーに追加」のURL の例は次のとおりです。

1

https://ics.agical.io/?subject=Meet%20Braze&location=114%20Sansome%20Street&dtstart=2021-06-24T15:00:00Z&dtend=2021-06-24T16:00:00Z&description=Braze%20Party&format=gcal

その他のパラメーター

以下のパラメーターはオプションで、イベントのその他の要素を定義するために使用できます。

主催者 name: &organizer=name イベントに関連する URL を添付: &attach=http://www.example.com/ 期間: duration=30Mイベント終了時刻 (dtend) の代わりに、1 時間や 30 分などの期間を指定 リマインダーアラーム時間 (分単位): &reminder=15 終日イベント: &allday=1 UID: イベントの一意の識別子をハードコーディングするオプションのパラメーターで、一部のカレンダーアプリでは時間の経過とともにイベントを更新できるようにします。値には @ics .agical.io という文字列が自動的に追加されます。

繰り返し発生するイベントには、以下のようなパラメーターを追加することもできます。

  • 毎週のイベント: &recur=weekly
  • 毎月のイベント: &recur=monthly -繰り返しの終了: &recuruntil=END_DATE。ここで END_DATE は繰り返しが終了する日時を ISO 8601 形式 (YYYY-MM-DDTHH: MM: SSZ) の UTC 時刻で表したものです。

リンクの動作

ユーザーがリンクをクリックすると、カレンダーは URL の UTC タイムスタンプを、カレンダーに設定されているユーザーのタイムゾーンに合わせて自動的に変換します。

たとえば、[Google カレンダーに追加] リンクを開いたときにカレンダーが CST に設定されている場合、イベントの時間は UTC の午後 3 時に相当する ＣＳＴ 時刻 (午前 10 時) を使って事前入力されます。

Google カレンダー

クリックすると、Google カレンダーが新しいタブまたはウィンドウで開き、イベントの詳細が招待状にあらかじめ入力され、ユーザーが [保存] をクリックできるようになります。これはモバイルとデスクトップの両方で発生します。

Google カレンダーダイアログでイベントの詳細が追加され、保存できる状態になります。

iCal と Outlook

デスクトップでは、クリックすると ICS ファイルがダウンロードされます。次に、ユーザーは ICS ファイルを開く必要があります。これにより iCal または Outlook が開き、カレンダーにイベントを追加するよう求められます。

iCal カレンダーに新しいイベントを追加するダイアログが表示され、ユーザーにカレンダーの選択と確認を求めます。

イベントが追加された iCal カレンダー。

モバイルでは、ユーザーはリンクを長押しする必要があります。これにより、カレンダーに追加するよう求められます。

「カレンダーに追加」ボタンを含むカレンダーリンクを長押しすると iOS がポップアップを表示します。

  GitHub でこのページを編集
「このページはどの程度役に立ちましたか?」
New Stuff!