# Zoomカレンダー連携エンドポイント ### Webカレンダーサービス Webカレンダーサービスは、すべてのZoom Appsにカレンダー情報を提供するZoomの能力の中核です。 #### Zoomはどのような情報を保存しますか？ Zoom Webカレンダーサービスは、各ユーザーのカレンダープロバイダーを認証するために必要なオブジェクトを保存します。これは、組織がOAuthを使用してOutlookまたはGoogleカレンダーをZoomサービスに接続する際に、Zoomが更新トークンを保存することを意味します。また、Exchange On-Premisesへのベーシック認証を使用する組織については、Zoomがアカウントのユーザー名とパスワードを保存することも意味します。 | 同期されたイベント | | ----------- | | `出席者省略` | | `説明` | | `表示名` （出席者） | | `メール` （出席者） | | `固定勤務場所` | | `iCalUID` | | `位置情報` | | `表示名` (主催者) | | `メール` (主催者) | | `要約` | | `時間の提案` | | `勤務場所が有効` | 双方向カレンダー同期（同期 2.0）が有効な場合、Zoom は外部カレンダーのイベントデータ（Microsoft 365 または Googleカレンダー からのもの）をそのデータベースに保持しません。\ \ 代わりに、このサービスはカレンダーアクティビティの24か月間のローリングウィンドウ（過去最大6か月、将来18か月先まで）を監視します。このウィンドウ内で変更が発生すると、Zoom はカレンダープロバイダーから変更通知を受け取り、対応する Zoom ミーティング の更新を処理するために、必要に応じて更新されたイベントデータを取得します。その後、必要な変更を適用するようミーティングサービスに通知されます。 管理者は、この機能をアカウントまたはユーザーグループレベルで設定することができます。詳しくは当社の [サポート文書](https://support.zoom.us/hc/en-us/articles/8522918261645-Enabling-bi-directional-calendar-sync) 詳細については。 #### 保存されたトークンと認証情報はどのように保護されていますか？ 保存されたトークンと認証情報は、256ビット AES-GCM 暗号化を使用して保存時に暗号化されています。このデータは顧客コンテンツと見なされ、Zoomのアクセスコントロールポリシーおよび基準の対象となります。これらのコントロールは、SOC 2 など、当社のセキュリティ認証およびアテステーションで示されている場合、独立した監査法人によって評価されます。インフラデータおよびシステムへの特権アクセスは、認証と最小特権アクセスコントロールを使用して記録、監視、管理されています。 #### アプリとカレンダー提供元間のトラフィックはどのように保護されていますか？ カレンダー プロバイダとあらゆる Zoom ソフトウェア（Zoom デスクトップ／モバイルアプリ、Zoom Web カレンダー サービス、スケジュール作成ツール、および API コネクタ）間の通信は、転送中に TLS 1.2 を使用して暗号化されます。 #### OAuthトークンはどのくらい有効ですか? Zoom は 1 時間で期限切れになるアクセス トークンと 90 日で期限切れになる更新トークンを要求しますが、カレンダー提供元によっては別の制限のトークンを提供する場合があります。デフォルト値を変更する必要がある場合は、提供元の指示に従ってください。 #### OAuth トークンまたは認証情報を取り消すことはできますか？ Zoomの管理者は、いつでも単一のZoomアカウントからカレンダー連携を選択して削除できます。これにより、ユーザーのカレンダー機能が動作しなくなります。該当ユーザーの保存済みトークンまたは資格情報を直ちに削除してください。 Microsoft 365 の管理者は、Entra ID のエンタープライズ アプリケーション ポータルで Zoom のカレンダー アクセスを削除することで、すべてのユーザー アカウントから Zoom のカレンダー アクセスを削除でき、Google ワークスペース の管理者は Google クラウド プラットフォーム コンソールを使用してアクセスを取り消すことができます。 #### Zoomのカレンダーまたは連絡先データを書き込む機能を、プロバイダーに対して制限できますか？ 初期設定後、Zoom 管理者は、Microsoft 365 メソッドを使用して接続中の際に、カレンダーと連絡先の両方について、Read と Read/Write のアクセス許可のどちらかを選択できます。管理者はまた、ユーザーのカレンダーに対する Google ワークスペースの統合を制限することもできます。 ### デスクトップおよびモバイルアプリ #### Zoom Apps は、予定表や連絡先データを保存しますか? Zoom Appsは、カレンダー関連の情報を一時メモリ（RAM）に保持し、ローカルディスクにいかなる項目も永続化しません。これには、認証トークン、資格情報、カレンダーのイベント情報、および連絡先データが含まれます。これらのデータは、クライアントが終了するとオンラインではなくなります。 #### サインイン時に何が起こりますか？ Zoom Apps は、今後の イベント の一覧を収集するために、サインインのたびに完全リフレッシュを開始します。これには、Zoom Web カレンダー サービスから OAuth アクセス トークン、または保存された認証情報を受け取り、そのオブジェクトを使用して、予定情報プロバイダーから イベント データを直接リフレッシュすることが含まれます。アクセス トークンが無効な場合、Zoom Web カレンダー サービスはリフレッシュ トークンを使用して新しい アクセス トークンを要求し、クライアントに渡します。 #### クライアントは、今後のイベント一覧を更新する必要があることをどのように知るのですか？ Zoom Web カレンダー Service は、カレンダーが Web ポータルで接続された後、各ユーザーに対してカレンダー プロバイダーの Webhook をサブスクライブします。これらの Webhook は、変更があったことを Web Calendaring Service に通知し、その後、更新が必要であることを Zoomクライアント に通知できるようにします。最後に、Zoomクライアント はカレンダー プロバイダーに直接更新を要求します。更新の通知を受信しないアプリは、30 分ごとにイベント リストを更新します。 #### クライアントに利用可能なミーティングの詳細は何ですか？ Zoom Appsは、解析するイベントをサニタイズした後にミーティングデータを表示します。つまり、使用しない属性はすべて破棄されます。使用と破棄のために保存されるイベント属性は、以下の表に示されています。 | クライアントに表示するために保存 | 破棄され、保持されない | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- | | | | | \*AI Companion 2.0によるイベントキャプチャが有効な場合のみ | | #### クライアントログにカレンダー関連のデータは保存されていますか？ Zoom Apps では、トークン、認証情報、イベントなどの機密性の高いカレンダー データを、どのクライアント ログにも出力しません。 ### スケジュール作成ツール Zoomは、MicrosoftおよびGoogle製品を使ったZoomミーティングのスケジュール作成体験を簡素化するさまざまなツールを提供しています。これらの製品には、Google ワークスペースおよびMicrosoft 365向けのネイティブなスケジュール作成統合、または選択されたブラウザやOutlookで使用するためのソフトウェア拡張機能が含まれます。 #### スケジュール作成ツールはどのように機能しますか？ すべてのスケジュール作成ツールは、Outlookプラグインを除き、カレンダー提供元とZoomのWeb Calendaring Serviceの両方に対して直接APIリクエストを送信します。Outlookプラグインは、ミーティングをZoomデスクトップクライアント経由でスケジュールする点が異なり、クライアントがプラグインに代わってZoom Web Calendaring ServiceへAPIリクエストを送信します。 #### ツールを使ってスケジュール作成する際、どの情報がZoomに送信されますか？ スケジュール作成ツールを使用する際に保持される唯一のデータは、ミーティングのスケジュールに必要な情報です。たとえば、ユーザーがMicrosoft 365アドインを使用してZoomミーティングをスケジュールする場合、アドインはイベントの件名、日付、時刻、タイムゾーン、および繰り返しフラグを使用してZoomミーティングをスケジュールします。Zoomアドインは、本文や出席者リストのような追加の詳細を要求したり使用したりしません。 #### ファイアウォールやセキュリティに関する要件はありますか？ スケジュール作成ツールには、カレンダー連携にすでに必要なもの以外に、追加のファイアウォールやセキュリティの変更は必要ありません。要件の完全な一覧は、以下に記載されています [Zoomのネットワークおよびファイアウォールのルール](https://support.zoom.us/hc/en-us/articles/201362683-Network-firewall-or-proxy-server-settings-for-Zoom). #### OutlookプラグインとOutlookアドインの違いは何ですか？ Outlookプラグインはエンドユーザーの端末にインストールされ、Outlookクライアントを通じたZoomミーティングのスケジュール作成を支援します。プラグインは、プロセス間通信チャネル（IPC）を介してZoom Workplaceデスクトップクライアントと通信します。このIPCを使用して、プラグインはクライアントのリソースを通じてZoomのWeb Calendaring Serviceにスケジュールを送信します。 AppleとMicrosoftが定めるポリシーとガイドラインを順守しながらユーザーに最適な体験を提供するため、ZoomではOutlook向けZoomアドインの導入と利用を強く推奨しています。アドインは、より簡単な導入と、より堅牢な管理ソリューションを提供し、Microsoftによって積極的にサポートされており、Appleのようなベンダーによって最近強化されたセキュリティ要件にもより適合しています。 {% hint style="danger" %} **警告** Zoom向けOutlookプラグインに新しい機能強化は実装されません。Zoom向けOutlookアドインへの移行を強く推奨します。 {% endhint %} Outlook 追加-in は、ユーザーの端末へのローカルインストールを必要としない Web ベースのアプリケーションであり、代わりに組み込みの Web アプリとして表示され、ローカル クライアントと Web 上の Outlook の両方でオンライン です。追加-in は、Zoom の Calendaring Web Service と直接通信する Web API を通じて動作します。 プラグインとアドインは同様の機能を提供しますが、アドインを利用するには Outlook JavaScript API 要件セット v1.8、つまり Outlook の現行バージョンにのみ存在し、オンプレミスの Exchange Server ではまったく利用できないバージョンが利用可能である必要があります。これは次を意味します： * Outlook 追加インは、オンプレミスの Exchange Server での代理人のスケジュール作成には使用できません。 * 委任者は、他のユーザーに代わって会議をスケジュールするには、Microsoft 365 Outlook クライアント、Mac/PC 用 Outlook 2021 以降、または Outlook on the Web を使用する必要があります。 #### 公式の Zoom アドイン アプリケーションをどのように識別できますか? 公式のOutlook向けZoom アプリケーション、オンラインの [Microsoft AppSource ストア](https://appsource.microsoft.com/en-us/product/office/WA104381712?tab=Overview) Entra ID エンタープライズ Apps ディレクトリに、アプリケーション ID ce63c970-e2d7-45e6-bee1-80c330b0800b を使用して「Zoom-Office-追加-in-SSO」という名前でインストールされます。 #### Outlookプラグインまたはアドインを更新する必要がありますか？ 2025年1月時点で、Microsoftは従来のExchange Onlineトークンをネストされたアプリ認証 (NAA) に置き換え始めました。Zoom管理者は、Entra管理者と協力して、サポート記事の手順に従い、Zoomウェブポータル内でNAAを設定する必要があります [Office アドインのネストされたアプリ認証の構成](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0078410). {% hint style="info" %} **注** ネストされたアプリ認証（NAA）は、Exchange Online でのみサポートされています。Exchange 2019（またはその他のオンプレミス版 Exchange）を使用している組織では、従来の Exchange ユーザー ID トークンおよびコールバック トークンを引き続き利用する必要があります。これらはオンプレミス環境ではブロックされないためです。 {% endhint %} それ以外の場合、Outlook向けZoomの追加機能は、ユーザーのマシンへのローカルインストールを必要としないWebベースのアプリケーションであり、その代わりに、ZoomのWeb Calendaring Serviceと通信するためにWeb APIを介して動作する組み込みのWebアプリケーションとして表示されます。この追加機能は、WindowsおよびmacOSのOutlookアプリケーション、AndroidおよびiOSのOutlookアプリケーション、ならびにWeb版Outlookでオンラインです。この追加機能は、Outlook管理者によって設定して一括展開することも、個々のユーザーによってインストールすることもできます。 Outlookプラグインは、インストールされたソフトウェアとして動作し、時折の更新や機能拡張の対象となります。そのため、プラグインは時間の経過とともにバージョン管理とアップグレードを必要とします。 {% hint style="info" %} **注** Outlookプラグインではネストされたアプリ認証は不要です。 {% endhint %} #### どのスケジュール作成ツールが私の環境に最適ですか？ **Google ワークスペース** GoogleカレンダーからZoom Meetingsをスケジュールできるように、GoogleカレンダーからZoom Meetingsをスケジュールできるようにするには、Google Workspace を使用している組織は、Google Workspace Marketplace から Zoom for GSuite アプリをインストールすることで、すべてのユーザーに簡単に有効にすることができます。アプリは一元管理されており、Zoom が Google に対して改善を送信すると自動的に更新されます。 あるいは、ブラウザベースの拡張機能もオンラインで利用できますが、通常は個人のアカウントユーザー向けです。というのも、ローカルへのインストール、定期的な更新が必要であり、中央で管理されないためです。 **Microsoft** Microsoft 365 またはオンプレミスの Exchange Server を使用している組織では、最適なオプションは環境とカレンダー連携の設定方法の両方によって異なります。 Outlook向けZoom アドインは、Microsoft 365 環境向けの推奨ツールです。デスクトップ版、Web 版、モバイル版の Outlook のいずれを使用していてもかまいません。アドインには、Microsoft 365 向けの Outlook、Windows 用の Outlook 2013 以降、または Mac 用の Outlook 2016 以降が必要です。 双方向カレンダー同期により、カレンダーの更新がシームレスに行われ、カレンダーを連携する際にはデフォルトで有効になります。これにより、Zoom は Outlook のカレンダーイベントに加えられた変更（予定変更やキャンセルなど）を、アドインを使ってユーザーがミーティングを手動で更新または削除しなくても自動的に反映できます。これは特に重要です。というのも、変更が反映されないと Zoom のミーティングリンクは期限切れになる可能性があり、特にミーティングが元の日時から 30 日以上先に移動された場合はその傾向が強くなります。ミーティング ID は、通常、繰り返しシリーズの一部でない限り 30 日後に期限切れになります。 最新の JavaScript API (v1.8) は、OnAppointmentSend のようなイベントベースの自動化を支えていますが、次の環境およびアプリケーションではサポートされていません。 * オンプレミスの Exchange 環境 * M365 に接続されたクラシック Outlook * iOS と Android のモバイル Outlook その結果、これらの構成では、Zoom はアドインを通じてミーティングを自動的に検出または更新できません。双方向同期または API ベースの自動化がない場合、繰り返しミーティングであっても変更が反映されないことがあり、その結果、Zoom リンクが期限切れまたは無効になる可能性があります。 Zoom Outlookプラグイン は Windows システムでのみサポートされています。Microsoft API の制限を回避し、Zoom Workplace アプリとの直接連携によりミーティングの同期を強化します。双方向同期のない Windows システムでは推奨されますが、いくつかの制約があります。 * IT 管理の MSI 更新が必要です * ミーティングのスケジュール作成が遅い * macOS またはモバイルのサポートなし ### Zoom Rooms Zoom Rooms のカレンダー連携は、ユーザーのデスクトップまたはモバイルクライアントの連携とは独立して実行されます。 セットアップ後、カレンダーイベントはテレビ画面、スケジュール作成インターフェース、コントロールパネルを含む Zoom Rooms のディスプレイに表示されます。ユーザーはルームコントローラでワンタッチしてミーティングを開始または参加できます。 以下の手順は、セットアッププロセスの大まかな概要です。 1. Microsoft Exchange Online を設定する し、Zoom Rooms メールボックス設定用の PowerShell スクリプトを更新する 2. カレンダーデータへのアクセスを有効にするために Microsoft Graph API の権限を設定する Zoom は、スタンダードな連携方法として、アプリケーションの権限を使用する Microsoft Graph API を推奨しています。この推奨は、Exchange Web Services（EWS）プロトコルを廃止するという Microsoft の計画に沿ったものです。Graph API 方式は、Zoom Rooms と Microsoft 365 カレンダーの間で最も安定した接続を提供します。 {% hint style="info" %} **注** サードパーティのカンファレンスルームシステム（Cisco、Poly、Lifesize など）を使用する組織は、適切なカレンダー機能とミーティング機能を確保するために、Zoom Enhanced API コネクタを通じて追加の手順を完了する必要があります。Zoom Rooms のカレンダーアクセスを設定する方法の詳細については、当社の M365 Calendaring Field Guide ドキュメントを参照してください。 {% endhint %} #### ルームメールボックスへのアクセスを付与するには、どの方法を使用できますか？ Zoom Rooms のカレンダー連携は Microsoft Graph API（MGAPI）に依存しています。Microsoft は開始しました [Exchange Web Services（EWS）方式の段階的廃止を](https://techcommunity.microsoft.com/blog/exchange/retirement-of-exchange-web-services-in-exchange-online/3924440) これらは以前、Microsoft 365 データを Zoomサービス と接続するために利用可能でした。Zoom はこれらの EWS 方式をレガシーオプションと見なしています。 Google ワークスペースには、権限を適用する方法が 1 つしかありません。 #### サービスアカウントにはどの権限が必要ですか？ 具体的な権限は、選択した方法によって異なります。各オプションと必要な権限は、以下の表に詳しく記載されています。 | プロバイダー | 方法 | 必要な権限 | | --------------------------------------- | -------------------------------- | ---------------------- | | Microsoft 365/Microsoft Exchange Server | アプリケーションの権限（Microsoft Graph API） | 管理者アカウント: 組織管理および受信者管理 | | Microsoft 365/Microsoft Exchange Server | フル代理アクセス（Microsoft Graph API） | 代理送信 フルアクセス | | Google ワークスペース | - | 変更を加えて共有を管理する | {% hint style="info" %} **Zoomの推奨事項** Zoom は、カレンダー連携にはアプリケーションの権限の方法を使用することを推奨しています。この設定では、管理者の作業が少なくて済み、専用のサービスアカウントも必要ありません。また、これはバックグラウンドサービスとして実行されるエンタープライズ アプリケーションに対する Microsoft の推奨アプローチでもあります。 {% endhint %} ### Enhanced API コネクタ Enhanced API コネクタ（2021 年初頭にリリース）を介した、標準ベースの H.323 および SIP ルームシステム向けのカレンダー連携は、ユーザークライアントおよび Zoom Rooms の設定とは独立して実行されます。サービスアカウントの方法論と権限は、前述の Zoom Rooms セクションと同一です。 #### Enhanced API コネクタのデータフローは何が異なりますか？ Enhanced API コネクタを通じて接続されたルームシステムは、カレンダープロバイダーに直接連絡しません。これは Zoomクライアント および Zoom Room の接続フローとは異なります。Zoom Web Service はこれらのシステムのクライアントとして機能し、Poly デバイスを除いて、カレンダーデータをエンドポイントに直接プッシュします。Poly デバイスは最初に Zoom Web Service にカレンダー更新を問い合わせ、その後、カレンダーデータがデバイスに送信されます。 #### 何日分のカレンダーイベントが取得されますか？ Enhanced API コネクタは、今後 30 日間の予定されているミーティングデータを取得し、完了したミーティングを 30 日後にストレージから削除します。 --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://library.zoom.com/technical-library/ja/kn/third-party-integrations/zoom-calendaring-integration-explainer/zoom-calendaring-endpoints.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.