予定を作成する
主催者の Google カレンダーへの書き込みアクセス権がある場合は、
Events: insert を使用したイベント
メソッドを呼び出します。
この方法では、予定が主催者のカレンダーに直接追加され、 招待を追加します。
参加者を追加
この方法では、ゲストを同じ予定に追加することもできます。
メールアドレスを attendees に送信します
プロパティを使用します。主催者が予定に対して今後行う変更には、
引き継がれます。
参加者は、主催者のメールアドレスから招待状を受け取ります。Google カレンダーのユーザーは、メールやカレンダーで招待状を受け取りますが、 Google カレンダーの予定の設定に応じて異なります。
From everyoneが設定されている場合、イベントは直接 友だちのカレンダー- 設定が
Only if the sender is knownの場合、予定は追加されます。 過去に Google Chat で以前にやり取りしたことが 主催者と同じ組織に所属している場合、または主催者が Google コンタクトに登録されています。主催者が 相手が知らない場合は、[この送信者を知っています] をクリックするか、出欠確認を 招待メールで [はい] または [未定] をクリックします。イベントは 追加することもできます。 - ユーザーに
When I respond in emailが設定されている場合、すべての招待状は 招待したユーザーのカレンダーに [はい]、[未定]、 または [いいえ] を選択します。
Google カレンダーに招待状が追加される仕組みについて詳しくは、 Google カレンダーで招待状を管理する
参加者のレスポンスを
attendees[].responseStatus
プロパティを needsAction 以外にすることはできません。参加者の
イベントが自動的に追加されず、できます。
参加者のカレンダー
Google カレンダーの参加者のスペースに直接予定を表示するには、カレンダーを 必要に応じて、 参加者の出欠確認を設定する、または 参加者のカレンダーに予定のコピーを直接インポートする。 どちらの方法でも、 書き込みアクセス権を参加者に付与する カレンダーない場合は、 主催者を参加者の連絡先に追加する 参加者の連絡先への書き込みアクセス権が必要です。
参加者の出欠確認を設定する
参加者の出欠確認を予定に設定する手順は次のとおりです。
- Google カレンダーの主催者のカレンダーで予定を作成し、 必要があります（上記を参照）。
Events: updateメソッドを使用する 「 参加者の出欠確認acceptedまたはtentativeに変更します。参加者のスペースに カレンダー。なお、 アクセスできます。Events: updateメソッドの使用方法の詳細
この方法では、参加者のカレンダーに予定が追加されますが、 招待がアドレスから送信したことを示すバナーがメールに表示される 認識できなかったためです
参加者のカレンダーに予定のコピーを直接インポートする
予定のコピーを参加者のカレンダーにインポートする手順は次のとおりです。 手順:
- 主催者の Google カレンダーへの書き込み権限がある場合は、
イベントの
Events: importメソッドを使用します。 - 同じ予定の別のコピーを参加者の
Events: importを使用します。 参加者のカレンダーへの書き込みアクセス権が必要です。同じイベント ID を使用する （iCalUID） コピーを添付し、主催者と参加者のメールアドレスを メモを追加します。
この方法では、参加者は自分のカレンダーで予定を表示できますが、 Google カレンダーから招待メールが届きます。
主催者を参加者の連絡先に追加する
参加者の認証情報がわからない場合は、 組織で Google コンタクトに主催者のメールアドレスを追加するよう依頼した場合 カレンダーに直接予定を表示できます。一部の商品については 新しく作成された連絡先が有効になるまでにわずかな遅延が発生します。
- Google カレンダー ユーザーに、Google コンタクトに主催者を追加するよう依頼します。
- 参加者が組織に所属している場合は、その組織の
管理者がプログラムでユーザーのメールアドレスを
できます。管理者に有効にするよう依頼してください
ドメイン全体の委任
そのユーザーになりすまし、
People: createContactメソッドを使って各ユーザーの連絡先を作成し、今後の招待が 自動的にユーザーのアカウントにできます。 - 参加者の連絡先にアクセスできる場合は、
参加者の連絡先に主催者のメールアドレスを
People: createContactメソッドを使用します。
メールアドレスからユーザーを招待する
主催者の Google カレンダーへの書き込みアクセス権がない場合、または 主催者のメールアドレスを公開したくない場合は、iCalendar を使用してください。 プロトコル （RFC-5545）。 .ICS ファイルを使用してメールでユーザーを招待できます。
参加者が Only if the sender
is known 設定の Google カレンダー ユーザーであり、以前にこのアドレスを操作または記録したことがない場合
招待状は、相手が [I
招待されているか、予定への出欠確認も行えます。
ユーザーがイベントを追加するためのリンクを提供する
また、Google カレンダーのユーザーが簡単にカレンダーを イベントを 1 回限りのイベントとして自動更新する場合は、 ユーザーが自身を追加するための事前入力済みイベントです。この方法では、 ユーザーのカレンダーの予定を、手動で更新することはできません。 ユーザーのカレンダーへのアクセス権を取得します。
次のリンク テンプレートを使用します。
https://calendar.google.com/calendar/r/eventedit?action=TEMPLATE&dates=20230325T224500Z%2F20230326T001500Z&stz=Europe/Brussels&etz=Europe/Brussels&details=EVENT_DESCRIPTION_HERE&location=EVENT_LOCATION_HERE&text=EVENT_TITLE_HERE
以下の情報を更新します。
- 開始日時と終了日時: ISO 8601 形式を使用します。上記の例では、
20230325T224500Zと20230326T001500Zを置き換えます。 - 開始タイムゾーンと終了タイムゾーン: IANA タイムゾーン データベース名の形式で指定します。
stzフィールドとetzフィールドにタイムゾーンを入力します。 - イベントの説明: URL エンコードが必要。
- イベントの場所: URL エンコードが必要です。
- イベント タイトル: URL エンコードが必要です。
例
予約サービスを構築して ユーザーがビジネスの予定を予約する数が増えます。ユーザーが予定を予約すると 予約したユーザーとビジネスの Google サービスにイベントを追加するよう、 カレンダー。
最適なユーザー エクスペリエンスを実現するには、ビジネスに書き込みアクセス権を付与することをおすすめします。 ゲストのカレンダーに予定を追加して、その予定を カレンダー（[予定を作成]）を選択し、予約者をその予定に招待します。 （参加者を追加）。予約した相手が Google Meet のビデオ会議内で その予定を知らせるリマインダーを受け取ったら、メールや 予約を取ったらすぐにイベントに対して [はい] と回答します。相手が出欠確認を イベントとともに Google カレンダーのイベント通知機能 通知を受け取ることができます
予約者のカレンダーに予定を直接追加する場合は、予約者に通知してください 連絡先に追加する 招待状を受け取るメールアドレスまたは 予約者にカレンダーへの書き込みアクセス権を要求し、 参加者の出欠確認を設定し、参加者にメールを送信します。 確認済みの予約に関する通知を受け取ります。
メールアドレスを公開したくない場合は、ユーザー固有の メールアドレスを使用して予約者に予定を送信します。 （メールアドレスからユーザーを招待する）。
イベントの伝播
次の図は、ダイナミクスを示しています。まず Jack はイベントを作成し、
メイン カレンダーである（そのため、主催者用のコピーが所有している）。次に、
チェロのレッスン グループのサブカレンダーと、予定を設定している Susan
Only if the sender is known。参加者チェロのレッスンでコピーが作成されます
グループの予備カレンダーです。Jack と知り合いの場合は Susan のカレンダーに表示され、そうでない場合は Susan のカレンダーに表示されます。
出欠確認をしたり、ジャックのことを知っていると伝えたりしたときに通知を受け取れます。Susan が応答すると、出欠確認の内容が変更されます
反映され、主催者のコピーが
Susan の回答。主催者が作成した予定のコピーに対してこれらの変更を行うと、
他の参加者にも反映されます。
共有イベントのプロパティ
予定が作成されるカレンダーは、主催者のカレンダーです。この カレンダーは共有された予定情報を所有します。この情報には、ID、開始時間と終了時間、 概要、説明です。主催者の情報が更新された場合 変更内容は参加者のコピーに反映されます。
非公開イベントのプロパティ
予定のコピー間ですべての情報が共有されるわけではありません。一部のプロパティは
たとえば、リマインダー、colorId、透明性、
extendedProperties.private プロパティ。これらのプロパティは、
参加者の設定に反映されます。
参加者は、予定の共有プロパティを変更することもできます。ただし、 変更は自分のコピーにのみ反映されるため、主催者が変更しなかった場合、 変更されます。
参加者から主催者に送信される予定の変更は、
参加者の応答ステータスが表示されます。このステータスは、
attendees[].responseStatus
プロパティです。