メディア同期 CLI コマンド

同期が SharePoint または OneDrive for work のフォルダーを読み取れるように、ご自身の Microsoft Entra アプリ、またはプロジェクトの Microsoft 接続を追加します。

media sync account add microsoft365 --name NAME
    (--tenant-id TENANT --client-id ID --secret-file FILE | --connection-id ID)

screenrig media sync account add microsoft365 --name Contoso --tenant-id contoso.onmicrosoft.com --client-id 0b1d2f3a-4c5e-4f60-8a7b-9c0d1e2f3a4b --secret-file secret.txt
screenrig media sync account add microsoft365 --name Contoso --connection-id pcn_01EXAMPLECONNECTION0000

Microsoft Entra 管理センターで、リダイレクト URI のないシングルテナントのアプリを登録し、クライアントシークレットを追加し（シークレット ID ではなく値をコピー）、Microsoft Graph のアプリケーションのアクセス許可 Sites.Selected（その後、各サイトへの読み取りアクセスをアプリに付与）または Files.Read.All を追加して、管理者の同意を付与します。アプリはこのプロジェクトに属します。次に media sync account test を実行します。

Dropbox アカウントを追加し、所有者が Dropbox にサインインした状態で開いて接続するための 1 回限りのリンクを表示します。

media sync account add dropbox --name NAME [--app-key KEY]

screenrig media sync account add dropbox --name "Marketing Dropbox"
screenrig media sync account add dropbox --name "Marketing Dropbox" --app-key YOURAPPKEY

data.authorize_url がリンク、data.authorize_expires_at がその有効期限です。CLI がブラウザーを開くことはありません。リンクは Dropbox アカウントの所有者に送ってください。所有者は読み取り専用のアクセス（files.metadata.read、files.content.read、account_info.read、sharing.read）を許可します。data.state が ready（最初は pending_consent）になるまで media sync account show を実行し、その後 media sync create dropbox を実行します。ご自身の Dropbox アプリでは、これらの権限を有効にし、出力に表示されるリダイレクト URI を登録する必要があります。

Google Drive アカウントを追加してすぐに使える状態にし、フォルダーの共有先となるサービスアカウントのアドレスを表示します。

media sync account add google-drive --name NAME [--key-file FILE]

screenrig media sync account add google-drive --name "Marketing Drive"
screenrig media sync account add google-drive --name "Marketing Drive" --key-file key.json

data.config.service_account_email は各フォルダーを共有するアドレスで、閲覧者で十分です。screenRIG のサービスアカウントを通じる場合、フォルダーが同期されるのは、検証済みメールアドレスを持つこのプロジェクトのメンバーがそれを共有したか、所有している場合だけです（そうでない場合は media_sync_sharer_not_member）。ご自身のキーを使う場合は、サービスアカウントと共有されたフォルダーはすべて同期されます。

このプロジェクトのメディア同期アカウントを、種類、状態、直近のテストとともに一覧表示します；シークレットは返されません。

media sync account list

パラメーターなし。

screenrig media sync account list

アカウントを確認します。テナントとクライアント ID、状態、マスクされたシークレット、直近のテストを表示します。

media sync account show <id>

screenrig media sync account show msa_01EXAMPLEACCOUNT0000000

Dropbox アカウントには、接続した人と app_key も表示され、Google Drive アカウントには service_account_email が表示されます。

アカウントの名前を変更するか、Microsoft アプリのテナント、アプリケーション ID、クライアントシークレットを変更するか、Google Drive アカウント独自のキーを置き換えます。

media sync account update <id> [--name NAME] [--tenant-id TENANT] [--client-id ID]
    [--secret-file FILE | --key-file FILE] [--expect-rev REVISION]

screenrig media sync account update msa_01EXAMPLEACCOUNT0000000 --secret-file new-secret.txt
screenrig media sync account update msa_01EXAMPLEACCOUNT0000000 --name "Contoso tenant" --expect-rev 2

少なくとも 1 つの変更が必要です。認証情報を変更すると last_test が消去されるので、アカウントをもう一度テストしてください。Entra のクライアントシークレットには有効期限があるため、期限が切れる前にここで置き換えてください。

Dropbox アカウントを接続または再接続するための、新しい 1 回限りのリンクを作成します。

media sync account connect <id>

screenrig media sync account connect msa_01EXAMPLEACCOUNT0000000

data.authorize_url と data.authorize_expires_at にリンクが含まれ、前のリンクは置き換えられます。Dropbox アカウントの所有者に送ってください。その人が完了しなかった場合や、アカウントが reconnect_required（Dropbox が接続を認めなくなった状態）の場合に使います。接続済みのアカウントは、新しい同意が完了するまで接続されたままで、別の Dropbox アカウントがサインインすると、その接続を引き継ぎます。

アカウントを確認します: Microsoft アプリのサインインと Graph のアクセス許可、または Dropbox や Google Drive アカウントの接続かキー。

media sync account test <id>

screenrig media sync account test msa_01EXAMPLEACCOUNT0000000

応答は last_test として保存されます。Microsoft アプリでは、credentials（Microsoft がトークンを発行したこと。拒否された場合は、値ではなく ID を指定したシークレットの AADSTS7000215 など、AADSTS コードが含まれます）と permissions（トークンが持つ Graph のアプリケーションのアクセス許可）を報告します。Sites.Selected だけの場合は警告になります: 各サイトには引き続き付与が必要で、共有リンクには Files.Read.All が必要です。このテストは、サイトへの付与やフォルダーは判定しません: 指定したフォルダーを読み取るのは media sync create です。失敗したチェックは、終了コード 0 で data.ok が false になります。

どの同期も使っていないアカウントを削除します。

media sync account delete <id> [--expect-rev REVISION]

screenrig media sync account delete msa_01EXAMPLEACCOUNT0000000

同期がアカウントを使っている間は、それらを示して resource_conflict（終了コード 5）が返ります；先にそれらを削除してください。

SharePoint または OneDrive for work のフォルダーをメディアフォルダーに同期します。

media sync create sharepoint --account-id ID --url URL [--folder-id ID] [--every DURATION] [--name NAME]

screenrig media sync create sharepoint --account-id msa_01EXAMPLEACCOUNT0000000 --url https://contoso.sharepoint.com/sites/Marketing/Shared%20Documents/Lobby%20Signs
screenrig media sync create sharepoint --account-id msa_01EXAMPLEACCOUNT0000000 --url "https://contoso.sharepoint.com/:f:/s/Marketing/EabcDEF" --folder-id mfd_01EXAMPLEFOLDER000000000 --every 1h --name "Lobby signs"

Microsoft が拒否したフォルダーは media_sync_source_refused（終了コード 5）になり、付与すべき権限が示されます；何も保存されません。

Dropbox のフォルダーをメディアフォルダーに同期します。

media sync create dropbox --account-id ID --url URL|PATH [--folder-id ID] [--every DURATION] [--name NAME]

screenrig media sync create dropbox --account-id msa_01EXAMPLEACCOUNT0000000 --url https://www.dropbox.com/home/Marketing/Lobby%20Signs
screenrig media sync create dropbox --account-id msa_01EXAMPLEACCOUNT0000000 --url /Marketing/Lobby --folder-id mfd_01EXAMPLEFOLDER000000000 --every 1h --name "Lobby signs"

実行のたびに、Dropbox が保存したフォルダー内の位置から続けて、変更された分だけを読み取ります。アカウントが開けないフォルダーは media_sync_source_refused、Dropbox が認めなくなった接続は dropbox_reconnect_required（media sync account connect）になり、どちらも終了コード 5 で、何も保存されません。

アカウントのサービスアカウントと共有された Google Drive のフォルダーをメディアフォルダーに同期します。

media sync create google-drive --account-id ID --url URL|ID [--folder-id ID] [--every DURATION] [--name NAME]

screenrig media sync create google-drive --account-id msa_01EXAMPLEACCOUNT0000000 --url https://drive.google.com/drive/folders/1AbCdEfGhIjKlMnOpQrStUvWxYz --folder-id mfd_01EXAMPLEFOLDER000000000 --every 1h
screenrig media sync create google-drive --account-id msa_01EXAMPLEACCOUNT0000000 --url 1AbCdEfGhIjKlMnOpQrStUvWxYz

screenRIG のサービスアカウントを通じる場合、フォルダーが同期されるのは、検証済みメールアドレスを持つこのプロジェクトのメンバーがそれを共有したか、所有している場合だけです（media_sync_sharer_not_member、終了コード 3、何も保存されません）。実行のたびにこれが再確認され、そのような共有者を失ったフォルダーは、メディアを保持したまま同期を状態 error で停止させます；メンバーの Google アカウントからもう一度共有してから、media sync update ID --resume を実行してください。Google ドキュメント、スプレッドシート、スライドのファイルは unsupported_type としてスキップされます。アドレスが開けないフォルダーは media_sync_source_refused（終了コード 5）になります；サービスアカウントと共有してください。

このプロジェクトのメディア同期を、メディアフォルダー、頻度、状態、直近の実行のステータスとともに一覧表示します。

media sync list

パラメーターなし。

screenrig media sync list

同期とその直近の実行の概要を確認します。

media sync show <id>

screenrig media sync show msy_01EXAMPLESYNC000000000

data.last_run には、status（ok、partial、error のいずれか）、added、updated、removed、pending_delete（スクリーンがまだ保持している削除済みファイルで、Removed フォルダーで待機中）、skipped_total、そしてスキップされた最初の 20 ファイルを各ファイルの理由（unsupported_type, too_large, storage, subfolder, download_failed, unreadable, in_use）とともに示す skipped が含まれます。失敗した実行には、修正方法を示す code と detail を伴う error が含まれます。data.source には、Dropbox では path、Google Drive では shared_by が加わります。

状態が error の同期は修復が必要です。メディアフォルダーが削除された場合は、media sync update --folder-id で別のフォルダーを指定します。ソースフォルダーが削除または移動された場合は、同期を削除して新しく作成します。screenRIG のサービスアカウント経由の Google Drive では、フォルダーが検証済みの共有者を失った場合（sharer_not_member）、プロジェクトメンバーの Google アカウントからもう一度共有してから、media sync update ID --resume を実行します。Dropbox が接続を認めなくなると（media sync account connect）、Dropbox の実行は reconnect_required で失敗します。

同期の名前、頻度、メディアフォルダーを変更するか、一時停止と再開を行います。

media sync update <id> [--name NAME] [--every DURATION] [--folder-id ID]
    [--pause | --resume] [--expect-rev REVISION]

screenrig media sync update msy_01EXAMPLESYNC000000000 --every 1h
screenrig media sync update msy_01EXAMPLESYNC000000000 --pause
screenrig media sync update msy_01EXAMPLESYNC000000000 --folder-id mfd_01EXAMPLEFOLDER000000000 --expect-rev 3

変更を少なくとも 1 つ指定してください。

次の予定時刻を待たず、同期を今すぐ実行します。

media sync run <id>

screenrig media sync run msy_01EXAMPLESYNC000000000

同期は約 30 秒以内に実行され、その後 media sync show に直近の実行が表示されます。一時停止中の同期は、先に再開する必要があります。

同期を停止します；メディアとフォルダーは残ります。

media sync delete <id> [--expect-rev REVISION]

screenrig media sync delete msy_01EXAMPLESYNC000000000

同期は、どのソースファイルがどのメディアになったかを忘れます。インポート済みのメディアとメディアフォルダーは残り、何も削除されません。