動画チュートリアル：Figmaファイルのコメントをエクスポートする

この動画では、CopyDocプラグインを使って、Figmaファイルのコメントを（参考画像付きで）CSV・JSONファイルにエクスポートする方法を解説しています。

Figmaの個人アクセストークンの生成

CopyDocプラグインでコメントをエクスポートするには、Figmaアカウントで個人アクセストークンを生成する必要があります。

1. Settingsパネルを開きます（Figmaのアカウントアイコンの下にあるドロップダウンメニューから開けます）。
2. 設定のポップアップにあるAccountタブを、Personal access tokensセクションまでスクロールします。
3. Generate new tokenをクリックします。
4. Token nameを設定します（例：CopyDoc Figma Plugin）。
5. Expirationのドロップダウンで90 Daysを選びます。
6. File contentのドロップダウンがRead-onlyになっていることを確認します。
7. CommentsのドロップダウンがWriteになっていることを確認します。
8. ほかのドロップダウンはすべてNo accessのままでかまいません。
9. Generate tokenボタンをクリックします。
10. Copy this tokenをクリックします（コピーできるのはこのときだけです）。

CopyDocプラグインからFigmaコメントをエクスポートする

この機能を使うには、CopyDocプラグインのメイン画面でExport Commentsボタンをクリックし、次の手順に従います。

Figmaの個人トークンの追加

Figmaファイルのコメントを読み取るリクエストを認証するには、上のFigmaの個人アクセストークンの生成セクションの手順に従って、Figmaの個人アクセストークンを手動で追加する必要があります。

エクスポートに成功すると、トークンは自動的に保存されます。 CopyDocでコメントのエクスポートに成功すると、Figmaの個人アクセストークンが自動的に保存され（入力欄にもあらかじめ入力され）、ほかのFigmaプロジェクトでもプラグインで引き続き使えます。

FigmaファイルURLの追加

FigmaのヘッダーにあるShareボタンをクリックし、ポップアップウィンドウでCopy linkをクリックしてから、コピーしたURLをCopyDocプラグインの設定にあるFigma Page URL (Required) 入力欄に貼り付けて、FigmaページのURLを手動で追加する必要があります。

デザイン参考画像オプションの切り替え

Include Design Referencesオプションをオンにすると、コメントが1つ以上あるフレームごとに、.png画像（コメントスレッドごとに番号付きのピンを配置したもの）が含まれます。これらの画像は、.csvファイルと.jsonファイルにエクスポートしたテキストのコメントと並べて、視覚的な参考資料として使えます。

コメントの取得とエクスポート

有効なFigma Page URLとFigma Personal Access Tokenを追加したら、Export Comments to CSV/JSONボタンをクリックします。Figmaファイル内のコメントがスキャンされ、CSVファイルとJSONファイルが生成されます（Include Design Referencesオプションがオンの場合は、参考画像も生成されます）。

CopyDocがコメントのエクスポートを完了すると、確認メッセージが表示されます。Download Commentsボタンをクリックすると、エクスポートしたコメントを含む.zipファイルをダウンロードできます。

Figmaからダウンロードしたファイルの保存 Figmaのデスクトップアプリを使っている場合は、ファイルをダウンロードするためのダイアログが表示されます。一方、WebブラウザでFigmaを使っている場合は、デフォルトでファイルが自動的にパソコンにダウンロードされます（通常はパソコンのDownloadsフォルダに保存されます）。

.zipファイルを開く

Figmaから.zipファイルをパソコンにダウンロードしたら、ファイルエクスプローラーで保存先のフォルダを開きます。エクスポートした.zipファイルをダブルクリックすると中身が展開され、コメントを自由に活用できます。