> 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 カレンダーサービスは、各ユーザーのカレンダープロバイダーを認証するために必要なオブジェクトを保存します。つまり、組織が OAuth を使用して Outlook または Googleカレンダーを Zoomサービスに接続する場合、Zoom はリフレッシュトークンを保存します。また、Exchange On-Premises へのベーシック認証を使用する組織では、Zoom がアカウントのユーザー名とパスワードを保存することも意味します。 | 同期済みイベント | | ----------- | | `出席者省略` | | `説明` | | `表示名` (出席者) | | `メール` (出席者) | | `固定勤務場所` | | `iCalUID` | | `位置情報` | | `表示名` (主催者) | | `メール` (主催者) | | `要約` | | `時間提案` | | `勤務場所有効` | 双方向カレンダー同期が有効な場合、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 Web カレンダーサービス、スケジュール作成ツール、APIコネクタなどのZoomソフトウェア間の通信は、TLS 1.2を使用して転送中に暗号化されています。 #### OAuthトークンはどのくらい有効ですか？ Zoomは、1時間で期限切れになるアクセストークンと90日で期限切れになるリフレッシュトークンを要求しますが、カレンダーサービス提供元は別の制限のトークンを提供する場合があります。デフォルト値を変更する必要がある場合は、提供元の手順に従ってください。 #### OAuthトークンまたは認証情報を取り消せますか？ Zoomの管理者は、いつでも単一のZoomアカウントからカレンダー連携を削除することを選択できます。それにより、そのユーザーのカレンダー機能の動作を阻止します。そのユーザーの保存されたトークンまたは認証情報は直ちに削除してください。 Microsoft 365の管理者は、Entra IDエンタープライズアプリケーションポータルでZoomアプリケーションを削除することで、すべてのユーザーアカウントからZoomのカレンダーアクセスを削除できます。また、Google ワークスペースの管理者は、Google クラウド プラットフォーム コンソールを使用してアクセスを取り消せます。 #### プロバイダーに対するカレンダーまたは連絡先データの書き込み権限を制限できますか？ 初期設定後、Microsoft 365の方法で接続中は、Zoomの管理者はカレンダー機能と連絡先の両方について読み取り権限と読み取り/書き込み権限を選択できます。管理者は、ユーザーカレンダー向けのGoogle ワークスペース連携も制限できます。 ### デスクトップアプリとモバイルアプリ #### Zoomアプリはカレンダーまたは連絡先データを保存しますか？ Zoomアプリはカレンダー情報を一時メモリ（RAM）に保持し、ローカルディスクに項目を永続的に保存しません。これには、認証トークン、認証情報、カレンダーイベント情報、連絡先データが含まれます。このデータは、クライアントが終了すると利用できなくなります。 #### サインイン時には何が起こりますか？ Zoomアプリは、今後のイベントの一覧を収集するため、サインインのたびに完全な更新を開始します。これには、Zoom WebカレンダーサービスからOAuthアクセストークンまたは保存されている認証情報を受け取り、そのオブジェクトを使用してカレンダープロバイダーから直接イベントデータを更新することが含まれます。アクセストークンが無効な場合、Zoom Webカレンダーサービスは更新トークンを使用して新しいアクセストークンを要求し、クライアントに渡します。 #### クライアントは、今後のイベント一覧を更新する必要があることをどのように認識しますか？ Webポータルでカレンダーが接続された後、Zoom Webカレンダーサービスは各ユーザーのカレンダープロバイダーのWebhookを購読します。これらのWebhookは変更をWebカレンダーサービスに通知し、サービスは更新が必要であることをZoomクライアントに通知できます。最後に、Zoomクライアントはカレンダープロバイダーに直接更新を要求します。更新通知を受信しないアプリは、30分ごとにイベント一覧を更新します。 #### クライアントにオンラインで表示されるミーティング詳細は何ですか？ Zoom Apps は、解析したイベントをサニタイズした後にミーティングデータを表示します。つまり、使用しない属性はすべて破棄されています。使用のために保存されたイベント属性と破棄されたイベント属性は、以下の表に示されています。 | クライアントに表示するために保存 | 破棄され、保持されない | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- | | | | | \*AI Companion 2.0 によるイベントキャプチャが有効な場合のみ | | #### クライアントログにカレンダーデータは保存されますか？ Zoom Apps は、トークン、認証情報、イベントなどの機密性の高いカレンダーデータを、いかなるクライアントログにも出力しません。 ### スケジュール作成ツール Zoomは、MicrosoftおよびGoogle製品を使ったZoomミーティングのスケジュール作成体験を簡単にするためのさまざまなツールを提供しています。これらの製品には、GoogleワークスペースとMicrosoft 365向けのネイティブなスケジュール作成連携や、選択したブラウザーとOutlookで使用するためのソフトウェア拡張機能が含まれます。 #### スケジュール作成ツールはどのように機能しますか？ Outlookプラグインを除くすべてのスケジュール作成ツールは、カレンダー提供元とZoomのWebカレンダーサービスの両方に直接APIリクエストを送信します。Outlookプラグインは、ミーティングを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 要件セット 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) アプリケーション ID ce63c970-e2d7-45e6-bee1-80c330b0800b を持つ「Zoom-Office-追加-in-SSO」という名前で、Entra ID エンタープライズ Apps ディレクトリにインストールされます。 #### 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 Calendaring Serviceと通信するためにWeb APIを介して動作する組み込みのWebアプリケーションとして表示されます。このアドインは、WindowsおよびmacOS版Outlookアプリ、AndroidおよびiOS版Outlookアプリ、ならびにWeb版Outlookでオンラインで利用できます。このアドインは、Outlook管理者によって設定および一括展開されるか、個々のユーザーがインストールできます。 Outlookプラグインは、インストールされたソフトウェアとして動作し、時折の更新や機能拡張の対象となります。そのため、このプラグインは、時間の経過とともにバージョン管理とアップグレードが必要になります。 {% hint style="info" %} **注** Outlookプラグインにはネストされたアプリの認証は必要ありません。 {% endhint %} #### どのスケジュール作成ツールが自分の環境に最も適していますか？ **Google ワークスペース** Google ワークスペースを使用している組織では、Google ワークスペース MarketplaceからOutlook向けZoom GSuiteアプリをインストールすることで、すべてのユーザーがGoogleカレンダーを通じてZoom Meetingsを簡単にスケジュールできるようになります。このアプリは一元管理され、ZoomがGoogleに機能強化を提出すると自動的に更新されます。 また、ブラウザベースの拡張機能も利用できますが、ローカルへのインストール、定期的な更新が必要で、一元管理されないため、一般的に個人アカウントのユーザーに適しています。 **Microsoft** Microsoft 365またはオンプレミスのExchange Serverを使用している組織では、最適なオプションは環境とカレンダー連携の構成方法の両方によって異なります。 Outlook向けZoomアドインは、デスクトップ、Web、モバイル版のOutlookのいずれを使用している場合でも、Microsoft 365環境に推奨されるツールです。このアドインには、Microsoft 365向けOutlook、Windows用Outlook 2013以降、またはMac用Outlook 2016以降が必要です。 双方向カレンダー同期によりシームレスなカレンダー更新が実現し、カレンダーを連携する際にデフォルトで有効になります。これにより、ユーザーがアドインを介してミーティングを手動で更新または削除しなくても、再スケジュールされた日時やキャンセルなど、Outlookのカレンダーイベントに加えられた変更がZoomに自動的に反映されます。これは、特にミーティングが元の日付から30日を超えて移動された場合、変更が取り込まれないとZoomのミーティングリンクが期限切れになる可能性があるため、特に重要です。ミーティング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` コマンドレットを使用します： * `DeleteSubject` * `AddOrganizerToSubject` * `DeleteComments` * `RemovePrivateProperty` この構成は、リソースメールボックスごとに繰り返す必要があります。検証手順を含む完全な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 Connectorを通じて追加の手順を完了する必要があります。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 %} ### 拡張APIコネクタ 標準ベースの H.323 および SIP ルーム システム向けのカレンダー連携は、拡張APIコネクタ（2021年初頭にリリース）を通じて、ユーザー クライアントおよび Zoom Rooms の構成とは独立して実行されます。サービス アカウントの手法と権限は、前述の Zoom Rooms のセクションと同一です。 #### 拡張APIコネクタのデータ フローの何が異なりますか？ 拡張APIコネクタを介して接続されたルーム システムは、カレンダー提供元に直接接続しません。これは、Zoomクライアントおよび Zoom Rooms の接続フローとは異なります。Zoom Web Service はこれらのシステムのクライアントとして機能し、Poly デバイスを除き、カレンダー データをエンドポイントへ直接プッシュします。Poly デバイスはまず Zoom Web Service にカレンダー更新を問い合わせ、その後、Zoom Web Service がカレンダー データをデバイスに送信します。 #### カレンダーイベントは何日分取得されますか？ 拡張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.