> For the complete documentation index, see [llms.txt](https://library.zoom.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://library.zoom.com/technical-library/ja/kn/third-party-integrations/zoom-calendaring-integration-explainer/zoom-calendaring-endpoints.md). # Zoomカレンダー機能のエンドポイント ### Webカレンダーサービス Webカレンダーサービスは、すべてのZoomアプリにカレンダー情報を提供するZoomの機能の中核です。 #### Zoomはどのような情報を保存しますか？ Zoom Web Calendaring Service は、各ユーザーのカレンダープロバイダーを認証するために必要なオブジェクトを保存します。これは、組織が 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 の方法で接続中する際、カレンダーと連絡先の両方について、読み取りおよび読み取り/書き込みのアクセス許可のどちらかを選択できます。管理者は、ユーザーのカレンダーに対する Google ワークスペース の統合も制限できます。 ### デスクトップおよびモバイルアプリ #### Zoomアプリはカレンダー情報や連絡先データを保存しますか？ Zoomアプリは、カレンダー情報を一時メモリ（RAM）に保持し、ローカルディスクには何も永続保存しません。これには、認証トークン、認証情報、カレンダーイベント情報、および連絡先データが含まれます。このデータは、クライアントを終了すると利用できなくなります。 #### サインイン時には何が起こりますか？ Zoomアプリは、今後のイベントの一覧を取得するために、サインインのたびに完全な更新を開始します。これには、Zoom WebカレンダーサービスからOAuthアクセストークンまたは保存済みの認証情報を受け取り、そのオブジェクトを使用してカレンダー提供元から直接イベントデータを更新することが含まれます。アクセストークンが無効な場合、Zoom Webカレンダーサービスはリフレッシュトークンを使用して新しいアクセストークンを要求し、それをクライアントに渡します。 #### クライアントは、今後のイベント一覧を更新する必要があることをどのように認識しますか？ カレンダーがWebポータルで接続されると、Zoom Webカレンダーサービスは各ユーザーごとにカレンダー提供元のWebhookを購読します。これらのWebhookは変更をWebカレンダーサービスに通知し、その後、更新が必要であることをZoomクライアントに通知します。最後に、Zoomクライアントはカレンダー提供元に直接更新を要求します。更新通知を受け取らないアプリは、30分ごとにイベント一覧を更新します。 #### クライアントで利用できるミーティングの詳細は何ですか？ Zoomアプリは、解析したイベントをサニタイズした後にミーティングデータを表示します。つまり、使用しない属性はすべて破棄されています。使用のために保存されるイベント属性と、破棄されるイベント属性は、以下の表に示されています。 | クライアントでの表示用に保存 | 破棄され、保持されない | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- | | | | | \*AI Companion 2.0を活用したイベントキャプチャが有効な場合のみ | | #### クライアントログにカレンダー情報は保存されますか？ Zoomアプリは、トークン、認証情報、イベントなどの機密性の高いカレンダーデータをクライアントログに出力しません。 ### スケジュール作成ツール Zoomは、MicrosoftおよびGoogle製品でのZoomミーティングのスケジュール作成体験を簡素化するため、さまざまなツールを提供しています。これらの製品には、Google WorkspaceおよびMicrosoft 365向けのネイティブなスケジュール作成統合、または選択したブラウザやOutlookで使用するソフトウェア拡張機能が含まれます。 #### スケジュール作成ツールはどのように機能しますか？ Outlookプラグインを除くすべてのスケジュール作成ツールは、カレンダー提供元とZoomのWebカレンダーサービスの両方にAPIリクエストを直接送信します。Outlookプラグインはこれと異なり、Zoomデスクトップクライアントを介してミーティングをスケジュールします。このZoomデスクトップクライアントが、プラグインに代わってZoom Webカレンダーサービスに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カレンダーサービスに送信します。 AppleおよびMicrosoftが定めるポリシーとガイドラインを順守しながら、ユーザーに最適な体験を提供するために、ZoomはOutlook向けZoomアドインの展開と活用を強く推奨しています。このアドインは、より簡単な展開と、より堅牢な管理ソリューションを提供し、Microsoftによる積極的なサポートを受けており、Appleのようなベンダーによって最近強化されたセキュリティ要件にもより適合します。 {% hint style="danger" %} **警告** Outlook向けZoomプラグインに対して新しい機能強化は実装されません。Outlook向けZoomアドインへの移行を強くお勧めします。 {% endhint %} Outlookアドインは、ユーザーのマシンへのローカルインストールを必要としないWebベースのアプリケーションであり、代わりに組み込みのWebアプリとして表示され、ローカルクライアントとOutlook on the webの両方で利用できます。アドインは、ZoomのカレンダーWebサービスと直接通信するWeb APIを介して動作します。 プラグインとアドインは同様の機能を提供しますが、アドインを使用するには、Outlook JavaScript API requirement set 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 ディレクトリに、「Zoom-Office-追加-in-SSO」という名前で、アプリケーション ID ce63c970-e2d7-45e6-bee1-80c330b0800b を使用してインストールされます。 #### Outlookプラグインまたはアドインを更新する必要がありますか？ 2025年1月現在、Microsoft は従来の Exchange Online トークンを Nested アプリ認証 (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 カレンダーサービスと通信するためにWeb APIを介して動作する組み込みのWebアプリケーションとして表示されます。このアドインは、WindowsおよびmacOSのOutlookアプリケーション、AndroidおよびiOSのOutlookアプリケーション、ならびにWeb上のOutlookでオンラインで提供されています。このアドインは、Outlook管理者によって構成して一括展開することも、個々のユーザーによってインストールすることもできます。 Outlookプラグインは、インストール済みのソフトウェアとして動作し、随時更新や機能強化の対象となります。そのため、このプラグインには、長期的なバージョン管理とアップグレードが必要です。 {% hint style="info" %} **注** ネストされたアプリ認証はOutlookプラグインには必要ありません。 {% endhint %} #### どのスケジュール作成ツールが自分の環境に最適ですか？ **Google ワークスペース** Google ワークスペースを利用している組織では、Google ワークスペース Marketplace から Zoom for GSuite アプリをインストールすることで、Googleカレンダーを通じてすべてのユーザーが簡単に Zoom Meetings をスケジュール作成できるように有効にすることができます。このアプリは一元管理され、Zoom が Google に機能改善を送信するたびに自動的に更新されます。 また、ブラウザベースの拡張機能もオンラインで利用できますが、通常は個人アカウントのユーザー向けです。ローカルへのインストール、定期的な更新が必要であり、一元管理されていないためです。 **Microsoft** Microsoft 365 またはオンプレミスの Exchange Server を使用している組織では、最適なオプションは環境とカレンダー連携の設定方法の両方によって異なります。 Outlook向けZoom アドインは、Microsoft 365 環境に最適なツールです。Outlook のデスクトップ版、Web版、モバイル版のいずれを使用していても利用できます。このアドインには、Microsoft 365 用 Outlook、Windows 用 Outlook 2013 以降、または Mac 用 Outlook 2016 以降が必要です。 双方向カレンダー同期により、シームレスなカレンダー更新が保証され、カレンダーを連携する際にデフォルトで有効になります。これにより、Zoom は Outlook のカレンダーイベントに加えられた変更（予定時刻の変更やキャンセルなど）を自動的に反映でき、ユーザーがアドインを通じてミーティングを手動で更新または削除する必要がありません。これは、変更が反映されない場合に Zoom ミーティングのリンクが期限切れになる可能性があるため、特に重要です。特に、ミーティングが元の日時から30日以上後に移動された場合はその可能性があります。ミーティング ID は、通常、定期的なシリーズの一部でない限り30日後に期限切れになります。 OnAppointmentSend のようなイベントベースの自動化を支える最新の JavaScript API (v1.8) は、次の環境とアプリケーションではサポートされていません: * オンプレミスの Exchange 環境 * M365 に接続されたクラシック Outlook * iOS と Android のモバイル Outlook その結果、これらの構成では、Zoom はアドインを通じてミーティングを自動的に検出または更新できません。双方向同期や API ベースの自動化がないと、繰り返しミーティングでさえ変更が反映されない場合があり、期限切れまたは無効な Zoom リンクにつながります。 Zoom Outlookプラグインは Windows システムでのみサポートされています。これは、Zoom Workplace アプリとの直接連携によってミーティングの同期を強化し、Microsoft API の制限を回避します。双方向同期のない Windows システムには推奨されますが、次のような大きな制約があります: * IT 管理の MSI 更新が必要 * ミーティングのスケジュール作成が遅い * macOS やモバイルのサポートなし ### Zoom Rooms Zoom Rooms のカレンダー連携は、ユーザーのデスクトップまたはモバイルクライアントの連携とは独立して行われます。 セットアップ後、カレンダーのイベントは、テレビ画面、スケジュール作成インターフェース、コントロール パネルを含む Zoom Rooms のディスプレイに表示されます。ユーザーはルーム コントローラでワンタッチでミーティングを開始または参加できます。 #### セットアップの概要 Zoom Rooms のカレンダー連携には、2 つの異なる設定レイヤーがあります。最初のレイヤーは、選択する認証方法にかかわらず必要です。 **レイヤー 1: Exchange リソースメールボックスの設定（すべての方法に必要）** 認証を設定する前に、管理者は各 Zoom Room の Exchange Online リソースメールボックスを設定する必要があります。これには、Exchange Online でリソースメールボックスを設定し、Exchange Online PowerShell を使用してカレンダー処理ルールを更新することが含まれます。デフォルトで、Exchange Online はいくつかのカレンダー処理プロパティを `True`、これにより Exchange は、件名、主催者情報、コメントなどのミーティングの詳細を、リソースメールボックス上のカレンダーエントリから削除します。Zoom Rooms は、部屋の表示やコントローラーに意味のあるイベント情報を表示するために、これらの詳細を保持する必要があります。管理者は、次のカレンダー処理プロパティを `False` 各 Zoom Room のリソースメールボックスに対して、次の `Set-CalendarProcessing` コマンドレット: * `件名を削除` * `件名に主催者を追加` * `コメントを削除` * `非公開プロパティを削除` この構成は、各リソースメールボックスごとに繰り返す必要があります。検証手順を含む完全な PowerShell 手順については、Zoomサポートの記事を参照してください [Office 365 で Zoom Rooms を設定する](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063474\&DeviceId=70283b61-c13a-475f-ab4d-4a89b1632c1b\&SessionId=1782321876035)このレイヤーは、レイヤー 2 でどの認証方法を選択しても必要です。 **レイヤー 2: 認証方法の選択** リソースメールボックスを構成した後、管理者は Zoom Rooms のカレンダーデータアクセスを有効にするために認証方法を選択します: {% stepper %} {% step %} *アプリケーションのアクセス許可 (Microsoft Graph API)* * **推奨**: この方法では、管理者の同意を伴う Azure アプリ登録を通じて OAuth 2.0 クライアント資格情報フローを使用します。専用のサービス アカウントは不要です。 {% endstep %} {% step %} *フル委任アクセス（Microsoft Graph API）* * この方法では、委任されたメールボックス権限を伴う OAuth 2.0 認可コードフローを使用します。専用のサービス アカウントと、初期セットアップおよび保守により多くの労力が必要です。 {% endstep %} {% endstepper %} Zoom では、Microsoft Graph API のアプリケーション権限をスタンダードな連携方法として推奨しています。この推奨は、Microsoft が Exchange Web Services (EWS) プロトコルを削除する計画と一致しています。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 コネクタ 標準ベースのH.323およびSIPルーム システム向けのカレンダー連携は、Enhanced API コネクタ（2021年初頭にリリース）を通じて、ユーザー クライアントおよびZoom Roomsの構成とは独立して行われます。サービス アカウントの方式と権限は、前述のZoom Roomsのセクションと同じです。 #### Enhanced API コネクタのデータフローで何が異なりますか？ Enhanced API コネクタを通じて接続されたルーム システムは、Zoom clientおよびZoom Roomの接続フローとは異なり、カレンダー プロバイダーに直接接続しません。Zoom Web Serviceはこれらのシステムのクライアントとして機能し、Poly デバイスを除いて、カレンダー データをエンドポイントに直接プッシュします。Poly デバイスはまずカレンダー更新を求めてZoom Web Serviceに照会し、その後、Zoom Web Serviceがカレンダー データをデバイスに送信します。 #### カレンダー イベントは何日分取得されますか？ Enhanced API コネクタは、今後30日間の予定されているミーティング データを取得し、完了したミーティングを30日後に保存領域から削除します。 --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://library.zoom.com/technical-library/ja/kn/third-party-integrations/zoom-calendaring-integration-explainer/zoom-calendaring-endpoints.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.