録画

録画をリスト表示する

GET /api/v1/recordings

認証されたユーザーがアクセスできる録画のページ割りされたリストを返します。

クエリパラメータ

パラメータ	タイプ	デフォルト	説明
`limit`	number	`20`	結果の数 (1–100)
`offset`	number	`0`	ページネーションオフセット
`search`	string	-	タイトルでフィルタリング (部分一致)
`status`	string	-	ステータスでフィルタリング (録画ステータスを参照)
`date_from`	string	-	ISO 8601 形式の日付 - この日付以降に作成された録画のみを返します
`date_to`	string	-	ISO 8601 形式の日付 - この日付以前に作成された録画のみを返します
`organization_id`	string	-	組織にスコープ指定
`folder_id`	string	-	フォルダにスコープ指定 (`organization_id` が必要)

レスポンス

{
  "data": [
    {
      "id": "uuid",
      "status": "COMPLETED",
      "title": "Weekly sync",
      "createdAt": "2025-09-19T15:00:00.000Z",
      "thumbnailUrl": "https://...",
      "progress": 1.0,
      "capabilities": {
        "canDownload": true,
        "canShare": true,
        "canViewTranscription": true,
        "canGenerateSummary": true,
        "canAskQuestions": true
      }
    }
  ],
  "pagination": {
    "total": 42,
    "limit": 20,
    "offset": 0,
    "has_more": true
  }
}

録画を取得する

GET /api/v1/recordings/:id

単一の録画の詳細をすべて返します。

組織の録画は、表示が許可されている組織メンバーであれば誰でも利用できます。所有者と管理者は組織内のすべての録画を開くことができます。編集者と閲覧者は、その役割とフォルダーアクセスが許可する録画を表示します。組織の録画の場合、is_locked、download_url、および capabilities は、呼び出し元の個人のプランではなく、組織のプランとメンバーの機能フラグを反映します。

組織のEnterpriseサブスクリプションがアクティブでなくなった場合、402 ORGANIZATION_SUBSCRIPTION_EXPIRED を返します。

レスポンス

{
  "data": {
    "id": "uuid",
    "status": "COMPLETED",
    "title": "Weekly sync",
    "createdAt": "2025-09-19T15:00:00.000Z",
    "updatedAt": "2025-09-19T15:30:00.000Z",
    "startedAt": "2025-09-19T15:01:00.000Z",
    "endedAt": "2025-09-19T15:30:00.000Z",
    "videoUrl": "https://...",
    "hlsUrl": "https://...",
    "downloadUrl": "https://...",
    "downloadUrlExpiresAt": "2025-09-19T21:00:00.000Z",
    "thumbnailUrl": "https://...",
    "organizationId": "org_uuid or null",
    "transcription": {
      "status": "completed",
      "language": "en",
      "speakers": ["Speaker 1", "Speaker 2"],
      "segmentsCount": 184,
      "duration": 1740.5
    },
    "summary": {
      "status": "completed",
      "content": "## Key topics\n...",
      "topics": [
        {
          "title": "Project timeline",
          "keyPoints": [
            { "point": "Launch date confirmed", "details": ["Set for Q1"] }
          ]
        }
      ]
    },
    "isLocked": false,
    "capabilities": {
      "canDownload": true,
      "canShare": true,
      "canViewTranscription": true,
      "canStartTranscription": true,
      "canRegenerateTranscription": false,
      "canRenameSpeaker": true,
      "canViewSummary": true,
      "canGenerateSummary": true,
      "canAskQuestions": true
    }
  }
}

文字起こしセグメントを取得する

GET /api/v1/recordings/:id/transcript

録画のページ割りされた文字起こしセグメントを返します。

組織の録画は、録画の取得と同じアクセスルールに従います。録画がロックされている場合は 403 RECORDING_LOCKED を、組織またはメンバーに対して文字起こしが無効になっている場合は 403 TRANSCRIPT_NOT_AVAILABLE を返します。まだ文字起こしされていない録画でも、"status": "not_started" と空の segments 配列を含む 200 を返します。

クエリパラメータ

パラメータ	タイプ	デフォルト	説明
`start_chunk`	number	`0`	開始するチャンクインデックス
`limit`	number	`50`	チャンク数 (1–100)

レスポンス

{
  "data": {
    "status": "completed",
    "language": "en",
    "speakers": ["Speaker 1", "Alice"],
    "duration": 1740.5,
    "segments": [
      {
        "id": 1,
        "start": 0.5,
        "end": 3.2,
        "text": "Good morning everyone.",
        "speaker": "Alice",
        "confidence": 0.97
      }
    ],
    "pagination": {
      "total_chunks": 184,
      "has_more": true
    }
  }
}

録画を更新する

PATCH /api/v1/recordings/:id

録画のタイトルまたはメモを更新します。少なくとも1つのフィールドが必要です。

リクエストボディ

{
  "title": "New title (1–500 characters)",
  "notes": "Optional notes (max 100,000 characters)"
}

レスポンス

{
  "data": { "success": true }
}

録画を削除する

DELETE /api/v1/recordings/:id

録画と関連するすべてのデータ (文字起こし、概要、共有) を完全に削除します。

レスポンス

{
  "data": { "success": true }
}

共有リンクを作成する

POST /api/v1/recordings/:id/share-link

録画の公開共有リンクを生成します。

組織の録画の場合、録画を閲覧できるメンバーであれば誰でもリンクを作成できます。リンクは録画所有者の代理で作成され、組織のプランを使用するため、呼び出し元の個人のプランが無料であっても、組織の録画に対して download リンクが機能します。録画がロックされている場合は 403 RECORDING_LOCKED を、組織またはメンバーに対して共有が無効になっている場合は 403 SHARING_DISABLED を返します。

リクエストボディ

{
  "permission": "view"
}

値	説明
`view`	受信者は動画を視聴し、文字起こし/概要にアクセスできます
`download`	受信者は動画ファイルをダウンロードすることもできます

レスポンス

{
  "data": {
    "share_url": "https://recordmeeting.com/app/shared/abc123",
    "share_token": "abc123",
    "permission": "view"
  }
}

録画ステータス

ステータス	説明
`STARTING`	録画リクエストを受信し、設定中
`CONNECTING`	Google Meetセッションに接続中
`WAIT_APPROVAL`	録画承認のため、通話中の承認を待機中
`RECORDING`	録画中
`UPLOADING`	クライアントサイドでのアップロード中 (チャンクがストレージに排出中)
`PROCESSING`	Cloudflare StreamでHLS/DASHをパッケージ化中 - まだ再生できません
`MIGRATING`	ビデオは完全に再生可能。HLSを長期ストレージに移行中
`COMPLETED`	録画が完全に処理され、保存されました
`ERROR`	録画に失敗しました

APIコンシューマーは、再生、ダウンロード、共有操作については MIGRATING を COMPLETED と同じように扱う必要があります。この違いは内部的なものです。