Drive 共有リンクの API および MCP ガイド

共有リンクを使うと、大きなメール添付ファイルを送信せずに、TrekMail アカウントの外部へ Drive ファイルを届けられます。API と MCP ツールでは、リンクの作成、ファイルに対するリンクの一覧表示、アクセスを終了する際のリンクの取り消しが可能です。

クライアントへの成果物、請求書、動画ファイル、エクスポートパッケージのほか、メール添付には大きすぎる、または一時的すぎるファイルに共有リンクを使用してください。

必要なスコープ

アカウント Drive のファイルには drive:account:share を使用します。メールボックス Drive のファイルには drive:mailbox:share を使用します。ほとんどのワークフローでは共有前にファイルを探す必要があるため、読み取りスコープも役立ちます。

共有スコープでは、アップロード、名前変更、移動、ゴミ箱への移動、復元、完全削除は許可されません。エージェントの仕事がファイルの受け渡しだけである場合は、ほかの権限と分けてください。

REST でリンクを作成する

curl -s -X POST "https://trekmail.net/api/v1/drive/files/{FILE_ID}/share-links" \
  -H "Authorization: Bearer tm_live_your_token" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: share-{FILE_ID}-client-a" \
  -d '{"expires_at":"2026-06-01T00:00:00Z","max_downloads":25}'

レスポンスには公開 URL が含まれます。未加工の共有トークンは作成時にだけ返されます。失った場合はリンクを取り消して、新しいリンクを作成してください。

MCP でリンクを作成する

drive_share_create(file_id=123, expires_at="2026-06-01T00:00:00Z", max_downloads=25)

最終回答で URL を返し、有効期限とダウンロード上限も記載するようエージェントに依頼してください。

リンクの一覧表示と取り消し

ファイルの有効なリンクと過去のリンクを確認するには、一覧表示 endpoint または drive_share_list を使用します。リンクを別の人に誤送信した場合、契約が無効になった場合、一時的な配信期間が終了した場合は、リンクを取り消してください。

drive_share_revoke(link_id=456)

取り消しは直ちに適用されます。アクセスを復元する必要がある場合は、新しいリンクを作成してください。

推奨される初期値

無制限のリンクは便利ですが、後から状況を判断しにくくなります。有効期限を設定しない場合は、その理由を説明するメモを自社のシステムに追加してください。

セキュリティ動作

共有リンクは URL を知っているすべての人に公開されます。TrekMail へのログインではなく、推測できないトークンによって保護されます。組織がこのモデルを受け入れている場合を除き、特定の受信者だけにアクセスを許可する必要があるファイルに公開リンクを送信しないでください。

ダウンロードページは、不要なアカウント情報を公開しません。期限切れ、取り消し済み、または上限に達したリンクは、非公開のファイル情報を公開せずに失敗します。

監査証跡

共有リンクの作成と取り消しは、API トークンの識別情報とともに監査記録に残ります。エージェントが顧客向けのリンクを作成する場合は、監査ログを定期的に確認し、チームの担当が変わったときにトークンをローテーションしてください。