レポート
reports show KIND はレポート（fleet_health、uptime、publishing、alerts、alert_log、proof_of_play）を作成し、--format csv、xlsx、pdf と --output FILE を付けるとファイルに書き出します。reports subscriptions はスケジュールに従ってレポートをプロジェクトのメンバーにメールで送り、project export DIR は各セクションの結果とともにプロジェクトのデータを書き出します。 レポートとエクスポートにあります。
reports list#
レポートの種類と、それぞれが受け付けるフィルターを一覧表示します。
reports listパラメーターなし。
screenrig reports listdata.items を返します。各項目にはレポートの kind、title、description と、受け付けるフィルター（params）があり、あわせてファイルの formats も返します。
reports show#
レポートを行として作成するか、CSV、XLSX、PDF ファイルに書き出します。
reports show <kind> [--from YYYY-MM-DD] [--to YYYY-MM-DD] [--group-by folder|screen|tag]
[--folder-id ID [--direct]] [--tag TAG] [--campaign-id ID] [--advertiser NAME]
[--format json|csv|xlsx|pdf] [--output FILE]| パラメーター | タイプ | 必須 | デフォルト | メモ |
|---|---|---|---|---|
<kind> | string | はい | なし | fleet_health、uptime、publishing、alerts、alert_log、proof_of_play のいずれか。 |
--from | string | いいえ | --toの29日前 | 最初の UTC 日（含む）。YYYY-MM-DD の形式。 |
--to | string | いいえ | 今日 | 最後の UTC 日（含む）。--from から最大 366 日後まで。 |
--group-by | string | いいえ | folder | 行が表すもの: folder、screen、tag のいずれか。 |
--folder-id | string | いいえ | なし | この画面フォルダーとその中のすべてだけ。 |
--direct | boolean | いいえ | オフ | --folder-id と併用: フォルダー直下のスクリーンのみ（--group-by screen）、またはそのフォルダーと子フォルダー。 |
--tag | string | いいえ | なし | このタグを持つ画面だけ。 |
--campaign-id | string | いいえ | なし | proof_of_play: 1 つの直接キャンペーン。 |
--advertiser | string | いいえ | なし | proof_of_play: この広告主またはスポンサーのキャンペーン。名前は完全一致で、大文字小文字は区別しません。 |
--format | string | いいえ | json | json、csv、xlsx、pdf のいずれか。 |
--output | パス | いいえ | ./KIND.FORMAT | --format csv、xlsx、pdf を指定したときに書き出すファイル。既定ではレポートの種類をハイフン区切りで表した名前になり（例: ./fleet-health.pdf）、--to を指定した場合はその日付が加わります（例: ./fleet-health-2026-10-28.pdf）。 |
screenrig reports show fleet_health --group-by screen --from 2026-10-01 --to 2026-10-28
screenrig reports show proof_of_play --advertiser "Acme Corp" --format pdf --output acme-proof-of-play.pdfJSON は data.columns、data.rows、data.totals、data.notes を返します。フォルダーレポートの行には階層表示用の id、parent_id、depth があり、最初の行はプロジェクト全体です。ファイルの場合は、そのパス、バイト数、SHA-256 を返します。ページ分割されたレポートは、最大 50000 行まで全体が書き出されます（超える場合は data.truncated）。proof_of_play には、自分のスクリーンで広告時間を販売するプロジェクトが必要です。reports 機能を持つ読み取り専用アクセスで足ります。
reports subscriptions#
スケジュールに従って、レポートをプロジェクトのメンバーにメールで送ります。
reports subscriptions list
reports subscriptions show <id>
reports subscriptions create --name NAME --kind KIND --format pdf|xlsx|csv
--recipients MEMBERS --cadence daily|weekly|monthly [--weekday DAY]
[--day-of-month N] [--hour N] [--timezone ZONE] [--filter NAME=VALUE]
reports subscriptions update <id> [--name NAME] [--format pdf|xlsx|csv]
[--recipients MEMBERS] [--filter NAME=VALUE] [--cadence daily|weekly|monthly]
[--weekday DAY] [--day-of-month N] [--hour N] [--timezone ZONE]
[--pause | --resume] [--expect-rev REVISION]
reports subscriptions delete <id>
reports subscriptions send <id>| パラメーター | タイプ | 必須 | デフォルト | メモ |
|---|---|---|---|---|
<id> | string | はい | なし | 購読の rsub_ ID。reports subscriptions list で確認できます。 |
--name | string | 作成時 | なし | 最大100文字。 |
--kind | string | 作成時 | なし | reports show の種類: fleet_health、uptime、publishing、alerts、alert_log、proof_of_play のいずれか。変更できません。 |
--format | string | 作成時 | なし | 添付ファイル形式: pdf、xlsx、csv のいずれか。 |
--recipients | string | 作成時 | なし | プロジェクトのメンバーを最大 25 人、カンマ区切りで指定します。ユーザー ID、メンバーのメールアドレス、または owner です。update は受信者を置き換えます。 |
--filter | string | いいえ | なし | NAME=VALUE 形式のレポートフィルター（group_by=screen、folder_id=sfd_ID、tag=Lobby、advertiser=Acme など）。繰り返し指定できます。update はフィルターを置き換えます。 |
--cadence | string | 作成時 | なし | daily、weekly、または monthly。 |
--weekday | string | いいえ | monday | 毎週の実行: monday から sunday まで。 |
--day-of-month | integer | いいえ | 1 | 毎月の実行: 日（1〜28）。 |
--hour | integer | いいえ | 0 | タイムゾーンでの時刻（0〜23）。 |
--timezone | string | いいえ | UTC | America/Los_Angeles のような IANA タイムゾーン。 |
--pause | boolean | いいえ | オフ | update のみ: 再開するまで何も送信しません。--resume とは併用できません。 |
--resume | boolean | いいえ | オフ | update のみ: 次回の実行から再び送信します。 |
--expect-rev | integer | いいえ | なし | update のみ: 購読がこのリビジョンでない場合は失敗します。 |
screenrig reports subscriptions create --name "Monday fleet health" --kind fleet_health --cadence weekly --weekday monday --hour 7 --timezone America/Los_Angeles --format pdf --recipients ann@example.com,usr_01EXAMPLEPERSON0000
screenrig reports subscriptions update rsub_01EXAMPLESUB0000000000 --pause各実行は、その直前の期間を UTC 日で対象とします（昨日、その前の 7 日間、または先月）。受信者はプロジェクトのメンバーである必要があり、退出したメンバーには送信されなくなります。update には少なくとも 1 つの変更が必要です。send は、今実行した場合に対象となる期間のレポートを、スケジュールを動かさずに今すぐ送信し、この送信の last_status と last_error を含む購読を返します。失敗した実行は再試行され、last_status failed と last_error として表示されます。8 MiB を超える PDF または XLSX の添付は送信されません。組織はすべてのプロジェクトを合わせて最大 50 件の購読を持てます。読み取りには project 機能と読み取り専用アクセスが、作成・変更・削除・送信には管理アクセスが必要です。
監査ログ
audit list|show|head|verify|export はプロジェクトの監査ログを読み取ります。audit list は操作者、ソース、リソース、アクション、フィールドで設定変更を検索し、audit show は変更された各フィールドの変更前と変更後とともに 1 件のエントリを表示し、audit head はアンカーとして保管するチェーンの先頭を表示し、audit verify はチェーンを再計算し（必要に応じてアンカーと照合し）、検証できない場合は終了コード 13 で終了し、audit export は絞り込んだログを CSV、XLSX、PDF ファイルに書き出します。それぞれの詳細は監査ログをご覧ください。
audit list#
監査エントリを新しい順に一覧表示します。
audit list [--actor ID] [--actor-kind KIND] [--source SOURCE] [--resource-type TYPE]
[--resource-id ID] [--action CODE] [--field POINTER] [--since TIME] [--until TIME]
[--limit N] [--after CURSOR]| パラメーター | タイプ | 必須 | デフォルト | メモ |
|---|---|---|---|---|
--actor | string | いいえ | なし | この人物、エージェント、またはサービスクライアントによる変更のみ（ID で指定）。 |
--actor-kind | string | いいえ | なし | person、agent、service_client、staff、system のいずれか。 |
--source | string | いいえ | なし | 変更が行われた経路: dashboard、api、cli、device、webhook、system のいずれか |
--resource-type | string | いいえ | なし | この種類のリソースへの変更のみ（screen、playlist、webhook、member など）。 |
--resource-id | string | いいえ | なし | このリソースへの変更のみ。 |
--action | string | いいえ | なし | screen.update のようなアクションコード、または playlist.* のように * で終わるプレフィックス。 |
--field | string | いいえ | なし | このメンバーまたはその下位のメンバーに触れた変更のみ。/label のような JSON ポインターで指定します。 |
--since | string | いいえ | なし | この RFC 3339 の日時以降の変更のみ（例: 2026-10-01T00:00:00Z）。 |
--until | string | いいえ | なし | この RFC 3339 の日時より前の変更のみ。 |
--limit | integer | いいえ | 50 | 1 ページあたりのエントリ数（1〜200）。 |
--after | string | いいえ | なし | 前のページのdata.next_cursor |
screenrig audit list --resource-type screen --resource-id scr_01EXAMPLESCREEN00000000
screenrig audit list --action 'playlist.*' --source cli --limit 20data.items を新しい順に返します。各項目には actor（kind、id、name）、source、action、resource（type、id、name）、および changes があり、その各要素が path（リソース内の JSON ポインター）、before、after を持ちます。認証情報は変更前後の両方で (redacted) と表示されます。seq と hash は、エントリがチェーンされた後、数秒以内に現れます。最後のページでは data.next_cursor は null です。project 機能を持つ読み取り専用アクセスで足ります。
audit show#
変更された各フィールドの変更前と変更後とともに、監査エントリを 1 件表示します。
audit show <id>| パラメーター | タイプ | 必須 | デフォルト | メモ |
|---|---|---|---|---|
<id> | string | はい | なし | エントリの aud_ ID。audit list で確認できます。 |
screenrig audit show aud_01EXAMPLEENTRY0000000000エントリを返します。変更された各フィールドの path、before、after、誰がどの経路で変更したか、そしてチェーンされた後はチェーン内の位置が含まれます。
audit head#
アンカーとして保管する監査チェーンの先頭を表示します。
audit headパラメーターなし。
screenrig audit head最後にチェーンされたエントリを SEQ:HASH の形式で、チェーンの開始点となる保持下限、およびチェーンされるのを待っているエントリ数を表示します。先頭を保管しておくと、audit verify --anchor SEQ:HASH で履歴が書き換えられたり切り詰められたりしていないことを後で証明できます。
audit verify#
監査ハッシュチェーンを再計算し、一致しないものをすべて報告します。
audit verify [--from-seq N] [--limit N] [--anchor SEQ:HASH]| パラメーター | タイプ | 必須 | デフォルト | メモ |
|---|---|---|---|---|
--from-seq | integer | いいえ | 保持されている最も古いエントリ | 検証する最初のチェーン位置。 |
--limit | integer | いいえ | 5000 | この呼び出しで検証するエントリ数（最大 5000）。 |
--anchor | string | いいえ | なし | 保管しておいたチェーンの先頭 SEQ:HASH。そこまでの履歴が変更されていないことも証明します。 |
screenrig audit verify --anchor 128:3f2c0b6e9a4d81c7f5e0a2b4c6d8e0f1a3b5c7d9e1f30415263748596a7b8c9ddata.problems に、問題のあるエントリごとに hash_mismatch、prev_mismatch、gap、head_mismatch、anchor_mismatch、floor_mismatch のいずれかを報告します。チェーンが検証できない場合は終了コード 13 で終了し、data.ok は false になります。data.next_seq で、より長いチェーンの続きを検証できます。
audit export#
絞り込んだ監査ログを CSV、XLSX、PDF ファイルに書き出します。
audit export --format csv|xlsx|pdf [--output FILE]
[--actor ID] [--actor-kind KIND] [--source SOURCE] [--resource-type TYPE]
[--resource-id ID] [--action CODE] [--field POINTER] [--since TIME] [--until TIME]| パラメーター | タイプ | 必須 | デフォルト | メモ |
|---|---|---|---|---|
--format | string | はい | なし | csv、xlsx、または pdf。 |
--output | パス | いいえ | ./audit-log.FORMAT | 書き出すファイル。--until を指定すると、既定の名前にその日付が加わります（例: ./audit-log-2026-10-01.csv）。 |
--actor, --actor-kind, --source, --resource-type, --resource-id, --action, --field, --since, --until | string | いいえ | なし | audit list のフィルター。--since がない場合、ファイルは直近 30 日間を対象とします。 |
screenrig audit export --format csv --output audit.csv
screenrig audit export --format pdf --resource-type playlist --output playlist-changes.pdf変更されたフィールドごとに 1 行を古い順に、最大 50000 行まで書き出します（超える場合は data.truncated）。ファイルにはチェーンの先頭と保持下限が含まれ、そのパス、バイト数、SHA-256 を返します。
再生
再生証拠は4種類あります。playback playsはスクリーン上で画像、動画、アプリケーションが表示された開始ごとに1行を、received_atの古い順に読み取ります：レポートや広告主向けの再生証明。playback listは日別合計を、スクリーン、メディア、UTC日ごとに1行で読み取ります。playback totalsはUTC日ごとの再生回数を読み取るか、最も多いスクリーンやメディアをランク付けします。playback completenessは、Playerが番号を付けた再生のうちscreenRIGに届いた数と、再生が欠落した箇所を読み取ります。
すべての再生コマンドは --format json|csv|xlsx|pdf と --output FILE を受け付け、ダッシュボードも同じファイルをエクスポートします。デフォルトの json はコマンドのエンベロープで、--output は拒否されます。それ以外の形式はファイルを書き込みます。playback plays と playback list は独自の CSV をストリーミングし、--output - を指定するとエンベロープの代わりに標準出力へ送られます。それ以外のファイルはすべてサーバー上でレンダリングされ、ファイルパスに保存されます。xlsx または pdf には、playback plays で最大 50,000 行、playback list で最大 200 行が入ります。各コマンドにデフォルトのファイルが定められています。
再生はプランのイベント保持のために少なくとも30日間保持されます。
| 問題コード | 終了 | 意味 |
|---|---|---|
invalid_request | 8 | 31日を超える再生範囲、コマンドの上限を超える日次範囲、または不正なフィルター。CLI は送信前にほとんどを拒否します（終了コード2）。 |
rate_limited | 7 | 組織ごとに1分あたり30回の再生エクスポート予算を使い切りました。retry_after_secondsまでお待ちください。 |
エージェントリクエスト：JSONの各ページは1件のエージェントリクエストなので、--all はページごとに1リクエストします。CSVエクスポートは全期間で1リクエストです。再生のリクエスト（JSONページ、CSV、XLSX、PDF）と playback list のCSVエクスポートは、再生エクスポートの予算も消費します。playback totals と playback completeness はそれぞれ1件のエージェントリクエストで、その予算を消費しません。
playback plays#
再生記録を読み取ります。表示される開始ごとに1行。
playback plays [--from TIME] [--to TIME] [--screen-id ID] [--media-id ID] [--tag TAG] [--cursor CURSOR] [--limit N] [--all]
playback plays --format csv|xlsx|pdf [--output FILE] [--from TIME] [--to TIME] [--screen-id ID] [--media-id ID] [--tag TAG]| パラメーター | タイプ | 必須 | デフォルト | メモ |
|---|---|---|---|---|
--from TIME | string | いいえ | --toの24時間前 | received_at の包括的境界：秒とオフセットを含むRFC 3339の瞬間、now、または 7d、12h、30m のような経過時間。 |
--to TIME | string | いいえ | 今 | 同じ形式での排他的なバインド。範囲は最大31日です。 |
--screen-id ID | string | いいえ | すべてのスクリーン | 1つのscr_スクリーン。 |
--media-id ID | string | いいえ | すべてのオブジェクト | 1つのmed_メディアオブジェクト。 |
--tag TAG | string | いいえ | すべてのスクリーン | 再生受信時にスクリーンが持っていたタグ：1～32 文字の英数字。 |
--cursor CURSOR | string | いいえ | 範囲の開始 | 同じフィルターでの前のページのnext_cursor（pc_…）。 |
--limit N | integer | いいえ | 200 | JSON ページあたりの行数、1～1000。JSON のみ：--format csv は拒否します。 |
--all | boolean | いいえ | オフ | カーソルを範囲の末尾まで移動します。1ページあたり1000行（--limitで別の指定がある場合を除く）で、最大50ページまでです。JSONのみ：--format csvは拒否します。 |
--format FORMAT | string | いいえ | json | json、csv、xlsx、pdf のいずれか。csv は範囲全体をストリーミングし、xlsx と pdf には最初の 50,000 行が入ります。 |
--output FILE | パス | いいえ | ./playback-plays.csv、./plays.xlsx、または./plays.pdf | 書き込むファイル。ファイル形式が必要です。--format csv を指定すると、- はエンベロープの代わりに CSV を標準出力に書き込みます。 |
screenrig playback plays --from 7d --tag Lobby --all
screenrig playback plays --format csv --from 2026-09-01T00:00:00Z --to 2026-10-01T00:00:00Z --output september-plays.csv
screenrig playback plays --format xlsx --from 7d --tag Lobby --output lobby-plays.xlsxCLI は両方の境界を UTC に正規化し、すべてのリクエストで送信します。data.from と data.to はそれをエコーします。最新の 5 秒は安定するまで保留されるため、再生は受信後約 5 秒で表示され、data.to はその有効な終了を報告します。アプリケーションの再生は release_id を持ち、media_id は空です。JSON は data.items で 1 ページを返し、data.next_cursor を含み、data.next.argv は次ページの正確なコマンドです。--all は、ページ上限（playback_plays_truncated）またはエクスポート予算の消費（playback_export_rate_limited）に達すると、拒否に向けてリクエストを消費せずに、data.next と警告とともに早期停止します。
CSV は RFC 4180 準拠で、固定ヘッダー行 screen_id,playlist_id,page_id,primitive_id,media_id,primitive,started_at,received_at,manifest_revision,playlist_revision、時刻は RFC 3339 UTC です。primitive_id と started_at は Player が報告しない限り空です。=、+、-、@、タブ、または復帰で始まるセルには先頭に ' が付き、スプレッドシートで評価されません。CLI は同じディレクトリのプライベート一時ファイルに書き込み、ストリームが正常に終了した後にのみ既存ファイルを置き換えます。--timeout はストリームの無進行制限で、デフォルトは 1 バイトもないまま 60000 ms であり、全体の所要時間の制限ではありません。エンベロープは path、bytes、rows、sha256、content_type、from、to、last_received_at を報告し、CSV はエンベロープに入りません。--output - を指定すると、CSV は標準出力に送られ、エンベロープは出力されません。
ストリームが途中で失敗した場合、コマンドは非ゼロで終了しターゲットファイルを書き込みません。すでに受信した完全な行はFILE.partialに残り（それが存在する場合はFILE.partial-2など）、error.nextは最後のreceived_atから残りの範囲を未使用のFILE-rest.csvにエクスポートします。その瞬間に受信した行は両方に現れるため、結合時に重複を除外してください。--output -を指定すると、不完全なCSVは標準出力に残り、エラーとnextコマンドは標準エラー出力に送られます。
xlsx と pdf はサーバー上でレンダリングされ、同じようにプライベートな一時ファイル経由で保存されます。エンベロープは path、bytes、sha256、content_type、format を報告し、ファイルには範囲の最初の 50,000 行が入ります。
playback list#
このプロジェクトの 1 日ごとの再生合計を新しい日から順に読み取ります。
playback list [--screen-id ID] [--media-id ID] [--day YYYY-MM-DD | --day-from YYYY-MM-DD --day-to YYYY-MM-DD]
[--format json|csv|xlsx|pdf] [--output FILE]| パラメーター | タイプ | 必須 | デフォルト | メモ |
|---|---|---|---|---|
--screen-id ID | string | いいえ | すべてのスクリーン | scr_ で始まる必要があります。 |
--media-id ID | string | いいえ | すべてのオブジェクト | med_ で始まる必要があります。 |
--day YYYY-MM-DD | string | いいえ | すべての日 | UTC の暦日 1 日。--day-from または --day-to とは併用できません。 |
--day-from YYYY-MM-DD | string | いいえ | なし | 両端を含む UTC 日の範囲の最初の日。--day-to と併用する場合、範囲は最大 366 日です。CSV ではデフォルトが --day-to の 30 日前です。--day とは併用できません。 |
--day-to YYYY-MM-DD | string | いいえ | なし | その範囲の最終日。CSV ではデフォルトが今日です。--day とは併用できません。 |
--format FORMAT | string | いいえ | json | json、csv、xlsx、pdf のいずれか。csv は一致するすべての行をストリーミングし、範囲を指定しない場合は今日までの 31 日間が対象です。xlsx と pdf には JSON 一覧と同じ行が入ります。 |
--output FILE | パス | いいえ | ./playback-aggregates.csv、./play-aggregates.xlsx、または./play-aggregates.pdf | 書き込むファイル。ファイル形式が必要です。--format csv を指定すると、- はエンベロープの代わりに CSV を標準出力に書き込みます。 |
screenrig playback list --screen-id scr_01EXAMPLESCREEN00000000 --day 2026-08-14
screenrig playback list --format csv --day-from 2026-09-01 --day-to 2026-09-30
screenrig playback list --format pdf --day-from 2026-09-01 --day-to 2026-09-30 --output september.pdfスクリーン、メディアオブジェクト、UTC日ごとに1行。フィルターは呼び出し元自身の行を選びます。JSONは data.items に最大200行を新しい日から順に返し、日次合計は約10分ごとに更新され、playback plays がより新しい開始を示します。CSVのヘッダー行は screen_id,media_id,filename,primitive,day,play_count,last_page_id,last_manifest_revision,first_started_at,last_started_at です。CSVは再生CSVと同じ形で書かれる1リクエストで、その回答は path、bytes、rows、sha256、content_type を報告します。xlsx または pdf の回答は path、bytes、sha256、content_type、format を報告します。失敗した日次エクスポートは何も残さないので、もう一度実行してください。
playback totals#
UTC日ごとの再生回数を読み取るか、最も忙しいスクリーンやメディアをランク付けします。
playback totals [--by day|screen|media|screen_day] [--day-from YYYY-MM-DD] [--day-to YYYY-MM-DD]
[--screen-id ID | --media-id ID] [--top N] [--format json|csv|xlsx|pdf] [--output FILE]| パラメーター | タイプ | 必須 | デフォルト | メモ |
|---|---|---|---|---|
--by GROUPING | string | いいえ | day | day は UTC 日ごとに1行応答します。screen または media で最も多いものをランク付けします。screen_day はトップスクリーンの日別推移を返します。 |
--day-from YYYY-MM-DD | string | いいえ | --day-toの29日前 | 最初の UTC 日（含む）。 |
--day-to YYYY-MM-DD | string | いいえ | 今日 | 最終UTC日（含む）。 |
--screen-id ID | string | いいえ | すべてのスクリーン | --by dayで、この画面のみをカウントします。--media-idではありません。 |
--media-id ID | string | いいえ | すべてのオブジェクト | --by dayで、このメディアオブジェクトのみをカウントします。--screen-idではありません。 |
--top N | integer | いいえ | 10 | ランキングの行、1から100；--by screen_day 付きは1から10。--by が必要；--by day には適用されません。 |
--format FORMAT | string | いいえ | json | json、csv、xlsx、pdf のいずれか。残りの 3 つは同じ行をファイルに書き込みます。 |
--output FILE | パス | いいえ | ./play-totals.csv、./play-totals.xlsx、または./play-totals.pdf | --format csv、xlsx、pdf で書き込むファイル。ファイルパスのみ：- は拒否されます。 |
screenrig playback totals
screenrig playback totals --day-from 2026-09-01 --day-to 2026-09-30 --screen-id scr_01EXAMPLESCREEN00000000
screenrig playback totals --by screen --top 5
screenrig playback totals --by media --day-from 2026-09-01 --day-to 2026-09-30
screenrig playback totals --by screen_day --top 3
screenrig playback totals --by screen --top 10 --format xlsx --output busiest-screens.xlsxカウントは日次集計から取得し、取り込みから最大約 21 分遅れます。playback plays は新しい開始を示します。day は data.days、screen と media は data.screens と data.media、screen_day は data.screen_days に応答します。日系列は最大 366 日（--screen-id または --media-id で 92 日）、ランキングは最大 92 日です。1 回の読み取りには大きすぎるウィンドウのランキングで、各スライスの上位キーのみを保持した場合、data.truncated は true になります。ファイル形式の場合、サーバーのファイルを --output に書き込み、そのエンベロープは path、bytes、sha256、content_type、format を報告します。
playback completeness#
Player が番号を付けた再生のうち screenRIG に届いた数を UTC 日ごとに、および再生が欠落した欠番を読み取ります。
playback completeness [--day-from YYYY-MM-DD] [--day-to YYYY-MM-DD] [--screen-id ID] [--limit N]
[--format json|csv|xlsx|pdf] [--output FILE]| パラメーター | タイプ | 必須 | デフォルト | メモ |
|---|---|---|---|---|
--day-from YYYY-MM-DD | string | いいえ | --day-toの29日前 | 最初の UTC の日付（この日を含みます）。期間は最大92日です。 |
--day-to YYYY-MM-DD | string | いいえ | 今日 | 最終UTC日（含む）。 |
--screen-id ID | string | いいえ | すべてのスクリーン | このスクリーンのみ。scr_ で始まる必要があります。 |
--limit N | integer | いいえ | 100 | 一覧表示する欠番の数。新しい順、1～500。 |
--format FORMAT | string | いいえ | json | json、csv、xlsx、pdf のいずれか。残りの 3 つは同じ行をファイルに書き込みます。 |
--output FILE | パス | いいえ | ./play-completeness.csv、./play-completeness.xlsx、または./play-completeness.pdf | --format csv、xlsx、pdf で書き込むファイル。ファイルパスのみ：- は拒否されます。 |
screenrig playback completeness
screenrig playback completeness --day-from 2026-09-01 --day-to 2026-09-30
screenrig playback completeness --screen-id scr_01EXAMPLESCREEN00000000 --limit 20
screenrig playback completeness --format pdf --output completeness.pdf各メディアの開始には番号が付くため、スクリーンが再生したのに届かなかった再生（たとえば、24 時間のレポートキューを超えてオフラインで行われた再生）は欠番を残します。data.completeness は、ウィンドウについて data.measured_plays を data.measured_plays と data.missing_plays の合計で割った値で、0 から 1 の範囲です。どちらも計測されなかった場合は null になります。番号のない再生（再生に番号を付けない Player、または番号を付ける前の Player によるもの）は計測されません。data.days は、いずれかがある UTC 日ごとに同じ 3 つの数値を古い順に示し、欠番はその後の再生の日に数えられます。data.gaps は各欠番を新しい順に、screen_id、day、from、to（前後の再生の開始時刻）と missing_plays とともに一覧表示します。--limit が件数を制限し、さらにある場合は data.truncated が true になります。オフになっているスクリーンは再生を行わず、欠番も生じません。集計は 10 分ごとに更新されます。計測対象の API リクエスト 1 件で、再生エクスポート予算は適用されません。ファイル形式の場合、サーバーのファイルを --output に書き込み、そのエンベロープは path、bytes、sha256、content_type、format を報告します。