対象: 会社の管理者、チームの管理者
プラットフォーム: ブラウザー、デスクトップ
Google Workspace のインテグレーションにより、ユーザーは Miro のボードに Google ドキュメント、Google スプレッドシート、および Google スライド のコンテンツを埋め込むことができます。このガイドでは、インテグレーションの技術的実装、セキュリティーモデル、および評価や設定を行う管理者向けのデータ取り扱いについて説明します。
主な機能
- Live embed: ユーザーは Google の文書、スプレッドシート、またはスライドのコンテンツをライブ埋め込みの iframe として Miro ボードに埋め込めます。
- Secure: 各ボードのビジターは、埋め込まれたコンテンツを閲覧する前に iframe 内でログインを求められます。
- Display options: ユーザーは、埋め込まれたコンテンツをライブ埋め込みまたはブックマークとして表示するかを選べます。
- Focus mode: ユーザーは、ライブ埋め込みまたはブックマークをフォーカスモードで拡大表示し、余計な表示を排して閲覧できます。
- Action shortcut: ユーザーは、Google の文書、スプレッドシート、またはスライドのリンクを埋め込むためのダイアログを開くアクションショートカットを追加できます。
- アセットピッカー: ユーザーは特定のスライドをボードに静的画像として追加できます。これにより、共同作業者は元のファイルへのアクセス権がなくても、その内容を正確に閲覧・参照できます。
- 管理者の設定: 管理者はアセットピッカーを使って Google スライド のコンテンツを静的画像として追加することをユーザーに禁止できます。
制限
- アセットピッカーはGoogle スライドのみに対応しています。Google ドキュメントやGoogle スプレッドシートには対応していません。
技術的実装
Miro は Google の REST API を通じて Google Workspace と連携します。ユーザーは OAuth 2.0 でアクセスを認可し、その後 Google ドキュメント、Google スプレッドシート、Google スライド のファイルを Miro のボードにリンクします。
セキュリティーに関する考慮事項
インテグレーションのアセットピッカーにより、ユーザーは Google スライド ファイルの一部を静的な画像としてキャンバスに追加できます。ライブ埋め込みにアクセスできるのは認可されたユーザーのみですが、ボードにアクセス権のあるユーザーは誰でも添付された静的画像を閲覧できます。公開ボードでは、埋め込みからのアセットの追加は既定で無効化されています。
会社の管理者は、すべてのボードでアセットピッカーを無効化できます:
- 次の順に移動します: 会社設定 > アプリとインテグレーション > アプリ > Google Office Integration App (アプリの管理 タブ内).
- 埋め込みからアセットをキャンバスに追加することをユーザーに禁止する を切り替えます。
データフロー
- この機能が有効になっているチームまたは組織に所属するユーザーが、Google ドキュメント、Google スプレッドシート、または Google スライドのリンクを Miro のボードに貼り付けます。
- Miro はリンクを読み取ります。ユーザーがまだインテグレーションを認可していない場合、Miro は OAuth フローを開始し、ユーザーを Google の認可ページにリダイレクトします。
- ユーザーが認可を与えると、Miro のインテグレーションサービスはユーザーのアクセストークンを使って Google の REST API を呼び出し、コンテンツを取得します。
Miro が保存する Google のデータ
Miro は、貼り付けられた Google Workspace のリンクから以下のデータを取得し、保存します。
- 文書およびファイルのタイトル
- アセットピッカーで作成された画像
データ保持
埋め込まれたデータは、すべての顧客データに適用される Miro の標準データ保持ポリシーに従います。
認証と認可
ボードに Google ドキュメント、Google スプレッドシート、または Google スライドのリンクを埋め込むには、ユーザーが Google の OAuth 同意画面でインテグレーションを承認する必要があります。お客様の Google Workspace の設定によっては、Google Workspace 管理者による承認が必要な場合があります。
必要な認可スコープ
Google Workspace インテグレーションでは、次のスコープが必要です:
https://www.googleapis.com/auth/presentations.readonly https://www.googleapis.com/auth/spreadsheets.readonly https://www.googleapis.com/auth/documents.readonly
Miro に保存されるデータとその保存方法
Miro はこのインテグレーションで、認可データと展開データの 2 種類を保存します。
- 認可データ: Miro はアクセストークンとリフレッシュトークンを数日間データベースに保存します。認可が有効な間、Miro はユーザーの再認可を要求することなく、リフレッシュトークンを使って有効期限切れのアクセストークンを自動的に更新します。このインテグレーションで保存されるすべてのデータは、保存時に 256 ビット AES で暗号化されます.
- 展開データ: Miro は、アセットピッカーで取得された画像(ボードの一部として保存されます)と、タイトルおよび画像参照(内部サービスに暗号化して保存されます)の 2 種類の展開データを保存します.
トークンの取り消し
ユーザーは、Google Identity ガイド に従って、いつでも Google アカウントからインテグレーションへのアクセス権を取り消すことができます。
Google Workspace インテグレーションのセットアップ
注記:Miro のチームの管理者のみがアプリをインストールできます。Miro の組織で承認済みアプリのみを許可している場合、一般ユーザーが Google Workspace のリンクを貼り付けると、そのユーザーには代わりにアプリのインストール要求ダイアログが表示されます。
インテグレーションをインストールして使用を開始するには、次の手順を行います。
- Google ドキュメント、Google スプレッドシート、または Google スライドのファイルの URL をコピーします。
- URL を Miro ボードに貼り付けます。
-
次に何が起こるかは、誰がリンクを貼り付けたかによって異なります。
- チームの管理者がリンクを貼り付けた場合: アプリは自動的に認可およびインストールされ、リンクは追加の操作なしに展開されます。
- 一般のユーザーがリンクを貼り付け、組織が承認済みアプリのみを許可している場合: アプリのインストール要求ダイアログが表示されます。ユーザーが権限を要求すると、会社の管理者はアプリリクエスト フローの記事に従ってリクエストを承認できます。
Google アカウントを接続する
インテグレーションがインストールされ、認可された後:
- ボードに URL を貼り付けると作成されるウィジェットで、接続をクリックします。Google のページにリダイレクトされ、Miro にアカウントへのアクセスを許可するよう求められます。
- Google 側で認可を確認してください。Google のコンテンツが iframe としてボードに追加されます。
よくある質問
どのユーザーが Miro に Google コンテンツを埋め込めますか?
ユーザーと Miro ボードは、次の2つの条件の両方を満たしている必要があります:
- ユーザーが Miro の Google Workspace インテグレーションを承認済みであること。
- ユーザーが埋め込もうとしている Google コンテンツにアクセスできること。
埋め込まれた Google コンテンツを閲覧できるのはどのユーザーですか?
埋め込みコンテンツの所有者から許可があり、かつ Miro のボードにアクセスできるユーザーであれば誰でも閲覧できます。つまり、ボードに対して閲覧、コメント、または編集権限を持つユーザーが該当します。閲覧者はインテグレーションを承認したり、Google のライセンスを保有したりしている必要はなく、ボード上の埋め込みコンテンツを閲覧できます。
他のボードにリンクを貼り付けるために、ユーザーは再認可が必要ですか?
いいえ。認可が有効な限り再認可は不要です(Miro では認可が付与されてから 1 か月間、有効と見なします)。ユーザーは任意のボードに Google Workspace のリンクを貼り付けることができ、コンテンツは通常どおりインポートされます。
ボードがこのインテグレーションが有効でない別のチームや組織に属している場合、ユーザーはそこでインテグレーションを使用できません。
Miro を通じて、Google 上で直接アクセスできない Google コンテンツにアクセスできますか?
いいえ。埋め込みできるのは、すでにアクセス権を持っている Google コンテンツのみです — インテグレーションを使って、Google 上で開けないコンテンツを閲覧することはできません。ただし、アクセス権を持つ誰かがそのコンテンツを、あなたと共有しているボードに静的な画像として既に埋め込んでいる場合、その元ファイルに直接アクセスできなくてもそのスナップショットを閲覧できます。インテグレーションはこれ以外に追加のアクセス制御を行いません。共同作業の制限は Miro ボードの共有設定で行ってください。静的な画像のスナップショットでは、基になるデータの確認、元ファイルの開封、フィルターの変更はできない点にご注意ください。
Miro Data Processing Addendum はどこで確認できますか?
Miro Data Processing Addendum を参照してください。
公開の Miro ボードで何が禁止されていますか?
セキュリティー上の理由から、公開ボードでは以下を無効化しています:
- アセットの抽出 — Looker、Google スライド、Figma、Power BI、Microsoft Word、Microsoft Excel、Microsoft PowerPoint のインテグレーションでサポートされています。
- 直接アセットの展開表示 (ライブ埋め込みではなくアセットとして表示) — Figma のインテグレーションでサポートされています。
ソースファイルにアクセスできる人と同じメンバーだけがボードにアクセスできるように制限するにはどうすればよいですか?
このインテグレーションはファイルへのアクセスをソースシステム(Google)側でのみ管理し、Miro 側では管理しません。デフォルトではこれは強制されていません — このセキュリティーレベルを維持するには、Miro の組織管理者がアプリの管理者設定でアセットピッカーを無効化する必要があります。
アセットピッカーを無効化すると、Google のコンテンツが Miro ボード上に静的な画像として保存されるのを防げます。ボードが公開されたり、Google 側でのアクセス権を持たない人と共有された場合など、そのコンテンツをソースでのアクセス権を持たない人に見られてしまう可能性があるためです。